W3cubDocs

/WordPress

wp_maybe_load_embeds()

Determines if default embed handlers should be loaded.

Description

Checks to make sure that the embeds library hasn’t already been loaded. If it hasn’t, then it will load the embeds library.

See also

Source

File: wp-includes/embed.php 

function wp_maybe_load_embeds() {
	/**
	 * Filters whether to load the default embed handlers.
	 *
	 * Returning a falsey value will prevent loading the default embed handlers.
	 *
	 * @since 2.9.0
	 *
	 * @param bool $maybe_load_embeds Whether to load the embeds library. Default true.
	 */
	if ( ! apply_filters( 'load_default_embeds', true ) ) {
		return;
	}

	wp_embed_register_handler( 'youtube_embed_url', '#https?://(www.)?youtube\.com/(?:v|embed)/([^/]+)#i', 'wp_embed_handler_youtube' );

	/**
	 * Filters the audio embed handler callback.
	 *
	 * @since 3.6.0
	 *
	 * @param callable $handler Audio embed handler callback function.
	 */
	wp_embed_register_handler( 'audio', '#^https?://.+?\.(' . join( '|', wp_get_audio_extensions() ) . ')$#i', apply_filters( 'wp_audio_embed_handler', 'wp_embed_handler_audio' ), 9999 );

	/**
	 * Filters the video embed handler callback.
	 *
	 * @since 3.6.0
	 *
	 * @param callable $handler Video embed handler callback function.
	 */
	wp_embed_register_handler( 'video', '#^https?://.+?\.(' . join( '|', wp_get_video_extensions() ) . ')$#i', apply_filters( 'wp_video_embed_handler', 'wp_embed_handler_video' ), 9999 );
}

Uses

Uses Description
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/embed.php: wp_embed_register_handler()

Registers an embed handler.
wp-includes/embed.php: load_default_embeds

Filters whether to load the default embed handlers.
wp-includes/embed.php: wp_audio_embed_handler

Filters the audio embed handler callback.
wp-includes/embed.php: wp_video_embed_handler

Filters the video embed handler callback.
wp-includes/media.php: wp_get_video_extensions()

Returns a filtered list of supported video formats.
wp-includes/media.php: wp_get_audio_extensions()

Returns a filtered list of supported audio formats.

Changelog

Version Description
2.9.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_maybe_load_embeds