On this page
wp_embed_handler_video( array $matches, array $attr, string $url, array $rawattr ): string
Video embed handler callback.
Parameters
$matchesarray Required-
The RegEx matches from the provided regex when calling wp_embed_register_handler() .
$attrarray Required-
Embed attributes.
$urlstring Required-
The original URL that was matched by the regex.
$rawattrarray Required-
The original unmodified attributes.
Return
string The embed HTML.
Source
File: wp-includes/embed.php. View all references
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 );
}
Hooks
- apply_filters( 'wp_embed_handler_video',
string $video ,array $attr ,string $url ,array $rawattr ) -
Filters the video embed output.
Related
Uses
| Uses | Description |
|---|---|
| esc_url() wp-includes/formatting.php | Checks and cleans a URL. |
| apply_filters() wp-includes/plugin.php | Calls the callback functions that have been added to a filter hook. |
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_embed_handler_video