Плеєр на сторінці: {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] працюють).