WP_REST_URL_Details_Controller::get_item_schema(): array

In this article

Retrieves the item’s schema, conforming to JSON Schema.

Return

array Item schema data.

Source

public function get_item_schema() {
	if ( $this->schema ) {
		return $this->add_additional_fields_schema( $this->schema );
	}

	$this->schema = array(
		'$schema'    => 'http://json-schema.org/draft-04/schema#',
		'title'      => 'url-details',
		'type'       => 'object',
		'properties' => array(
			'title'       => array(
				'description' => sprintf(
					/* translators: %s: HTML title tag. */
					__( 'The contents of the %s element from the URL.' ),
					'<title>'
				),
				'type'        => 'string',
				'context'     => array( 'view', 'edit', 'embed' ),
				'readonly'    => true,
			),
			'icon'        => array(
				'description' => sprintf(
					/* translators: %s: HTML link tag. */
					__( 'The favicon image link of the %s element from the URL.' ),
					'<link rel="icon">'
				),
				'type'        => 'string',
				'format'      => 'uri',
				'context'     => array( 'view', 'edit', 'embed' ),
				'readonly'    => true,
			),
			'description' => array(
				'description' => sprintf(
					/* translators: %s: HTML meta tag. */
					__( 'The content of the %s element from the URL.' ),
					'<meta name="description">'
				),
				'type'        => 'string',
				'context'     => array( 'view', 'edit', 'embed' ),
				'readonly'    => true,
			),
			'image'       => array(
				'description' => sprintf(
					/* translators: 1: HTML meta tag, 2: HTML meta tag. */
					__( 'The Open Graph image link of the %1$s or %2$s element from the URL.' ),
					'<meta property="og:image">',
					'<meta property="og:image:url">'
				),
				'type'        => 'string',
				'format'      => 'uri',
				'context'     => array( 'view', 'edit', 'embed' ),
				'readonly'    => true,
			),
		),
	);

	return $this->add_additional_fields_schema( $this->schema );
}

Changelog

VersionDescription
5.9.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.