[embed] Шорткод в WordPress

Шорткод [embed] позволяет встроить указанные URL, так чтобы задать им нужные ширину и высоту.

За обработку этого шорткода отвечает метод WP_Embed::shortcode().

По дефолту:

  • Ширина равна $GLOBALS['content_width'] или 500.
  • Высота равна min( ceil( $width * 1.5 ), 1000 ) от ширины.

Подробнее см. wp_embed_defaults()

Этот шорткод включается только после того, как первый раз срабатывает фильтр the_content. Если нужно запустить этот шорткод ДО или БЕЗ Цикла WordPress и вы не используете the_content(), вам нужно вызвать следующий метод и передать в него контент где находится [embed]:

$GLOBALS['wp_embed']->run_shortcode( 'Content with [embed] shortcode' );

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

[embed width="123" height="456"]URL[/embed]

Параметры

$width(число)
Ширина iframe.
По умолчанию: $GLOBALS['content_width'] или 500
$height(число)
Высота iframe.
По умолчанию: min( ceil( 1.5 $width ), 1000 )
$src(строка)
URL когда шорткод используется не как контентный.
По умолчанию: ''
$discover(true/false)
$attr['discover'] параметр для фукнции wp_oembed_get( $url, $attr ).
По умолчанию: apply_filters( 'embed_oembed_discover', true )

Примеры

#1 Встроим YouTube видео

[embed width="500" height="300"]https://youtu.be/SRWrQMwGYsQ[/embed]