wp_embed_handler_youtube

YouTube iframe embed handler callback.

Description

(string) wp_embed_handler_youtube( (array) $matches, (array) $attr, (string) $url, (array) $rawattr ); 

Catches YouTube iframe embed URLs that are not parsable by oEmbed but can be translated into a URL that is.

Returns (string)

The embed HTML.

Parameters (4)

0. $matches (array)
The RegEx matches from the provided regex when calling wp_embed_register_handler(…).
1. $attr (array)
Embed attributes.
2. $url (string)
The original URL that was matched by the regex.
3. $rawattr (array)
The original unmodified attributes.

Usage

  1. if ( !function_exists( 'wp_embed_handler_youtube' ) ) { 
  2.     require_once ABSPATH . WPINC . '/embed.php'; 
  3. } 
  4.   
  5. // The RegEx matches from the provided regex when calling 
  6. // wp_embed_register_handler(). 
  7. $matches = array(); 
  8.   
  9. // Embed attributes. 
  10. $attr = array(); 
  11.   
  12. // The original URL that was matched by the regex. 
  13. $url = ''; 
  14.   
  15. // The original unmodified attributes. 
  16. $rawattr = array(); 
  17.   
  18. // NOTICE! Understand what this does before running. 
  19. $result = wp_embed_handler_youtube($matches, $attr, $url, $rawattr); 
  20.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/embed.php  
  1. function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) { 
  2.     global $wp_embed; 
  3.     $embed = $wp_embed->autoembed( "https://youtube.com/watch?v={$matches[2]}" ); 
  4.  
  5.     /** 
  6.      * Filters the YoutTube embed output. 
  7.      * 
  8.      * @since 4.0.0 
  9.      * 
  10.      * @see wp_embed_handler_youtube() 
  11.      * 
  12.      * @param string $embed   YouTube embed output. 
  13.      * @param array  $attr    An array of embed attributes. 
  14.      * @param string $url     The original URL that was matched by the regex. 
  15.      * @param array  $rawattr The original unmodified attributes. 
  16.      */ 
  17.     return apply_filters( 'wp_embed_handler_youtube', $embed, $attr, $url, $rawattr ); 
  18. }