Видео UNI

Видео UNI — самостоятельное поле InstantCMS для прямых ссылок на ролики и подборок из каналов. Оно выводит ролики аккуратной сеткой или мозаикой, сохраняет обложки YouTube и VK Видео на вашем сайте и загружает их проигрыватель только после нажатия на кнопку воспроизведения.

Пять видеосервисов в одном поле

Поддерживаются прямые ссылки на YouTube, VK Видео, Rutube, Vimeo и OK. Неподдерживаемый адрес не выполняется как HTML-код: поле выводит безопасное сообщение вместо потенциально опасной вставки.

Обложка вместо тяжёлого проигрывателя

Для роликов YouTube и VK Видео до нажатия посетитель видит локальную обложку и кнопку воспроизведения. Проигрыватель создаётся только по клику. Ролики Rutube, Vimeo и OK выводятся штатным проигрывателем сервиса. Это сокращает число внешних iframe при первоначальной загрузке страницы и сохраняет привычный сценарий просмотра.

Для YouTube и VK Видео обложки можно хранить в upload/uni_video. Если серверный хостинг не может подключиться к сервису обложек YouTube, авторизованный браузер редактора получает официальный JPEG и безопасно передаёт его на сайт. Изображение проверяется по формату и размеру и заново кодируется в JPEG.

Видео из каналов

Поле принимает ссылки на каналы YouTube и VK Видео и добавляет последние ролики в подборку. Прямые ссылки занимают места первыми, ролики канала заполняют оставшиеся позиции до общего лимита.

Для импорта из канала YouTube нужен ключ YouTube Data API. Для канала VK Видео достаточно сервисного ключа приложения VK ID: если раздел «Видео» канала недоступен, поле берёт ролики из последних постов стены, включая репосты. Если импорт не удался, редактор видит понятную причину и диагностику ответа VK, сам ключ нигде не показывается. Прямые ссылки на отдельные ролики работают без API-ключей.

Штатная задача планировщика обновляет кеш каналов и небольшими порциями повторяет получение отсутствующих обложек. Публичный просмотр страницы не запускает внешние серверные запросы.

Сетка или мозаика

Сетка — одинаковые плитки 16:9 в одну, две или три колонки. Мозаика — выровненные ряды, как в фотогалереях: Shorts, клипы VK и обычные ролики показываются в своих пропорциях и стоят в одном ряду без пустот, каждый ряд занимает ровно ширину блока. Проигрыватель открывается в той же рамке, вертикальный ролик остаётся вертикальным.

Настройки поля

Для каждого экземпляра поля администратор задаёт:

• максимальное количество видео — от 1 до 10;
• раскладку — сетка или мозаика;
• одну, две или три колонки для сетки или высоту ряда для мозаики;
• скругление видеокарточек;
• локальное сохранение и очистку обложек;
• количество роликов из одного канала;
• автоматическое обновление каналов.

На узком экране сетка перестраивается в одну колонку, а ряды мозаики становятся ниже, чтобы в ряд помещалось несколько роликов.

Где можно использовать

• новости и статьи;
• обзоры товаров и сервисов;
• каталоги компаний и проектов;
• обучающие материалы;
• страницы мероприятий и курсов;
• любые собственные типы контента InstantCMS.

Установка

Загрузите ZIP через штатный раздел установки дополнений InstantCMS. После установки добавьте поле типа «Видео UNI» в нужный тип контента и настройте число роликов, раскладку, обложки и при необходимости доступ к API каналов. Рекомендуемое системное имя экземпляра — uni_video.

Требования и ограничения

• cURL требуется для серверной загрузки обложек и API каналов.
• GD требуется для проверки и безопасного перекодирования обложек, переданных браузером.
• Установка создаёт служебную таблицу кеша каналов и задачу планировщика.
• Ссылки на каналы поддерживаются для YouTube и VK Видео; для Rutube, Vimeo и OK поддерживаются прямые ссылки на ролики.
• Доступность обложек зависит от сетевого доступа сервера или браузера редактора к соответствующему видеосервису.
• Окончательное удаление файлов, служебной таблицы и задачи планировщика выполняется администратором вручную, поскольку InstantCMS 2.18.2 не исполняет uninstall.sql.

Поле устанавливается самостоятельно и не изменяет файлы ядра InstantCMS.