wp_oembed_add_discovery_links()

In this article

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 );
}

Hooks

apply_filters( ‘oembed_discovery_links’, string $output )

Filters the oEmbed discovery links HTML.

Changelog

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

User Contributed Notes

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