Шорткоды

Плагин OmniVideo использует шорткод для интеграции видео с различных платформ прямо в ваши страницы и записи WordPress.

У каждого атрибута есть значение по умолчанию, они все приведены ниже. На странице Настройки > OmniVideo можно переопределить значения по умолчанию у всех блоков.

Примеры работы плагина с шорткодами можно посмотреть на демо-сайте.

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

В большинстве случаев шорткод можно не закрывать, то есть вам не нужно писать [/omnivideo]:

[omnivideo title="Заголовок" youtube="https://youtu.be/1TelHiEIGwI" poster="auto"]

Если необходимо задать описание под заголовком, пропишите его в контенте шорткода:

[omnivideo youtube="https://youtu.be/1TelHiEIGwI" poster="auto"]Описание видео[/omnivideo]

Платформы

Для каждой платформы необходимо указать полную ссылку на видео, например:

youtube="https://youtu.be/1TelHiEIGwI"

youtube

Ссылка на видео YouTube.
По умолчанию: ''

vk

Ссылка на видео ВК.
⚠️ Если вы вставляете видео, доступное по ссылке, то для него необходимо получить отдельную ссылку для встраивания. Инструкция.
По умолчанию: ''

dzen

Ссылка на встраиваемое видео Яндекс.Дзен.
⚠️ Сейчас у Дзен самый сложный вариант, т.к. просто ссылка на видео не подходит. У Дзена ссылка для встраивания и обычная ссылка на видео отличаются. Инструкция.
По умолчанию: ''

rutube

Ссылка на видео RuTube.
По умолчанию: ''

vimeo

Ссылка на видео Vimeo.
По умолчанию: ''

ok

Ссылка на видео Одноклассники.
По умолчанию: ''

mailru

Ссылка на видео Mail.ru.
⚠️ Ссылка на видео mail.ru получается по аналогии с dzen. Инструкция
По умолчанию: ''

kinescope

Ссылка на видео Kinescope.
По умолчанию: ''

nuum ^1.1.0

Ссылка на Nuum
По умолчанию: ''

plvideo ^1.1.0

Ссылка на Платформу
По умолчанию: ''

yandex ^1.1.0

Ссылка на Yandex Cloud Video
По умолчанию: ''

sibnet ^1.1.0

Ссылка на Sibnet
По умолчанию: ''

videopress ^1.1.0

Ссылка на VideoPress
По умолчанию: ''

odysee ^1.2.0

Ссылка на Odysee.com.
По умолчанию: ''

mp4

Ссылка на MP4 видеофайл. Укажите ссылку на файл, который будет проигрываться в HTML5 плеере.
По умолчанию: ''

url ^1.1.0

Произвольная ссылка, которая будет встраиваться с помощью iframe
По умолчанию: ''

Настройки блока

title

Заголовок блока видео. Укажите текст заголовка, который будет отображаться над видео.
По умолчанию: ''

title_tag

HTML-тег для заголовка, который задается в атрибуте title.
Возможные значения: div, h2, h3, h4.
По умолчанию: div

default

Платформа по умолчанию, которая будет загружена при открытии страницы без клика и если не указан постер.
Возможные значения: youtube, vk, dzen, mp4, rutube, ok, mailru, vimeo, kinescope, nuum, plvideo, yandex, sibnet, videopress, url.
По умолчанию: ''

poster

Картинка-постер для видео. Укажите ссылку на изображение или значение auto для автоматического получения постера с платформы (работает только для YouTube и Vimeo).
По умолчанию: ''

alt ^1.1.0

Значение атрибута alt постера.
По умолчанию: ''

style

Стиль отображения блока видео.
Возможные значения: standard, simple, simple-2, simple, cover, sunset, pills.
По умолчанию: standard

icon

Иконка, отображаемая поверх постера.
Возможные значения: play, play-2, play-3, play-4.
Либо имя сервиса для соответствующей иконки: youtube, vk, dzen, mp4, rutube, ok, mailru, vimeo, kinescope, nuum, plvideo, yandex, sibnet, videopress, url.
По умолчанию: play

show_titles

Показывать названия платформ. Возможные значения: 1, 0.
По умолчанию: 1

show_icons

Показывать иконки платформ. Возможные значения: 1, 0.
По умолчанию: 1

show_ad ^1.2.0

Включить показ рекламы в данном блоке. Возможные значения: 1, 0.
По умолчанию: 1

show_partner

Показывать партерскую ссылку. Возможные значения: 1, 0.
Это не настоящая ссылка, она не забирает вес страницы и закрыта от индексации.
По умолчанию: 0

pseudo

Заменяет ссылки на псевдоэлементы (span). Это может быть полезно, если вы не хотите размещать внешние ссылки на видео-площадки на странице. Возможные значения: 1, 0.
По умолчанию: 0

order

Задайте порядок вывода платформ, перечислив их через запятую. Например, order="vk,dzen". В таком случае первыми будут ВК и Дзен, а остальные заполнятся автоматически.
По умолчанию: ''

ratio ^1.1.0

Cоотношение сторон видео блока. Доступны значения
16-9 (для горизонтальных видео)
9-16 (для вертикальных видео)
1-1 (квадратное видео)
4-3 (классический формат)
21-9 (cinematic format)
4-5 (вертикальные посты)
По умолчанию: 16-9

description_position ^1.1.0

Положение описания в блоке. Доступны значения
top – вывод сверху
bottom – вывод снизу
По умолчанию: top

Примеры использования

1. Стандартное использование:

[omnivideo title="Обзор продукта" youtube="https://youtu.be/1TelHiEIGwI" poster="auto" style="standard"]

2. Встраивание видео с ВК и кастомная иконка:

[omnivideo vk="https://vk.com/video-137277177_456239073" icon="play-2" style="simple-1"]

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

[omnivideo mp4="https://example.com/video.mp4" poster="https://example.com/poster.jpg" style="cover"]