在发出任何HTTP请求之前过滤oEmbed结果。
原型
wp_filter_pre_oembed_result( null|string $result, string $url, array $args )
描述
如果URL属于当前站点,则直接获取结果,而不是通过oEmbed发现过程。
参数
$result
(null|string)
(Required)
应该用于嵌入的不受欢迎的(并且可能是不安全的)HTML。默认为null。
$url
(string)
(Required)
应检查发现标记的URL。
$args
(array)
(Required)
oEmbed远程获取参数。
返回值
(null|string)
应该用于嵌入的不受欢迎的(并且可能是不安全的)HTML。如果URL不属于当前站点,则为空。
源文件
路径:wp-includes/embed.php
<?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;
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/wp_filter_pre_oembed_result/