Warning: This function has been deprecated. Use wp_maybe_enqueue_oembed_host_js() instead.
wp_oembed_add_host_js() WordPress Function
The wp_oembed_add_host_js() function allows you to add JavaScript to the host page for your oEmbed provider. This is useful if you need to load additional resources or make changes to the page.
wp_oembed_add_host_js() #
Adds the necessary JavaScript to communicate with the embedded iframes.
Contents
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() {}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.9.0 | Use wp_maybe_enqueue_oembed_host_js() instead. |
| 4.4.0 | Introduced. |