Плеер на странице: {player}, блок и [video]

1. Поле «Видео» и тег {player}

Поле. В Админке → Доп. поля заведите поле вида «Видео» (или «Видео» у раздела). В форме записи оно выглядит строкой: вставьте ссылку YouTube, Vimeo, Rutube, VK Видео или Dailymotion — под полем появится «Распознано». Либо нажмите «Загрузить с компьютера» (mp4, webm): файл сам попадёт в «Медиа», а в поле встанет media:N. Либо выберите ролик из «Медиа» или сериал (series:N). Значение поля — одна строка: https://…, media:N или series:N.

Теги записи (страница записи, страница раздела, темы на тегах):

• {player} — плеер первого поля «Видео» записи (пусто, если не заполнено: блок [if:player]…[/if] прячется);
• {player:имя} — плеер названного поля «Видео»;
• {player.s}, {player.m}, {player.l}, {player.full} — то же заданного размера;
• {player.muted} — запуск без звука, когда плеер на виду.

В PHP-видах: <?= $this->player($значениеПоля, ['size' => 'l', 'autoplay' => 'muted', 'start' => 30, 'ads' => 'no']) ?>. В любых других местах (форум, страницы, блоки на главной и в колонках) — блок {block:player.video url=…|id=…|series=…}, он описан ниже. Если поле пустое, тег ничего не рисует: пустой блок и пустой отступ не остаются.

2. Блок {block:player.video} — плеер в любом месте

Блок ставится в файл тегов любого вида и в «Места» панели: на главную, в боковую колонку, в подвал, на страницу форума. Источник задают одним параметром:

• id=N — ролик из «Медиа» (номер виден в списке «Медиа»);
• series=N — подборка серий (сериал): плеер сам переключает серии;
• url=… — ссылка на ролик сервиса. Ссылку с символами ? и & берите в кавычки: url="https://www.youtube.com/watch?v=…".

Примеры:

{block:player.video id=5}
{block:player.video url="https://vimeo.com/76979871" size=s}
{block:player.video series=3 size=l autoplay=muted}

Если ничего из трёх не задано, ролика нет или ссылка не из разрешённых — блок ничего не рисует: на странице не остаётся ни пустой рамки, ни сломанной вставки.

3. Параметры плеера

Параметры работают в блоке {block:player.video …} и в PHP-виде; в тегах записи размер и запуск без звука задаются окончанием ({player.m}, {player.muted}).

• size — ширина: s (малый, до 20 rem), m (средний, до 36 rem), l (большой, до 52 rem), full (на всю колонку, по умолчанию; wide — то же самое).
• autoplay — off (по умолчанию: включается по нажатию) или muted: плеер запускается сам, без звука, когда блок наполовину на виду. Не запускается у посетителей с включённой экономией трафика и с настройкой «уменьшить движение» — им остаётся обычное нажатие.
• start — с какой секунды начать, число от 0 до 86400.
• ads — no (или 0): в этом плеере рекламу не показывать; yes (по умолчанию) — как задано в настройках рекламы.

4. Метка [video] в тексте

В тексте записи, страницы и сообщения плеер ставится меткой, без шаблонов:

• [video]https://youtu.be/…[/video] — ссылка на ролик сервиса; то же делает просто ссылка на отдельной строке;
• [video id=N] — ролик из «Медиа»; [video series=N] и [video series=N ep=M] — подборка (с серии M).

Что разрешено посетителям. Номер из «Медиа» и подборка разбираются только в тексте владельца и персонала: иначе любой, перебирая номера, узнал бы, какие ролики лежат в библиотеке. В форуме и комментариях посетитель может поставить только ссылку на ролик сервиса: переключатель «Разрешить видео в сообщениях» в настройках форума включает это, а «Видео в одном сообщении, не больше» ограничивает число плееров (остальные ссылки остаются ссылками). Выключено — ссылка в сообщении остаётся обычной ссылкой.

5. Если плеер не появился

• ссылка не узнана: поддерживаются YouTube, Vimeo, Rutube, VK Видео, Dailymotion и сервисы из настроек плеера, всё остальное остаётся обычной ссылкой;
• ролика с таким номером нет в «Медиа» или он закрыт для этого посетителя;
• в блоке не указан ни id, ни series, ни url;
• модуль «Видеоплеер» выключен: видео играет обычным плеером браузера, без наших кнопок и рекламы (блок {block:player.video} в этом случае недоступен, а {player} и [video] работают).