wp_oembed_add_discovery_links()

Adds oEmbed discovery links in the head element of the website.

Source

function wp_oembed_add_discovery_links() {
	$output = '';

	if ( is_singular() && is_post_embeddable() ) {
		$output .= '<link rel="alternate" title="' . _x( 'oEmbed (JSON)', 'oEmbed resource link name' ) . '" type="application/json+oembed" href="' . esc_url( get_oembed_endpoint_url( get_permalink() ) ) . '" />' . "\n";

		if ( class_exists( 'SimpleXMLElement' ) ) {
			$output .= '<link rel="alternate" title="' . _x( 'oEmbed (XML)', 'oEmbed resource link name' ) . '" type="text/xml+oembed" href="' . esc_url( get_oembed_endpoint_url( get_permalink(), 'xml' ) ) . '" />' . "\n";
		}
	}

	/**
	 * Filters the oEmbed discovery links HTML.
	 *
	 * @since 4.4.0
	 *
	 * @param string $output HTML of the discovery links.
	 */
	echo apply_filters( 'oembed_discovery_links', $output );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘oembed_discovery_links’, string $output ): Filters the oEmbed discovery links HTML.

Uses	Description
is_post_embeddable()`wp-includes/post.php`	Determines whether a post is embeddable.
get_oembed_endpoint_url()`wp-includes/embed.php`	Retrieves the oEmbed endpoint URL for a given permalink.
is_singular()`wp-includes/query.php`	Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
esc_url()`wp-includes/formatting.php`	Checks and cleans a URL.
get_permalink()`wp-includes/link-template.php`	Retrieves the full permalink for the current post or post ID.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 3 more Show less

Changelog

Version	Description
6.8.0	Output was adjusted to only embed if the post supports it.
4.4.0	Introduced.

In this article

Source

Hooks

Changelog

User Contributed Notes

wp_oembed_add_discovery_links()

In this article

Source

Hooks

Related

Changelog

User Contributed Notes