Полное руководство по использованию WordPress Embeds

 <?php wp_oembed_add_provider( $format, $provider, $regex ); ?>

Например,

 <?php wp_oembed_add_provider( 'http://example.com/watchvideo/*', 'http://example.com/oembedprovider' ); ?>

Если медиа могут быть встроены через различные URL, вы можете использовать регулярное выражение для описания различных возможных URL. Если бы мы хотели добавить наш вымышленный сайт TheNewTube с регулярным выражением, мы могли бы использовать следующее:

 <?php wp_oembed_add_provider( '#http://(www\.)?thenewtube\.com/watch.*#i', 'http://www.thenewtube.com/oembed', true ); ?>

Добавление сайтов, которые не поддерживают API oEmbed

Если сайт, который вы хотите встроить, не поддерживает oEmbed, вы все равно можете добавить их в качестве поставщика.

Опять же, через файл functions.php вам необходимо зарегистрировать сайт с помощью wp_embed_register_handler

 <?php wp_embed_register_handler( $id, $regex, $callback, $priority ); ?>

Вам также потребуется предоставить функцию обратного вызова, которая будет использоваться для генерации HTML-кода, необходимого для встраивания медиа.

Кодекс WordPress предоставляет пример того, как сделать это, чтобы встроить видео с веб-сайта Forbes:

 <?php

wp_embed_register_handler( 'forbes', '#http://(?:www|video)\.forbes\.com/(?:video/embed/embed\.html|embedvideo/)\?show=([\d]+)&format=frame&height=([\d]+)&width=([\d]+)&video=(.+?)($|&)#i', 'wp_embed_handler_forbes' );

function wp_embed_handler_forbes( $matches, $attr, $url, $rawattr ) {

    $embed = sprintf(
            '<iframe src="http://www.forbes.com/video/embed/embed.html?show=%1$s&format=frame&height=%2$s&width=%3$s&video=%4$s&mode=render" width="%3$spx" height="%2$spx" frameborder="0" scrolling="no" marginwidth="0" marginheight="0"></iframe>',
            esc_attr($matches[1]),
            esc_attr($matches[2]),
            esc_attr($matches[3]),
            esc_attr($matches[4])
            );

    return apply_filters( 'embed_forbes', $embed, $matches, $attr, $url, $rawattr );
}

?>

Если вам нужно сделать это для вашего сайта, лучше проконсультироваться и нанять разработчика WordPress, просто чтобы убедиться, что вы не вносите ошибок, которые могут сломать ваш сайт.

WordPress как провайдер oEmbed (начиная с WordPress версии 4.4)

До сих пор мы только обсуждали WordPress как потребителя медиа со сторонних сайтов, в действительности WordPress был потребителем oEmbed.

Начиная с 4.4 WordPress также может выступать в качестве провайдера контента oEmbed .

Это означает, что любые общедоступные посты или типы постов на вашем сайте могут быть встроены в сторонние веб-сайты через ваш собственный веб-сайт WordPress (обычно через их довольно постоянный URL-адрес с добавлением вставки в конец фактического URL-адреса — example.com/ ваш-пост / вставлять /).

По соображениям безопасности встраивания размещаются в изолированном iFrame, однако содержимое iFrame представляет собой шаблон, который можно стилизовать или полностью заменить темой на сайте поставщика.

Функции и крючки для использования встраивания

Вот четыре наиболее полезные функции, связанные с встраиванием:

• get_post_embed_url () — Извлекает URL для встраивания определенной записи в iframe, например https://make.wordpress.org/core/2015/10/28/new-embeds-feature-in-wordpress-4-4/embed /
• get_post_embed_html () — извлекает полный код встраивания для определенного сообщения
• get_oembed_endpoint_url () — извлекает URL-адрес конечной точки oEmbed для заданной постоянной ссылки, например https://make.wordpress.org/core/?oembed=true&url= . Это используется для добавления ссылок открытия oEmbed в HTML для отдельных сообщений.
• get_oembed_response_data () — Извлекает данные ответа oEmbed для данного сообщения в соответствии со спецификацией oEmbed.

Настройка вывода oEmbed

Подобно настройке любого файла шаблона, шаблон для встраивания из сообщения можно стилизовать с помощью embed_head и embed_footer, чтобы добавить собственный код в начало и конец шаблона встраивания.

Заголовок X-WP-embed: true также будет отправлен при использовании этого шаблона. Это облегчает нацеливание встроенных сообщений в любом приложении, которое использует WordPress oEmbeds.

Резюме

Как мы видели в этой статье, возможности встраивания WordPress довольно обширны. Как для писателя, так и для разработчика, существует множество способов, с помощью которых встраивания WordPress можно использовать для улучшения контента с помощью встроенных носителей.

Вы использовали встраивание WordPress любым творческим способом? Мы будем рады увидеть и поделиться вашими примерами.