Шорткоды

Плагин 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

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

mp4

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

rutube

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

ok

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

mailru

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

vimeo

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

kinescope

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

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

title

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

title_tag

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

default

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

poster

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

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'.
По умолчанию: 'play'

show_titles

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

show_icons

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

show_partner

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

order

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

pseudo

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

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

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"]