W3cubDocs

/WordPress

WP_oEmbed_Controller::get_item( WP_REST_Request $request )

Callback for the embed API endpoint.

Description

Returns the JSON object for the post.

Parameters

$request

(WP_REST_Request) (Required) Full data about the request.

Return

(array|WP_Error) oEmbed response data or WP_Error on failure.

Source

File: wp-includes/class-wp-oembed-controller.php 

public function get_item( $request ) {
		$post_id = url_to_postid( $request['url'] );

		/**
		 * Filters the determined post ID.
		 *
		 * @since 4.4.0
		 *
		 * @param int    $post_id The post ID.
		 * @param string $url     The requested URL.
		 */
		$post_id = apply_filters( 'oembed_request_post_id', $post_id, $request['url'] );

		$data = get_oembed_response_data( $post_id, $request['maxwidth'] );

		if ( ! $data ) {
			return new WP_Error( 'oembed_invalid_url', get_status_header_desc( 404 ), array( 'status' => 404 ) );
		}

		return $data;
	}

Uses

Uses Description
wp-includes/embed.php: get_oembed_response_data()

Retrieves the oEmbed response data for a given post.
wp-includes/class-wp-oembed-controller.php: oembed_request_post_id

Filters the determined post ID.
wp-includes/functions.php: get_status_header_desc()

Retrieve the description for the HTTP status.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/rewrite.php: url_to_postid()

Examine a URL and try to determine the post ID it represents.
wp-includes/class-wp-error.php: WP_Error::__construct()

Initialize the error.

Changelog

Version Description
4.4.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_oembed_controller/get_item