WP_oEmbed::_fetch_with_format() – Method

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

Parameters

$provider_url_with_argsstringrequired: URL to the provider with full arguments list (url, maxheight, etc.)
$formatstringrequired: Format to use.

Return

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

Source

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 );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘oembed_remote_get_args’, array $args, string $url ): Filters oEmbed remote get arguments.

Uses	Description
wp_safe_remote_get()`wp-includes/http.php`	Retrieve the raw response from a safe HTTP request using the GET method.
wp_remote_retrieve_response_code()`wp-includes/http.php`	Retrieve only the response code from the raw response.
wp_remote_retrieve_body()`wp-includes/http.php`	Retrieve only the body from the raw response.
add_query_arg()`wp-includes/functions.php`	Retrieves a modified URL query string.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.
WP_Error::__construct()`wp-includes/class-wp-error.php`	Initializes the error.

Show 3 more Show less

Used by	Description
WP_oEmbed::fetch()`wp-includes/class-wp-oembed.php`	Connects to an oEmbed provider and returns the result.

Changelog

Version	Description
3.0.0	Introduced.

WP_oEmbed::_fetch_with_format( string $provider_url_with_args, string $format ): object|false|WP_Error

In this article

Parameters

Return

Source

Hooks

Changelog

User Contributed Notes

WP_oEmbed::_fetch_with_format( string $provider_url_with_args, string $format ): object|false|WP_Error

In this article

Parameters

Return

Source

Hooks

Related

Changelog

User Contributed Notes