функция
since 4.4.0
wp_oembed_add_discovery_links()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_oembed_add_discovery_links()
Описание
Добавляет ссылки обнаружения oEmbed в элемент head сайта.
Исходный код
wp-includes/embed.php:337
function wp_oembed_add_discovery_links() {
if ( doing_action( 'wp_head' ) ) {
// For back-compat, short-circuit if a plugin has removed the action at the original priority.
if ( ! has_action( 'wp_head', 'wp_oembed_add_discovery_links', 10 ) ) {
return;
}
// Prevent running again at the original priority.
remove_action( 'wp_head', '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 );
}
История изменений
| Версия | Описание |
|---|---|
| 6.9.0 | Now runs first at wp_head priority 4, with a fallback to priority 10. This helps ensure the discovery links appear within the first 150KB. |
| 6.8.0 | Output was adjusted to only embed if the post supports it. |
| 4.4.0 | Introduced. |

