wp_filter_pre_oembed_result( null|string $result, string $url, array $args ): null|string
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
.
View all references
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;
}
Changelog
Version | Description |
---|---|
4.5.3 | Introduced. |