This function has been deprecated. Use wp_maybe_enqueue_oembed_host_js() instead.
wp_oembed_add_host_js()
Adds the necessary JavaScript to communicate with the embedded iframes.
Description
This function is no longer used directly. For back-compat it exists exclusively as a way to indicate that the oEmbed host JS should be added. In default-filters.php
there remains this code:
add_action( 'wp_head', 'wp_oembed_add_host_js' )
Historically a site has been able to disable adding the oEmbed host script by doing:
remove_action( 'wp_head', 'wp_oembed_add_host_js' )
In order to ensure that such code still works as expected, this function remains. There is now a has_action()
check in wp_maybe_enqueue_oembed_host_js()
to see if wp_oembed_add_host_js()
has not been unhooked from running at the wp_head
action.
Source
File: wp-includes/embed.php
function wp_oembed_add_host_js() {
wp_enqueue_script( 'wp-embed' );
}
Changelog
Version | Description |
---|---|
5.9.0 | Use wp_maybe_enqueue_oembed_host_js() instead. |
4.4.0 | Introduced. This function has been deprecated. Use {@see wp_maybe_enqueue_oembed_host_js()} instead. |