wp_embed_handler_audio() WordPress Function
The wp_embed_handler_audio() function is used to handle audio embeds. Audio files can be played inline on supported browsers, and will be replaced with a download link on unsupported browsers.
wp_embed_handler_audio( array $matches, array $attr, string $url, array $rawattr ) #
Audio 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_audio( $matches, $attr, $url, $rawattr ) {
$audio = sprintf( '[audio src="%s" /]', esc_url( $url ) );
/**
* Filters the audio embed output.
*
* @since 3.6.0
*
* @param string $audio Audio 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_audio', $audio, $attr, $url, $rawattr );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |