Video Element
RuTube, VK и Kinescope в элементах YOOtheme
Video Element добавляет внешние платформы в штатные видеополя и медиа YOOtheme. Ролики можно размещать в Video, Grid и Gallery, открывать в lightbox и просматривать прямо в Builder.
Для вставки достаточно ссылки на видео. Оформление и поведение плеера настраиваются в Builder, без ручного iframe-кода.

Внешнее видео с настройками Builder
Постер, заголовок и режим загрузки задаются рядом с источником. Видео запускается в блоке страницы или в модальном окне; параметры воспроизведения применяются в пределах возможностей платформы.
Общий сервис согласия для внешних платформ
RuTube, VK, Kinescope и другие дополнительные платформы подключаются к External Video Content в YOOtheme Scripts. При настроенном сервисе плеер ждёт разрешения посетителя и выгружается после его отзыва.
Загрузка сразу, при прокрутке или по клику
Основной ролик можно загрузить сразу, видео ниже по странице — при появлении на экране. Для обзора продукта или записи выступления подходит запуск по клику: в блоке страницы либо в модальном окне.

Eager
Плеер загружается сразу. Режим подходит для основного ролика, который должен быть готов к просмотру при открытии страницы.
Lazy
Плеер загружается при первом появлении элемента на экране. При дальнейшей прокрутке iframe остаётся загруженным и сохраняет позицию. Отзыв согласия выгружает внешний плеер.
On Click
До клика виден постер или штатная заглушка. После нажатия плеер появляется на его месте.
On Click to Modal
Нажатие на постер открывает видео в UIkit Modal. Размеры и пропорции модального плеера настраиваются отдельно от блока страницы.
Два способа запуска по клику
Первый ролик открывается на месте постера, второй — в модальном окне. Обе демонстрации используют один внешний источник. Если для него требуется согласие, сначала нужно разрешить сервис в YOOtheme Preferences.
Загрузка в контейнере

Запустить видео в контейнере
Запустить видео в контейнере
Необходимо разрешение на загрузку внешних скриптов
Управление CookiesЗагрузка в модальном окне

Открыть видео в модальном окне
Открыть видео в модальном окне
Необходимо разрешение на загрузку внешних скриптов
Управление CookiesИз чего складывается видеоблок
Источник, размеры и режим загрузки задаются независимо. Один ролик можно разместить в тексте страницы или открыть отдельно, сохранив собственные настройки постера и заголовка.
Источник
Файл воспроизводится встроенным плеером браузера. Для внешней ссылки используется плеер выбранной платформы.
Размеры и пропорции
Width, Height и Ratio задают размеры и пропорции. Если Ratio некорректен, применяется 16:9; для YouTube Shorts — 9:16.
Загрузка
Eager и Lazy размещают плеер в блоке страницы. On Click создаёт его после нажатия, On Click to Modal — при открытии диалога.
Согласие посетителя
При настроенном сервисе согласия внешний плеер ждёт разрешения посетителя. Отзыв разрешения выгружает iframe и возвращает заглушку.
Внешние платформы в штатных элементах YOOtheme
Video Element также добавляет внешние платформы в штатные видеополя и медиа YOOtheme: Section, Column, Panel, Grid, Gallery, Overlay, Slideshow и связанные варианты Slider. В Grid и Gallery ролик можно открыть через lightbox; внешнее видео доступно и в модальном окне Image.
Поддерживаемые ссылки получают предпросмотр в Builder. YouTube и Vimeo сохраняют штатную обработку YOOtheme. Произвольный код в HTML и Editor расширение не меняет.
Настройки Video Element в Builder
Справочник повторяет вкладки Content, Settings и Advanced. У каждого поля указаны результат, допустимые значения и условия доступности.
Video | Видеофайл или ссылка на поддерживаемую платформу. Поле поддерживает динамический источник. |
Width / Height | Размер проигрывателя. Если оба значения пусты, используется базовая ширина 720 px. |
Ratio | Формат |
Loading | Eager — по умолчанию (пустое значение). Остальные значения: |
Modal Width / Height | Показываются только для |
Poster Frame | Необязательное изображение до запуска видео. Доступно во всех режимах при заполненном Video; поддерживает динамический источник. |
Poster Frame Focal Point | Девять позиций кадрирования от top-left до bottom-right. Доступно при заполненных Video и Poster Frame. |
Modal Ratio | Ratio модального проигрывателя; показывается для |
Icon | Иконка триггера для |
Video Title | Название видео. В Eager и Lazy выводится над или под плеером, в On Click и Modal — поверх постера. Поддерживает динамический источник. |
Title Position | По умолчанию |
Show controls | По умолчанию включено. Поле доступно для всех платформ. У локального видео показывает кнопки плеера браузера; внешний плеер применяет параметр только при его поддержке. Ограничения платформ приведены ниже. |
Loop video | Зацикливает локальное видео; у внешнего плеера работает при поддержке Loop. Поле остаётся доступным для iframe. Для RuTube, VK Video, VK Спорт, OK Video и Dzen повтор переключателем Builder не заявлен. |
Mute video | Отключает звук локального видео и передаёт соответствующий параметр поддерживаемому внешнему плееру. Поле доступно для iframe; для Dzen используются параметры исходной ссылки. |
Play inline on mobile devices | Включает воспроизведение локального видео в блоке страницы на телефоне (playsinline). Поле остаётся доступным для внешних источников; поведение стороннего iframe определяется провайдером. |
Autoplay | Off — по умолчанию, On или Inview. Поле активно при заполненном Video. Inview ждёт появления элемента в viewport, в том числе после разрешения сервиса. Autoplay со звуком может блокироваться браузером; ограничения внешних плееров приведены ниже. |
Box Shadow | Доступны None, |
Box Decoration | Доступны None, |
Inverse style | Доступно только для decoration |
Height — Fill the available column space | Растягивает локальное видео по доступной высоте колонки. Недоступно для iframe. |
Force viewport height | Задаёт высоту локального видео относительно экрана; недоступно при включённом Height expand. |
Style | По умолчанию |
Text Color | Доступны None, |
Text Hover Color | Цвет заголовка при hover/focus для click/modal; доступен при заполненном Video Title. |
Transition | По умолчанию |
HTML Element | По умолчанию |
Icon Color | По умолчанию |
Icon Hover Color | По умолчанию |
Loading — Load image eagerly | Poster по умолчанию lazy. Переключатель включает eager для poster в первом viewport. |
Image Transition | None, |
Position | Normal flow, |
Left / Right / Top / Bottom | Отступы для relative/absolute. Противоположные стороны взаимоисключаются. |
Z Index | Уровень наложения 0–3 или Auto при заданной Position. |
Blend | Смешивает элемент с содержимым страницы штатным режимом Builder. |
Margin Top / Bottom | По умолчанию |
Max Width | Small–2X-Large; ограничивает ширину элемента. |
Max Width Breakpoint | Breakpoint |
Block Alignment / Breakpoint / Fallback | Left, center или right с breakpoint и резервным значением; доступны при Max Width вне абсолютном позиционировании. |
Text Alignment / Breakpoint / Fallback | Left, center или right с отдельным breakpoint и резервным значением. |
Animation | Штатные Fade, Scale, Slide или Parallax; требует включённых анимаций Section. |
Parallax | Открывает штатную панель transform, opacity, blur, easing, target, breakpoint и start/end. |
Visibility | Показывает или скрывает элемент относительно breakpoint |
Section/Row — Remove left or right padding | Убирает внутренний отступ со стороны расширяющейся Section/Row; недоступно при абсолютном позиционировании. |
Name | Подпись узла в структуре Builder; на странице не выводится. |
Status | Штатное включение и отключение элемента. |
Source / Condition / Value / Show Empty | Динамический источник для поддерживаемых полей. Condition и Value задают условие вывода; Show Empty разрешает вывод при пустом значении и отключает условие. Source mappings страницы сохраняются при обновлении расширения. |
ID | Пользовательский ID корневого элемента. Если поле пустое, элемент создаёт уникальный |
Classes | Дополнительные CSS-классы корневого элемента. |
Attributes | Дополнительные HTML-атрибуты, по одному на строку. |
CSS | CSS элемента. В поле доступны подсказки для |
Transform | Штатные transform-настройки Builder для элемента. |
Consent Manager — окно разрешений на сайте
Consent Manager — встроенный в YOOtheme баннер и окно настроек Cookies. В нём посетитель выбирает, каким внешним сервисам разрешить загрузку на сайте: например, видеоплатформе или счётчику статистики.
Внешний плеер обращается к серверам видеоплатформы при загрузке. При настройке согласия optin Video Element показывает заглушку вместо плеера и ждёт разрешения посетителя.

Что видно в окне
В окне «Настройки Cookies» показаны раскрывающиеся категории. Внутри них — подключённые сервисы с переключателями. Посетитель может принять всё, отклонить всё или сохранить свой выбор. Обязательные сервисы отключить нельзя. Оформление и список сервисов зависят от настроек сайта.
Как разрешить видео
Кнопка на заглушке открывает настройки Cookies. Посетитель раскрывает категорию с нужным видеосервисом, разрешает его и сохраняет выбор. В примере MSGru это «Функциональные» → «Видео с внешних платформ». В режимах On Click и Modal для запуска затем нужно нажать Play.
Управление с клавиатуры
В режимах On Click и Modal кнопка запуска доступна с клавиатуры. Video Title задаёт доступное имя видео; у внешнего iframe оно выводится в атрибуте title.
Отзыв согласия
При отзыве разрешения внешний плеер выгружается. Вместо него снова появляется заглушка Consent Manager.
Пропорции и кадрирование
Width, Height и Ratio задают размеры видеоблока. Для YouTube Shorts без корректного Ratio применяется 9:16. Фокусная точка постера помогает сохранить выбранную область при кадрировании.
Анимация и автозапуск
Переходы постера и заголовка настраиваются в Builder. Автозапуск со звуком может блокироваться браузером; запуск без звука также зависит от его политики.
Поддержка параметров зависит от плеера
Внешние платформы поддерживают разный набор параметров. Переключатель в Builder меняет поведение плеера только тогда, когда сервис принимает соответствующую настройку.
Kinescope | Autoplay, Mute, Loop и Controls передаются плееру. Принимаются обычные ссылки и адреса /embed/; iframe получает разрешения для fullscreen, Picture-in-Picture и DRM. Возможность просмотра определяется доступом к ролику. |
Cloudflare Stream | Поддерживаются Autoplay, Mute, Loop и Controls. При выключенном Autoplay параметр удаляется из URL. |
Yandex Cloud Video | Поддерживаются Autoplay, Mute, Loop и Controls; выключение Controls передаётся как hidden. |
RuTube | Передаются Autoplay и Mute (autostartmute). Передача Loop и Controls не поддерживается. |
VK Video / VK Спорт, OK Video | Передаются Autoplay и Mute. Передача Loop и Controls не поддерживается. Ссылки vksport.vkvideo.ru преобразуются в стандартный VK iframe. Применение параметров зависит от сервиса и доступа к ролику. |
Dzen | Используются параметры исходной ссылки плеера. Управление Autoplay, Mute, Loop и Controls переключателями Builder не заявлено. |
YouTube / Vimeo | Используются штатные сервисы согласия YOOtheme. Параметры воспроизведения зависят от плеера и браузера. |
В штатных элементах режимы Hover и Inview останавливают внешнее видео выгрузкой iframe. При следующем запуске ролик начинается заново. Lazy сохраняет загруженный iframe при прокрутке. Restart и управление YouTube/Vimeo работают средствами YOOtheme.
Для дополнительных платформ сервис External Video Content нужно настроить в YOOtheme Scripts. Без него блокировка по согласию в Video Element не применяется; с ним действует политика optin, optout или none, выбранная в YOOtheme.
Кадрирование применяется к файлу видео и постеру. Управлять кадрированием содержимого стороннего iframe элемент не гарантирует.
Загрузки
PHP 8.3.0, Joomla 6 и YOOtheme Pro 5.0.43. Рекомендуемое окружение — PHP 8.4.
Системные требования
Минимальные
PHP | 7.4+ |
Joomla! | 5 |
YOOtheme Pro | 5 |
Рекомендуемые
PHP | 8.3+ |
Joomla! | 6 |
YOOtheme Pro | 5 |
Joomla получает уведомления об обновлениях через сервер MSGru, если на сайте включена проверка обновлений.
Поддержать разработку
Список изменений
Лицензия
-
Скачивание без ограничений
-
Использование на любом количестве сайтов
-
Помощь в установке и настройке
-
Техническая поддержка
-
Исправление проблем совместимости со сторонними расширениями и библиотеками
-
Доработка функционала под конкретные требования заказчика

