Видео UNI

Видео UNI для InstantCMS

Встраивание роликов из разных сервисов часто требует отдельных полей и разной разметки. Если проигрыватели загружаются сразу, страница получает несколько тяжёлых iframe ещё до того, как посетитель решил смотреть видео.

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

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

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

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

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

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

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

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

Для импорта из канала YouTube нужен ключ YouTube Data API, для канала VK Видео — токен VK API. Прямые ссылки на отдельные ролики работают без API-ключей.

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

Настраиваемая сетка

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

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

На узком экране сетка автоматически перестраивается в одну колонку. Если в поле указан один ролик, он занимает всю доступную ширину.

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

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

Установка

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

Совместимость и требования

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