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.
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 docblock2.9.0
Introduced.from the docblock
About this page
- Parsed data
- Generated from the wordpress-develop 6.8.8 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.