oembed_fetch_url

查看官方原文 ↗

💡 云策文档标注

概述

oembed_fetch_url 是一个 WordPress 过滤器，用于在获取 oEmbed 内容时修改提供商的 URL。它允许开发者自定义 oEmbed 请求的 URL，以调整嵌入行为或添加额外参数。

📄 原文内容

Filters the oEmbed URL to be fetched.

$providerstring

URL of the oEmbed provider.

$urlstring

URL of the content to be embedded.

$argsarray

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.

$provider = apply_filters( 'oembed_fetch_url', $provider, $url, $args );

Used by	Description
WP_oEmbed::fetch()`wp-includes/class-wp-oembed.php`	Connects to an oEmbed provider and returns the result.

Version	Description
4.9.0	The `dnt` (Do Not Track) query parameter was added to all oEmbed provider URLs.
2.9.0	Introduced.