oembed_result

查看官方原文 ↗

💡 云策文档标注

概述

oembed_result 过滤器用于修改从 oEmbed 提供程序返回的 HTML 内容。它允许开发者在 oEmbed 响应被缓存到 postmeta 表之前，对嵌入的 HTML 进行自定义处理。

此过滤器在 oEmbed 响应被缓存前应用，因此如果需要对所有嵌入 URL 的 HTML 进行修改，应考虑使用 embed_oembed_html 过滤器，但需注意其可能影响性能。

📄 原文内容

Filters the HTML returned by the oEmbed provider.

$datastring|false

The returned oEmbed HTML (false if unsafe).

$urlstring

URL of the content to be embedded.

$argsstring|array

Additional arguments for retrieving embed HTML.
See wp_oembed_get() for accepted arguments. Default empty.

More Arguments from wp_oembed_get( … $args )

Additional arguments for retrieving embed HTML. Default empty.

width int|string
Optional. The maxwidth value passed to the provider URL.
height int|string
Optional. The maxheight value passed to the provider URL.
discover bool
Optional. Determines whether to attempt to discover link tags at the given URL for an oEmbed provider when the provider URL is not found in the built-in providers list. Default true.

return apply_filters( 'oembed_result', $this->data2html( $data, $url ), $url, $args );

Used by	Description
WP_oEmbed_Controller::get_proxy_item()`wp-includes/class-wp-oembed-controller.php`	Callback for the proxy API endpoint.
WP_oEmbed::get_html()`wp-includes/class-wp-oembed.php`	The do-it-all function that takes a URL and attempts to return the HTML.

Version	Description
2.9.0	Introduced.