wp_embed_handler_youtube() WordPress Function
The wp_embed_handler_youtube function is used to embed YouTube videos in WordPress. This function can be used in conjunction with the oEmbed feature to automatically embed YouTube videos in WordPress.
wp_embed_handler_youtube( array $matches, array $attr, string $url, array $rawattr ) #
YouTube iframe embed handler callback.
Description
Catches YouTube iframe embed URLs that are not parsable by oEmbed but can be translated into a URL that is.
Parameters
- $matches
(array)(Required)The RegEx matches from the provided regex when calling wp_embed_register_handler().
- $attr
(array)(Required)Embed attributes.
- $url
(string)(Required)The original URL that was matched by the regex.
- $rawattr
(array)(Required)The original unmodified attributes.
Return
(string) The embed HTML.
Source
File: wp-includes/embed.php
function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) { global $wp_embed; $embed = $wp_embed->autoembed( sprintf( 'https://youtube.com/watch?v=%s', urlencode( $matches[2] ) ) ); /** * Filters the YoutTube embed output. * * @since 4.0.0 * * @see wp_embed_handler_youtube() * * @param string $embed YouTube embed output. * @param array $attr An array of embed attributes. * @param string $url The original URL that was matched by the regex. * @param array $rawattr The original unmodified attributes. */ return apply_filters( 'wp_embed_handler_youtube', $embed, $attr, $url, $rawattr ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.0.0 | Introduced. |