在发出任何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/