W3cubDocs

/WordPress

WP_oEmbed::_fetch_with_format( string $provider_url_with_args, string $format )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Fetches result from an oEmbed provider for a specific format and complete provider URL

Parameters

$provider_url_with_args

(string) (Required) URL to the provider with full arguments list (url, maxheight, etc.)

$format

(string) (Required) Format to use.

Return

(object|false|WP_Error) The result in the form of an object on success, false on failure.

Source

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

private function _fetch_with_format( $provider_url_with_args, $format ) {
		$provider_url_with_args = add_query_arg( 'format', $format, $provider_url_with_args );

		/** This filter is documented in wp-includes/class-wp-oembed.php */
		$args = apply_filters( 'oembed_remote_get_args', array(), $provider_url_with_args );

		$response = wp_safe_remote_get( $provider_url_with_args, $args );
		if ( 501 == wp_remote_retrieve_response_code( $response ) ) {
			return new WP_Error( 'not-implemented' );
		}
		$body = wp_remote_retrieve_body( $response );
		if ( ! $body ) {
			return false;
		}
		$parse_method = "_parse_$format";
		return $this->$parse_method( $body );
	}

Uses

Uses Description
wp-includes/class-wp-oembed.php: oembed_remote_get_args

Filters oEmbed remote get arguments.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
wp-includes/http.php: wp_safe_remote_get()

Retrieve the raw response from a safe HTTP request using the GET method.
wp-includes/http.php: wp_remote_retrieve_response_code()

Retrieve only the response code from the raw response.
wp-includes/http.php: wp_remote_retrieve_body()

Retrieve only the body from the raw response.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/class-wp-error.php: WP_Error::__construct()

Initialize the error.

Used By

Used By Description
wp-includes/class-wp-oembed.php: WP_oEmbed::fetch()

Connects to a oEmbed provider and returns the result.

Changelog

Version Description
3.0.0 Introduced.

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