WP_VIDEO_SHORTCODE() – Как использовать функцию wp_video_shortcode() для вставки видео в WordPress

# WP_VIDEO_SHORTCODE() │ WP 3.6.0

Функция wp_video_shortcode() позволяет выводить HTML-код для видео на основе указанной ссылки и других параметров. Эта функция необходима для работы шорткода , который используется для отображения и воспроизведения видеофайлов в записях. Размер видеоплеера зависит от глобальной переменной темы $content_width (ширина шаблона), но его можно также задать вручную с помощью параметров шорткода.

**Поддерживаемые форматы видео в WordPress:** mp4, m4v, webm, ogv, wmv, flv.

## Примеры вставки видео в пост

### Метод 1

Вы можете вставить ссылку на видео (URL на одной строке) в содержимое поста:

http://my.movies.com/cool/movie/coolest.mov

### Метод 2

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

### Метод 3

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

### Метод 4

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

## Возврат

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

## Шаблон использования функции

```php
echo wp_video_shortcode( [
    'src'      => '',
    'poster'   => '',
    'loop'     => '',
    'autoplay' => '',
    'preload'  => 'metadata',
    'height'   => 360,
    'width'    => empty( $content_width ) ? 640 : $content_width,
    'class'    => '', // атрибут 'class' для элемента 

Использование функции

wp_video_shortcode( $attr, $content );

Параметры

$attr (array) (обязательный)

Атрибуты шорткода.

• src (string)
  URL к видеофайлу. Если не указан, будет использован первый видеофайл, прикрепленный к посту. Используйте следующие значения для конкретного типа файла: mp4, m4v, webm, ogv, wmv, flv.

  По умолчанию: первый видеофайл, прикрепленный к посту.

• poster (string)
  Ссылка на изображение, которое будет отображаться до начала воспроизведения видео.

• loop (string)
  Нужно ли зацикливать воспроизведение видео? Если включено, видео будет воспроизводиться заново после окончания.

  По умолчанию: 'off'.

• autoplay (string)
  Автоматически воспроизводить видео после загрузки страницы.

  По умолчанию: 'off' (видео не воспроизводится).

• preload (string)
  Указывает, как загружать видео при загрузке страницы. Может быть:

  • metadata — загружать только метаданные. По умолчанию.
  • none — ничего не загружать.
  • auto — полностью загружать видео при загрузке страницы.

  По умолчанию: 'metadata'.

• height (int)
  Определяет высоту видеоплеера. Значение автоматически рассчитывается сразу после загрузки файла.

  По умолчанию: высота видео.

• width (int)
  Ширина видеоплеера. Значение также рассчитывается автоматически.

  По умолчанию: ширина видео.

• $class (string)
  Атрибут класса для элемента

  По умолчанию: 'wp-video-shortcode'.

Примеры

Вывод видео на определенной странице

Допустим, нужно вывести видео (подобно шорткоду ):

echo wp_video_shortcode( [
    'src'      => 'http://example.com/video/champion-2009.flv',
    'poster'   => 'http://example.com/img/champion-2009.jpg',
    'height'   => 400,
    'width'    => 600,
] );

В результате получаем следующий код:

Заметки

• Глобальная. Целое число. $content_width.

Изменения

С версии 3.6.0 — введено.