Функция wp_video_shortcode() в WordPress

Функция wp_video_shortcode() отвечает за создание HTML-кода для вставки видео в записи WordPress. Она позволяет пользователям легко добавлять видеофайлы, поддерживаемые форматы которых включают mp4, m4v, webm, ogv, wmv и flv.

wp_video_shortcode( array $attr, string $content = '' ): string|void

Эта функция создает вывод шорткода video, позволяя отображать видео в постах. Параметры можно настроить для изменения внешнего вида и поведения видео.

Параметры функции

• $attr (array, обязательный): Массив атрибутов шорткода.
  • src (string): URL-адрес видеофайла. По умолчанию пусто.
  • height (int): Высота встраиваемого видео в пикселях. По умолчанию 360.
  • width (int): Ширина встраиваемого видео в пикселях. По умолчанию $content_width или 640.
  • poster (string): Параметр «poster» для элемента <video>. По умолчанию пусто.
  • loop (string): Параметр «loop» для элемента <video>. По умолчанию пусто.
  • autoplay (string): Параметр «autoplay» для элемента <video>. По умолчанию пусто.
  • muted (string): Параметр «muted» для элемента <video>. По умолчанию false.
  • preload (string): Параметр «preload» для элемента <video>. По умолчанию ‘metadata’.
  • class (string): Параметр «class» для элемента <video>. По умолчанию ‘wp-video-shortcode’.
• $content (string, необязательный): Содержимое шорткода. По умолчанию — пустая строка.

Возвращаемое значение

Функция возвращает HTML-код для отображения видео.

Пример использования функции

Вот пример, как можно использовать wp_video_shortcode() с полным набором параметров:

$attr = array(
    'src'      => 'http://example.com/videos/sample-video.mp4',
    'height'   => 360,
    'width'    => 640,
    'poster'   => 'http://example.com/images/video-poster.jpg',
    'loop'     => 'on',
    'autoplay' => 'off',
    'muted'    => 'true',
    'preload'  => 'auto',
    'class'    => 'custom-video-class',
);

$content = ''; // Контент

echo wp_video_shortcode( $attr, $content );

Как вставить видео в запись

В WordPress есть несколько способов вставки видео, используя стандартные методы:

Вариант 1: Вставка ссылки на видео

Можно просто вставить URL видео в отдельной строке:

http://my.example.com/videos/my-video.mp4

Вариант 2: Использование шорткода без параметров

Если у вас есть видеофайл, прикрепленный к записи, просто используйте шорткод:

Вариант 3: Использование шорткода с параметрами

Для вставки видео с определенной ссылки используйте шорткод с указанием источника:

Вариант 4: Использование нескольких форматов видео

Если у вас есть альтернативные форматы видео, можно использовать шорткод следующим образом:

Вызов функции

Функция wp_video_shortcode() также поддерживает несколько хуков, таких как:

• wp_video_shortcode_override
• wp_video_shortcode_library
• wp_video_shortcode_class
• wp_video_shortcode

Заключение

Используя функцию wp_video_shortcode(), вы можете легко добавлять и настраивать видео в ваших записях WordPress. Возможность задавать различные параметры позволяет вам полностью контролировать внешний вид и поведение видео, обеспечивая лучший пользовательский опыт.