wppaste
WordPress

apply_filters( 'oembed_fetch_url', string $provider, string $url, array $args )

Since
2.9.0, 4.9.0
Filters the oEmbed URL to be fetched.

Compatibility

WordPress
since 4.9.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$providerstring
URL of the oEmbed provider.
$urlstring
URL of the content to be embedded.
$argsarray
Additional arguments for retrieving embed HTML.
See wp_oembed_get() for accepted arguments. Default empty.

Where this hook fires · 1

  • wp-includes/class-wp-oembed.php:553WP_oEmbed::fetch()

Source code

		 *		 * @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. 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->get_error_code() ) {				continue;			}

Changelog

Introduced in 2.9.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

4.9.0
The dnt (Do Not Track) query parameter was added to all oEmbed provider URLs.from the docblock
2.9.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 6.9.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.