WP_REST_URL_Details_Controller

18class WP_REST_URL_Details_Controller extends WP_REST_Controller {19 20	/**21	 * Constructs the controller.22	 *23	 * @since 5.9.024	 */25	public function __construct() {26		$this->namespace = 'wp-block-editor/v1';27		$this->rest_base = 'url-details';28	}29 30	/**31	 * Registers the necessary REST API routes.32	 *33	 * @since 5.9.034	 */35	public function register_routes() {36		register_rest_route(37			$this->namespace,38			'/' . $this->rest_base,39			array(40				array(41					'methods'             => WP_REST_Server::READABLE,42					'callback'            => array( $this, 'parse_url_details' ),43					'args'                => array(44						'url' => array(45							'required'          => true,46							'description'       => __( 'The URL to process.' ),47							'validate_callback' => 'wp_http_validate_url',48							'sanitize_callback' => 'sanitize_url',49							'type'              => 'string',50							'format'            => 'uri',51						),52					),53					'permission_callback' => array( $this, 'permissions_check' ),54					'schema'              => array( $this, 'get_public_item_schema' ),55				),56			)57		);58	}59 60	/**61	 * Retrieves the item's schema, conforming to JSON Schema.62	 *63	 * @since 5.9.064	 *65	 * @return array Item schema data.66	 */67	public function get_item_schema() {68		if ( $this->schema ) {69			return $this->add_additional_fields_schema( $this->schema );70		}71 72		$this->schema = array(73			'$schema'    => 'http://json-schema.org/draft-04/schema#',74			'title'      => 'url-details',75			'type'       => 'object',76			'properties' => array(77				'title'       => array(78					'description' => sprintf(79						/* translators: %s: HTML title tag. */80						__( 'The contents of the %s element from the URL.' ),81						'<title>'82					),83					'type'        => 'string',84					'context'     => array( 'view', 'edit', 'embed' ),85					'readonly'    => true,86				),87				'icon'        => array(88					'description' => sprintf(89						/* translators: %s: HTML link tag. */90						__( 'The favicon image link of the %s element from the URL.' ),91						'<link rel="icon">'92					),93					'type'        => 'string',94					'format'      => 'uri',95					'context'     => array( 'view', 'edit', 'embed' ),96					'readonly'    => true,97				),