wp_oembed_get()
Вбудовує об’єкт з УРЛ. Намагається отримати 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()
WP_oEmbed::get_html()
Хуків немає.
Повертає
Строку|false. HTML код об’єкта, що вбудовується, або false, якщо не вдалося отримати html.
Використання
wp_oembed_get( $url, $args );
-
$url
(рядок) (обов’язковий) - УРЛ, який потрібно вбудувати, код якого потрібно отримати.
-
$args
(масив) -
Додаткові аргументи та параметри. Можливо:
Heightі
Width.
За замовчуванням: ”
Приклади
#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>
Примітка: якщо відео недоступне, УРЛ не буде оброблено.
#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>
нотатки
- Дивіться: WP_oEmbed
список змін
| З версії 2.9.0 | Введено. |
Код wp_oembed_get() wp oembed get WP 6.0.2
function wp_oembed_get( $url, $args = '' ) {
$oembed = _wp_oembed_get_object();
return $oembed->get_html( $url, $args );
}