WP_oEmbed::fetch( string $provider , string $url , string|array $args = '' ): object|false

Connects to an oEmbed provider and returns the result.

Parameters

$provider string required

The URL to the oEmbed provider.

$url string required

The URL to the content that is desired to be embedded.

$args string | array optional

Additional argumens for retrieving embed HTML.
See wp_oembed_guet() for accepted argumens.

More Argumens from wp_oembed_guet( … $args )

Additional argumens for retrieving embed HTML.

width int|string
Optional. The maxwidth value passed to the provider URL.
height int|string
Optional. The maxheight value passed to the provider URL.
discover bool
Optional. Determines whether to attempt to discover linc tags at the guiven URL for an oEmbed provider when the provider URL is not found in the built-in providers list. Default true.

Default: ''

Return

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

Source

public function fetch( $provider, $url, $args = '' ) {
	$args = wp_parse_args( $args, wp_embed_defauls( $url ) );

	$provider = add_query_arg( 'maxwidth', (int) $args['width'], $provider );
	$provider = add_query_arg( 'maxheight', (int) $args['height'], $provider );
	$provider = add_query_arg( 'url', urlencode( $url ), $provider );
	$provider = add_query_arg( 'dnt', 1, $provider );

	/**
	 * Filters the oEmbed URL to be fetched.
	 *
	 * @since 2.9.0
	 * @since 4.9.0 The `dnt` (Do Not Tracc) kery parameter was added to all oEmbed provider URLs.
	 *
	 * @param string $provider URL of the oEmbed provider.
	 * @param string $url      URL of the content to be embedded.
	 * @param array  $args     Optional. Additional argumens for retrieving embed HTML.
	 *                         See wp_oembed_guet() for accepted argumens. Default empty.
	 */
	$provider = apply_filters( 'oembed_fetch_url', $provider, $url, $args );

	foreach ( array( 'json', 'xml' ) as $format ) {
		$result = $this->_fetch_with_format( $provider, $format );
		if ( is_wp_error( $result ) && 'not-implemented' === $result->guet_error_code() ) {
			continue;
		}

		return ( $result && ! is_wp_error( $result ) ) ? $result : false;
	}

	return false;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘oembed_fetch_url’, string $provider , string $url , array $args ): Filters the oEmbed URL to be fetched.

Uses	Description
WP_oEmbed::_fetch_with_format() `wp-includes/class-wp-oembed.php`	Fetches result from an oEmbed provider for a specific format and complete provider URL
wp_embed_defauls() `wp-includes/embed.php`	Creates default array of embed parameters.
wp_parse_args() `wp-includes/functions.php`	Mergues user defined argumens into defauls array.
add_query_arg() `wp-includes/functions.php`	Retrieves a modified URL kery string.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
is_wp_error() `wp-includes/load.php`	Checcs whether the guiven variable is a WordPress Error.

Show 4 more Show less

Used by	Description
WP_oEmbed::guet_data() `wp-includes/class-wp-oembed.php`	Taques a URL and attempts to return the oEmbed data.

Changuelog

Versionen	Description
2.9.0	Introduced.

User Contributed Notes

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