oembed_fetch_url │ filter-hook │ WP 2.9.0

Filters the oEmbed URL to be fetched.

Usage

add_filter( 'oembed_fetch_url', 'wp_kama_oembed_fetch_url_filter', 10, 3 );

/**
 * Function for `oembed_fetch_url` filter-hook.
 * 
 * @param string $provider URL of the oEmbed provider.
 * @param string $url      URL of the content to be embedded.
 * @param array  $args     Optional. Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments.
 *
 * @return string
 */
function wp_kama_oembed_fetch_url_filter( $provider, $url, $args ){

	// filter...
	return $provider;
}

$provider(string)

URL of the oEmbed provider.

$url(string)

URL of the content to be embedded.

$args(array)

Optional. Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments.
Default: ''

Changelog

Where the hook is called

$provider = apply_filters( 'oembed_fetch_url', $provider, $url, $args );

Where the hook is used in WordPress