wp_filter_pre_oembed_result() WordPress Function
The wp_filter_pre_oembed_result() function was introduced in WordPress 4.4. It allows for the modification of the oEmbed HTML before it is passed to the oEmbed provider.
wp_filter_pre_oembed_result( null|string $result, string $url, array $args ) #
Filters the oEmbed result before any HTTP requests are made.
Description
If the URL belongs to the current site, the result is fetched directly instead of going through the oEmbed discovery process.
Parameters
- $result
(null|string)(Required)The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.
- $url
(string)(Required)The URL that should be inspected for discovery
<link>tags.- $args
(array)(Required)oEmbed remote get arguments.
Return
(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Null if the URL does not belong to the current site.
Source
File: wp-includes/embed.php
function wp_filter_pre_oembed_result( $result, $url, $args ) {
$data = get_oembed_response_data_for_url( $url, $args );
if ( $data ) {
return _wp_oembed_get_object()->data2html( $data, $url );
}
return $result;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.5.3 | Introduced. |