embed_oembed_discover │ хук-фільтр │ WP 2.9.0

Дозволяє вказати, чи потрібно переходити по URL і шукати <link>тег вбудовування на віддаленому сайті.

Дозволяє змінити значення атрибуту $attr['discover']функції wp_oembed_get( $url, $args ) .

Коли будь-який сайт є постачальником oEmbed, він додає мітку про це в <head> частину HTML документа. Приклад таких метатегів:

<link rel="alternate" type="application/json+oembed" href="/api/oembed/1.0/embed?url=https%3A%2F%2Fwp-kama.ru%2Fhandbook%2Fcodex%2Foembed" />
<link rel="alternate" type="text/xml+oembed" href="/api/oembed/1.0/embed?url=https%3A%2F%2Fwp-kama.ru%2Fhandbook%2Fcodex%2Foembed&format=xml" />

Тобто. кожен постачальник oEmbed повинен мати такі метатеги, щоб повідомити всіх, що поточна сторінка може бути вбудована на іншому сайті.

Коли ми додаємо будь-який URL у контент нашого сайту, WordPress перевіряє чи є цей URL одним із зареєстрованих постачальників oEmbed (наприклад YouTube), якщо є, то код вбудовування створюється за відомою логікою для цього URL, але якщо не є, то наш WP може пройти по URL і подивитися чи є в HTML мітки, що URL можна вбудувати.

Так ось, цей Хук дозволяє включити або вимкнути таку перевірку HTML мета-тегу . Тобто. якщо в хуку повернути false, то така перевірка не робитиметься для невідомих URL. Таким чином, якщо ми вставимо в контент URL, який невідомий WP, то він ніяк не перевіриться і просто буде виведений в контенті як є.

Читайте також oEmbed в WordPress .

Використання

add_filter( 'embed_oembed_discover', 'wp_kama_embed_oembed_discover_filter');

/**
 * Function for `embed_oembed_discover` filter-hook.
 *
 * @param bool $enable Whether to enable `<link>` tag discovery.
 *
 * @return bool
 */
function wp_kama_embed_oembed_discover_filter( $enable ){

	// Filter...
	return $enable;
}

$enable (true|false): Чи потрібно увімкнути пошук тегу
<link> за URL-адресою.

Типово: true

Приклади

#1 Відключимо авто-визначення oEmbed для невідомих URL

// Remove oEmbed iframes communicate JavaScript з front-end and back-end.
remove_action( 'wp_head', 'wp_oembed_add_host_js');

// Turn off oEmbed auto discovery request for unknown URLs.
add_filter( 'embed_oembed_discover', '__return_false');