wp_oembed_get() │ WP 2.9.0

Встраивает объект по УРЛ. Пытается получить HTML код из переданного УРЛ на основе поддерживаемых oEmbed WordPress.

Подробнее об oEmbed читайте: oEmbed в WordPress.

Эта функция не кэширует результат, чтобы его кэшировать используйте объект WP_Embed:

global $wp_embed;
echo $wp_embed->autoembed('https://www.youtube.com/watch?v=c6afCBCzLAY&t=2s');

/*
вернет:
<iframe width="600" height="338"
src="https://www.youtube.com/embed/c6afCBCzLAY?start=2&feature=oembed"
frameborder="0"
allow="autoplay; encrypted-media" allowfullscreen></iframe>
*/

Работает на основе класса WP_oEmbed.

Работает на основе: WP_oEmbed::get_html()

Хуков нет.

Возвращает

Строку|false. HTML код встраиваемого объекта или false, если не удалось получить html.

Использование

wp_oembed_get( $url, $args );
$url(cтрока) (обязательный)
УРЛ который нужно встроить, код которого нужно получить.
$args(массив)
Дополнительные аргументы и параметры. Может быть: Height и Width.
По умолчанию: ''

Примеры

0

#1 Встроим УРЛ поддерживаемый в WordPress oEmbed 

$embed_code = wp_oembed_get('http://www.youtube.com/watch?v=AbcDeFg123');

Вернет:

<iframe width="500" height="281" src="https://www.youtube.com/embed/AbcDeFg123?feature=oembed" frameborder="0" allowfullscreen></iframe>

Замета: если видео недоступно, то УРЛ не будет обработан.

0

#2 Встраивание с указанием параметров

Встроим YouTube видео и укажем ширину (width):

$embed_code = wp_oembed_get('http://www.youtube.com/watch?v=AbcDeFg123', array('width' => 400) );

Вернет:

<iframe width="400" height="225" src="http://www.youtube.com/embed/jr8ouxln3CE?feature=oembed" frameborder="0" allowfullscreen></iframe>

Заметки

Список изменений

С версии 2.9.0 Введена.

Код wp_oembed_get() WP 6.7.2

wp-includes/embed.php 
function wp_oembed_get( $url, $args = '' ) {
	$oembed = _wp_oembed_get_object();
	return $oembed->get_html( $url, $args );
}

WP Embeds (oEmbed) (встраивание URL в контент) (ответ WP на запрос встраивания)

Без рубрики