wp_embed_handler_video() WordPress Function
wp_embed_handler_video() is a function used by WordPress to handle embedding videos. This function is used when a user embeds a video into a WordPress post or page.
wp_embed_handler_video( array $matches, array $attr, string $url, array $rawattr ) #
Video embed handler callback.
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_video( $matches, $attr, $url, $rawattr ) { $dimensions = ''; if ( ! empty( $rawattr['width'] ) && ! empty( $rawattr['height'] ) ) { $dimensions .= sprintf( 'width="%d" ', (int) $rawattr['width'] ); $dimensions .= sprintf( 'height="%d" ', (int) $rawattr['height'] ); } $video = sprintf( '[video %s src="%s" /]', $dimensions, esc_url( $url ) ); /** * Filters the video embed output. * * @since 3.6.0 * * @param string $video Video 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_video', $video, $attr, $url, $rawattr ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.6.0 | Introduced. |