oembed_providers
Filter HookDescription
Filters the list of sanctioned oEmbed providers. 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 | 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 | reddit.com | 4.4.0 | | Speaker Deck | speakerdeck.com | 4.4.0 | | Twitter | twitter.com/timelines | 4.5.0 | | Twitter | twitter.com/moments | 4.5.0 | | Twitter | twitter.com/user | 4.7.0 | | Twitter | twitter.com/likes | 4.7.0 | | Twitter | 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 | 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 | instagram.com | 3.5.0 | 5.5.2 | | Instagram | 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 | 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 |Hook Information
File Location |
wp-includes/class-wp-oembed.php
View on GitHub
|
Hook Type | Filter |
Line Number | 226 |
Hook Parameters
Type | Name | Description |
---|---|---|
array[]
|
$providers
|
An array of arrays containing data about popular oEmbed providers. |
Usage Examples
Basic Usage
<?php
// Hook into oembed_providers
add_filter('oembed_providers', 'my_custom_filter', 10, 1);
function my_custom_filter($providers) {
// Your custom filtering logic here
return $providers;
}
Source Code Context
wp-includes/class-wp-oembed.php:226
- How this hook is used in WordPress core
<?php
221 *
222 * @since 2.9.0
223 *
224 * @param array[] $providers An array of arrays containing data about popular oEmbed providers.
225 */
226 $this->providers = apply_filters( 'oembed_providers', $providers );
227
228 // Fix any embeds that contain new lines in the middle of the HTML which breaks wpautop().
229 add_filter( 'oembed_dataparse', array( $this, '_strip_newlines' ), 10, 3 );
230 }
231
PHP Documentation
<?php
/**
* Filters the list of sanctioned oEmbed providers.
*
* 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 | 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 | reddit.com | 4.4.0 |
* | Speaker Deck | speakerdeck.com | 4.4.0 |
* | Twitter | twitter.com/timelines | 4.5.0 |
* | Twitter | twitter.com/moments | 4.5.0 |
* | Twitter | twitter.com/user | 4.7.0 |
* | Twitter | twitter.com/likes | 4.7.0 |
* | Twitter | 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 | 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 | instagram.com | 3.5.0 | 5.5.2 |
* | Instagram | 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 | 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 wp_oembed_add_provider()
*
* @since 2.9.0
*
* @param array[] $providers An array of arrays containing data about popular oEmbed providers.
*/
Quick Info
- Hook Type: Filter
- Parameters: 1
- File: wp-includes/class-wp-oembed.php
Related Hooks
Related hooks will be displayed here in future updates.