WP_oEmbed

Hooks fired · 8

Every hook that fires from inside WP_oEmbed, in the order it appears in the class, grouped by the method that fires it.

Properties · 3

$providersarray<string,public

A list of oEmbed providers.

$early_providersarraypublic static

A list of an early oEmbed providers.

$compat_methodsarrayprivate

A list of private/protected methods, used for backward compatibility.

Methods · 16

• __construct()Constructor.
• __call()Exposes private/protected methods for backward compatibility.
• sanitize_provider()Sanitizes and normalizes a single oEmbed provider entry.
• get_provider()Takes a URL and returns the corresponding oEmbed provider's URL, if there is one.
• _add_provider_early()Adds an oEmbed provider.
• _remove_provider_early()Removes an oEmbed provider.
• get_data()Takes a URL and attempts to return the oEmbed data.
• get_html()The do-it-all function that takes a URL and attempts to return the HTML.
• discover()Attempts to discover link tags at the given URL for an oEmbed provider.
• fetch()Connects to an oEmbed provider and returns the result.
• _fetch_with_format()Fetches result from an oEmbed provider for a specific format and complete provider URL
• _parse_json()Parses a json response body.
• _parse_xml()Parses an XML response body.
• _parse_xml_body()Serves as a helper function for parsing an XML response body.
• data2html()Converts a data object from WP_oEmbed::fetch() and returns the HTML.
• _strip_newlines()Strips any new lines from the HTML.

Source

View on Trac ↗View on GitHub ↗

19#[AllowDynamicProperties]20class WP_oEmbed {21 22	/**23	 * A list of oEmbed providers.24	 *25	 * @since 2.9.026	 * @var array<string, array{ 0: string, 1: bool }> An associative array mapping URL patterns to provider data.27	 *                                                 Each entry's value is an array with the provider endpoint URL28	 *                                                 string at index 0 and a boolean at index 1 indicating whether29	 *                                                 the URL pattern (array key) is a regular expression.30	 */31	public $providers = array();32 33	/**34	 * A list of an early oEmbed providers.35	 *36	 * @since 4.0.037	 * @var array38	 */39	public static $early_providers = array();40 41	/**42	 * A list of private/protected methods, used for backward compatibility.43	 *44	 * @since 4.2.045	 * @var array46	 */47	private $compat_methods = array( '_fetch_with_format', '_parse_json', '_parse_xml', '_parse_xml_body' );48 49	/**50	 * Constructor.51	 *52	 * @since 2.9.053	 */54	public function __construct() {55		$host      = urlencode( home_url() );56		$providers = array(57			'#https?://((m|www)\.)?youtube\.com/watch.*#i' => array( 'https://www.youtube.com/oembed', true ),58			'#https?://((m|www)\.)?youtube\.com/playlist.*#i' => array( 'https://www.youtube.com/oembed', true ),59			'#https?://((m|www)\.)?youtube\.com/shorts/*#i' => array( 'https://www.youtube.com/oembed', true ),60			'#https?://((m|www)\.)?youtube\.com/live/*#i'  => array( 'https://www.youtube.com/oembed', true ),61			'#https?://youtu\.be/.*#i'                     => array( 'https://www.youtube.com/oembed', true ),62			'#https?://(.+\.)?vimeo\.com/.*#i'             => array( 'https://vimeo.com/api/oembed.{format}', true ),63			'#https?://(www\.)?dailymotion\.com/.*#i'      => array( 'https://www.dailymotion.com/services/oembed', true ),64			'#https?://dai\.ly/.*#i'                       => array( 'https://www.dailymotion.com/services/oembed', true ),65			'#https?://(www\.)?flickr\.com/.*#i'           => array( 'https://www.flickr.com/services/oembed/', true ),66			'#https?://flic\.kr/.*#i'                      => array( 'https://www.flickr.com/services/oembed/', true ),67			'#https?://(.+\.)?smugmug\.com/.*#i'           => array( 'https://api.smugmug.com/services/oembed/', true ),68			'#https?://(www\.)?scribd\.com/(doc|document)/.*#i' => array( 'https://www.scribd.com/services/oembed', true ),69			'#https?://wordpress\.tv/.*#i'                 => array( 'https://wordpress.tv/oembed/', true ),70			'#https?://(.+\.)?crowdsignal\.net/.*#i'       => array( 'https://api.crowdsignal.com/oembed', true ),71			'#https?://(.+\.)?polldaddy\.com/.*#i'         => array( 'https://api.crowdsignal.com/oembed', true ),72			'#https?://poll\.fm/.*#i'                      => array( 'https://api.crowdsignal.com/oembed', true ),73			'#https?://(.+\.)?survey\.fm/.*#i'             => array( 'https://api.crowdsignal.com/oembed', true ),74			'#https?://(www\.)?twitter\.com/\w{1,15}/status(es)?/.*#i' => array( 'https://publish.twitter.com/oembed', true ),75			'#https?://(www\.)?twitter\.com/\w{1,15}$#i'   => array( 'https://publish.twitter.com/oembed', true ),76			'#https?://(www\.)?twitter\.com/\w{1,15}/likes$#i' => array( 'https://publish.twitter.com/oembed', true ),77			'#https?://(www\.)?twitter\.com/\w{1,15}/lists/.*#i' => array( 'https://publish.twitter.com/oembed', true ),78			'#https?://(www\.)?twitter\.com/\w{1,15}/timelines/.*#i' => array( 'https://publish.twitter.com/oembed', true ),79			'#https?://(www\.)?twitter\.com/i/moments/.*#i' => array( 'https://publish.twitter.com/oembed', true ),80			'#https?://(www\.)?soundcloud\.com/.*#i'       => array( 'https://soundcloud.com/oembed', true ),81			'#https?://(open|play)\.spotify\.com/.*#i'     => array( 'https://embed.spotify.com/oembed/', true ),82			'#https?://(.+\.)?imgur\.com/.*#i'             => array( 'https://api.imgur.com/oembed', true ),83			'#https?://(www\.)?issuu\.com/.+/docs/.+#i'    => array( 'https://issuu.com/oembed_wp', true ),84			'#https?://(www\.)?mixcloud\.com/.*#i'         => array( 'https://app.mixcloud.com/oembed/', true ),85			'#https?://(www\.|embed\.)?ted\.com/talks/.*#i' => array( 'https://www.ted.com/services/v1/oembed.{format}', true ),86			'#https?://(www\.)?(animoto|video214)\.com/play/.*#i' => array( 'https://animoto.com/oembeds/create', true ),87			'#https?://(.+)\.tumblr\.com/.*#i'             => array( 'https://www.tumblr.com/oembed/1.0', true ),88			'#https?://(www\.)?kickstarter\.com/projects/.*#i' => array( 'https://www.kickstarter.com/services/oembed', true ),89			'#https?://kck\.st/.*#i'                       => array( 'https://www.kickstarter.com/services/oembed', true ),90			'#https?://cloudup\.com/.*#i'                  => array( 'https://cloudup.com/oembed', true ),91			'#https?://(www\.)?reverbnation\.com/.*#i'     => array( 'https://www.reverbnation.com/oembed', true ),92			'#https?://videopress\.com/v/.*#'              => array( 'https://public-api.wordpress.com/oembed/?for=' . $host, true ),93			'#https?://(www\.)?reddit\.com/r/[^/]+/comments/.*#i' => array( 'https://www.reddit.com/oembed', true ),94			'#https?://(www\.)?speakerdeck\.com/.*#i'      => array( 'https://speakerdeck.com/oembed.{format}', true ),95			'#https?://([a-z0-9-]+\.)?amazon\.(com|com\.mx|com\.br|ca)/.*#i' => array( 'https://read.amazon.com/kp/api/oembed', true ),96			'#https?://([a-z0-9-]+\.)?amazon\.(co\.uk|de|fr|it|es|in|nl|ru)/.*#i' => array( 'https://read.amazon.co.uk/kp/api/oembed', true ),97			'#https?://([a-z0-9-]+\.)?amazon\.(co\.jp|com\.au)/.*#i' => array( 'https://read.amazon.com.au/kp/api/oembed', true ),98			'#https?://([a-z0-9-]+\.)?amazon\.cn/.*#i'     => array( 'https://read.amazon.cn/kp/api/oembed', true ),

History

Introduced in 2.9.0. One change between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/class-wp-oembed.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.