wp_maybe_enqueue_oembed_host_js( string $html ): string

Enqueue the wp-embed script if the provided oEmbed HTML contains a post embed.


Description

In order to only enqueue the wp-embed script on pages that actually contain post embeds, this function checks if the provided HTML contains post embed markup and if so enqueues the script so that it will get printed in the footer.


Top ↑

Parameters

$html string Required
Embed markup.

Top ↑

Return

string Embed markup (without modifications).


Top ↑

Source

File: wp-includes/embed.php. View all references

function wp_maybe_enqueue_oembed_host_js( $html ) {
	if (
		has_action( 'wp_head', 'wp_oembed_add_host_js' )
		&&
		preg_match( '/<blockquote\s[^>]*?wp-embedded-content/', $html )
	) {
		wp_enqueue_script( 'wp-embed' );
	}
	return $html;
}


Top ↑

Changelog

Changelog
Version Description
5.9.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.