oembed_providers
云策文档标注
概述
oembed_providers 过滤器用于修改 WordPress 中受信任的 oEmbed 提供者列表。自 WordPress 4.4 起，oEmbed 发现功能对所有用户启用，允许嵌入经过清理的 iframe 等内容。
关键要点
- oembed_providers 过滤器允许开发者自定义受信任的 oEmbed 提供者列表，这些提供者可以嵌入 iframe、视频、JavaScript 和任意 HTML。
- 文档列出了当前支持的提供者（如 YouTube、Twitter、Amazon 等）及其域名和引入版本，以及不再支持的提供者（如 Instagram、Facebook 等）及其移除版本。
- 该过滤器在 WP_oEmbed 类中应用，参数为包含提供者数据的数组。
注意事项
- 使用此过滤器时需谨慎，因为添加不受信任的提供者可能带来安全风险。
- 参考 wp_oembed_add_provider() 函数以添加新的提供者。
原文内容
Filters the list of sanctioned oEmbed providers.
Description
Since WordPress 4.4, oEmbed discovery is enabled for all users and allows embedding of sanitized iframes. The providers in this list are sanctioned, meaning they are trusted and allowed to embed any content, such as iframes, videos, JavaScript, and arbitrary HTML.
Supported providers:
| Provider | Flavor | Since |
|---|---|---|
| Dailymotion | dailymotion.com | 2.9.0 |
| Flickr | flickr.com | 2.9.0 |
| Scribd | scribd.com | 2.9.0 |
| Vimeo | vimeo.com | 2.9.0 |
| WordPress.tv | wordpress.tv | 2.9.0 |
| YouTube | youtube.com/watch | 2.9.0 |
| Crowdsignal | polldaddy.com | 3.0.0 |
| SmugMug | smugmug.com | 3.0.0 |
| YouTube | youtu.be | 3.0.0 |
| twitter.com | 3.4.0 | |
| SoundCloud | soundcloud.com | 3.5.0 |
| Dailymotion | dai.ly | 3.6.0 |
| Flickr | flic.kr | 3.6.0 |
| Spotify | spotify.com | 3.6.0 |
| Imgur | imgur.com | 3.9.0 |
| Animoto | animoto.com | 4.0.0 |
| Animoto | video214.com | 4.0.0 |
| Issuu | issuu.com | 4.0.0 |
| Mixcloud | mixcloud.com | 4.0.0 |
| Crowdsignal | poll.fm | 4.0.0 |
| TED | ted.com | 4.0.0 |
| YouTube | youtube.com/playlist | 4.0.0 |
| Tumblr | tumblr.com | 4.2.0 |
| Kickstarter | kickstarter.com | 4.2.0 |
| Kickstarter | kck.st | 4.2.0 |
| Cloudup | cloudup.com | 4.3.0 |
| ReverbNation | reverbnation.com | 4.4.0 |
| VideoPress | videopress.com | 4.4.0 |
| reddit.com | 4.4.0 | |
| Speaker Deck | speakerdeck.com | 4.4.0 |
| twitter.com/timelines | 4.5.0 | |
| twitter.com/moments | 4.5.0 | |
| twitter.com/user | 4.7.0 | |
| twitter.com/likes | 4.7.0 | |
| twitter.com/lists | 4.7.0 | |
| Screencast | screencast.com | 4.8.0 |
| Amazon | amazon.com (com.mx, com.br, ca) | 4.9.0 |
| Amazon | amazon.de (fr, it, es, in, nl, ru, co.uk) | 4.9.0 |
| Amazon | amazon.co.jp (com.au) | 4.9.0 |
| Amazon | amazon.cn | 4.9.0 |
| Amazon | a.co | 4.9.0 |
| Amazon | amzn.to (eu, in, asia) | 4.9.0 |
| Amazon | z.cn | 4.9.0 |
| Someecards | someecards.com | 4.9.0 |
| Someecards | some.ly | 4.9.0 |
| Crowdsignal | survey.fm | 5.1.0 |
| TikTok | tiktok.com | 5.4.0 |
| pinterest.com | 5.9.0 | |
| WolframCloud | wolframcloud.com | 5.9.0 |
| Pocket Casts | pocketcasts.com | 6.1.0 |
| Crowdsignal | crowdsignal.net | 6.2.0 |
| Anghami | anghami.com | 6.3.0 |
| Bluesky | bsky.app | 6.6.0 |
| Canva | canva.com | 6.8.0 |
No longer supported providers:
| Provider | Flavor | Since | Removed |
|---|---|---|---|
| Qik | qik.com | 2.9.0 | 3.9.0 |
| Viddler | viddler.com | 2.9.0 | 4.0.0 |
| Revision3 | revision3.com | 2.9.0 | 4.2.0 |
| Blip | blip.tv | 2.9.0 | 4.4.0 |
| Rdio | rdio.com | 3.6.0 | 4.4.1 |
| Rdio | rd.io | 3.6.0 | 4.4.1 |
| Vine | vine.co | 4.1.0 | 4.9.0 |
| Photobucket | photobucket.com | 2.9.0 | 5.1.0 |
| Funny or Die | funnyordie.com | 3.0.0 | 5.1.0 |
| CollegeHumor | collegehumor.com | 4.0.0 | 5.3.1 |
| Hulu | hulu.com | 2.9.0 | 5.5.0 |
| instagram.com | 3.5.0 | 5.5.2 | |
| instagr.am | 3.5.0 | 5.5.2 | |
| Instagram TV | instagram.com | 5.1.0 | 5.5.2 |
| Instagram TV | instagr.am | 5.1.0 | 5.5.2 |
| facebook.com | 4.7.0 | 5.5.2 | |
| Meetup.com | meetup.com | 3.9.0 | 6.0.1 |
| Meetup.com | meetu.ps | 3.9.0 | 6.0.1 |
| SlideShare | slideshare.net | 3.5.0 | 6.6.0 |
| Screencast | screencast.com | 4.8.0 | 6.8.2 |
See also
Parameters
$providersarray[]-
An array of arrays containing data about popular oEmbed providers.
Source
$this->providers = apply_filters( 'oembed_providers', $providers );
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |