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.


Top ↑

Return

(string) The embed HTML.


Top ↑

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 );
}


Top ↑

Changelog

Changelog
VersionDescription
3.6.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.