Перейти к содержимому

Video Element

Добавляйте native video и внешние платформы через один Builder element: четыре режима загрузки, poster, Modal, overlay и consent через YOOtheme Preferences.
Joomla! 5/6
YOOtheme Pro 5
PHP 7.4+

RuTube, VK и Kinescope в элементах YOOtheme

Video Element добавляет внешние платформы в штатные видеополя и медиа YOOtheme. Ролики можно размещать в Video, Grid и Gallery, открывать в lightbox и просматривать прямо в Builder.

Для вставки достаточно ссылки на видео. Оформление и поведение плеера настраиваются в Builder, без ручного iframe-кода.

Видео упаковочной линии в модальном окне YOOtheme с внешней кнопкой закрытия и затемнённой размытой страницей

Внешнее видео с настройками Builder

Постер, заголовок и режим загрузки задаются рядом с источником. Видео запускается в блоке страницы или в модальном окне; параметры воспроизведения применяются в пределах возможностей платформы.

Общий сервис согласия для внешних платформ

RuTube, VK, Kinescope и другие дополнительные платформы подключаются к External Video Content в YOOtheme Scripts. При настроенном сервисе плеер ждёт разрешения посетителя и выгружается после его отзыва.

Загрузка сразу, при прокрутке или по клику

Основной ролик можно загрузить сразу, видео ниже по странице — при появлении на экране. Для обзора продукта или записи выступления подходит запуск по клику: в блоке страницы либо в модальном окне.

Постер открытого урока на сайте курса предметной фотографии с кнопкой запуска

Eager

Плеер загружается сразу. Режим подходит для основного ролика, который должен быть готов к просмотру при открытии страницы.

Lazy

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

On Click

До клика виден постер или штатная заглушка. После нажатия плеер появляется на его месте.

On Click to Modal

Нажатие на постер открывает видео в UIkit Modal. Размеры и пропорции модального плеера настраиваются отдельно от блока страницы.

Два способа запуска по клику

Первый ролик открывается на месте постера, второй — в модальном окне. Обе демонстрации используют один внешний источник. Если для него требуется согласие, сначала нужно разрешить сервис в YOOtheme Preferences.

Загрузка в контейнере

Запустить видео в контейнере

Запустить видео в контейнере

Запустить видео в контейнере

Загрузка в модальном окне

Открыть видео в модальном окне

Открыть видео в модальном окне

Открыть видео в модальном окне

Из чего складывается видеоблок

Источник, размеры и режим загрузки задаются независимо. Один ролик можно разместить в тексте страницы или открыть отдельно, сохранив собственные настройки постера и заголовка.

Источник

Файл воспроизводится встроенным плеером браузера. Для внешней ссылки используется плеер выбранной платформы.

Размеры и пропорции

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. У каждого поля указаны результат, допустимые значения и условия доступности.

Content

Video
video

Видеофайл или ссылка на поддерживаемую платформу. Поле поддерживает динамический источник.

Width / Height
video_width / video_height

Размер проигрывателя. Если оба значения пусты, используется базовая ширина 720 px.

Ratio
video_ratio

Формат 16:9 или 9:16; недоступен при заполненной Height. Ошибочное или нулевое значение заменяется резервным значением.

Loading
video_loading

Eager — по умолчанию (пустое значение). Остальные значения: lazy, click и modal.

Modal Width / Height
modal_width / modal_height

Показываются только для modal. Если оба значения пусты, используется ширина 1280 px.

Poster Frame
poster

Необязательное изображение до запуска видео. Доступно во всех режимах при заполненном Video; поддерживает динамический источник.

Poster Frame Focal Point
poster_focal_point

Девять позиций кадрирования от top-left до bottom-right. Доступно при заполненных Video и Poster Frame.

Modal Ratio
modal_ratio

Ratio модального проигрывателя; показывается для modal и недоступен при заданной Modal Height.

Icon
icon

Иконка триггера для click и modal.

Video Title
video_title

Название видео. В Eager и Lazy выводится над или под плеером, в On Click и Modal — поверх постера. Поддерживает динамический источник.

Title Position
title_position

По умолчанию bottom; доступны top и bottom. Показывается при заполненном Video Title.

Show controls
video_controls

По умолчанию включено. Поле доступно для всех платформ. У локального видео показывает кнопки плеера браузера; внешний плеер применяет параметр только при его поддержке. Ограничения платформ приведены ниже.

Loop video
video_loop

Зацикливает локальное видео; у внешнего плеера работает при поддержке Loop. Поле остаётся доступным для iframe. Для RuTube, VK Video, VK Спорт, OK Video и Dzen повтор переключателем Builder не заявлен.

Mute video
video_muted

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

Play inline on mobile devices
video_playsinline

Включает воспроизведение локального видео в блоке страницы на телефоне (playsinline). Поле остаётся доступным для внешних источников; поведение стороннего iframe определяется провайдером.

Autoplay
video_autoplay

Off — по умолчанию, On или Inview. Поле активно при заполненном Video. Inview ждёт появления элемента в viewport, в том числе после разрешения сервиса. Autoplay со звуком может блокироваться браузером; ограничения внешних плееров приведены ниже.

Settings — Video

Box Shadow
video_box_shadow

Доступны None, small, medium, large и xlarge.

Box Decoration
video_box_decoration

Доступны None, default, primary, secondary, shadow и mask.

Inverse style
video_box_decoration_inverse

Доступно только для decoration default, primary и secondary.

Height — Fill the available column space
height_expand

Растягивает локальное видео по доступной высоте колонки. Недоступно для iframe.

Force viewport height
video_viewport_height

Задаёт высоту локального видео относительно экрана; недоступно при включённом Height expand.

Settings — Overlay

Style
overlay_style

По умолчанию overlay-default. Доступны None, overlay-default/primary и tile-default/muted/primary/secondary; только для click/modal.

Text Color
text_color

Доступны None, light, dark и hidden.

Text Hover Color
text_hover_color

Цвет заголовка при hover/focus для click/modal; доступен при заполненном Video Title.

Transition
title_transition

По умолчанию fade; Scale и Slide варианты. Доступно при Video Title в click/modal.

HTML Element
title_element

По умолчанию div; доступны h1–h6 и div. Активно при Video Title.

Icon Color
icon_color

По умолчанию light; доступны light и dark. Активно при выбранной Icon.

Icon Hover Color
icon_hover_color

По умолчанию light; задаёт второй цвет иконки при hover/focus.

Loading — Load image eagerly
image_loading

Poster по умолчанию lazy. Переключатель включает eager для poster в первом viewport.

Image Transition
image_transition

None, scale-up или scale-down. Доступно при Poster в поддерживаемом режиме.

Settings — General

Position
position

Normal flow, relative или absolute.

Left / Right / Top / Bottom
position_left / position_right / position_top / position_bottom

Отступы для relative/absolute. Противоположные стороны взаимоисключаются.

Z Index
position_z_index

Уровень наложения 0–3 или Auto при заданной Position.

Blend
blend

Смешивает элемент с содержимым страницы штатным режимом Builder.

Margin Top / Bottom
margin_top / margin_bottom

По умолчанию default; доступны xsmall–xlarge, remove и auto. Недоступно при абсолютном позиционировании.

Max Width
maxwidth

Small–2X-Large; ограничивает ширину элемента.

Max Width Breakpoint
maxwidth_breakpoint

Breakpoint s–xl, от которого применяется Max Width.

Block Alignment / Breakpoint / Fallback
block_align / block_align_breakpoint / block_align_fallback

Left, center или right с breakpoint и резервным значением; доступны при Max Width вне абсолютном позиционировании.

Text Alignment / Breakpoint / Fallback
text_align / text_align_breakpoint / text_align_fallback

Left, center или right с отдельным breakpoint и резервным значением.

Animation
animation

Штатные Fade, Scale, Slide или Parallax; требует включённых анимаций Section.

Parallax
_parallax_button

Открывает штатную панель transform, opacity, blur, easing, target, breakpoint и start/end.

Visibility
visibility

Показывает или скрывает элемент относительно breakpoint s–xl.

Section/Row — Remove left or right padding
container_padding_remove

Убирает внутренний отступ со стороны расширяющейся Section/Row; недоступно при абсолютном позиционировании.

Advanced

Name
name

Подпись узла в структуре Builder; на странице не выводится.

Status
status

Штатное включение и отключение элемента.

Source / Condition / Value / Show Empty
source / condition / condition_value / show_empty

Динамический источник для поддерживаемых полей. Condition и Value задают условие вывода; Show Empty разрешает вывод при пустом значении и отключает условие. Source mappings страницы сохраняются при обновлении расширения.

ID
id

Пользовательский ID корневого элемента. Если поле пустое, элемент создаёт уникальный msgvideo….

Classes
class

Дополнительные CSS-классы корневого элемента.

Attributes
attributes

Дополнительные HTML-атрибуты, по одному на строку.

CSS
css

CSS элемента. В поле доступны подсказки для .el-element и селекторов контейнера, изображения, заголовка и видео.

Transform
transform

Штатные transform-настройки Builder для элемента.

Consent Manager — окно разрешений на сайте

Consent Manager — встроенный в YOOtheme баннер и окно настроек Cookies. В нём посетитель выбирает, каким внешним сервисам разрешить загрузку на сайте: например, видеоплатформе или счётчику статистики.

Внешний плеер обращается к серверам видеоплатформы при загрузке. При настройке согласия optin Video Element показывает заглушку вместо плеера и ждёт разрешения посетителя.

Реальное окно настроек Cookies YOOtheme: раскрыта категория «Функциональные» с сервисом «Видео с внешних платформ»

Что видно в окне

В окне «Настройки 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.

Расширение Video Element

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

Минимальные

PHP
7.4+
Joomla!
5
YOOtheme Pro
5

Рекомендуемые

PHP
8.3+
Joomla!
6
YOOtheme Pro
5

Joomla получает уведомления об обновлениях через сервер MSGru, если на сайте включена проверка обновлений.

Список изменений

Добавлено
Интеграция внешних видеосервисов с настройками Preferences и Consent Manager в YOOtheme.
Добавлено
Предпросмотр внешних видеосервисов непосредственно в конструкторе YOOtheme.
Добавлено
Настраиваемый HTML-контент заглушки, отображаемой до получения согласия посетителя.
Добавлено
Ссылка на штатное окно управления Cookies в YOOtheme.
Добавлено
Подсказки постоянных CSS-селекторов элемента для стандартного механизма props.css
Добавлено
Устранено дублирование обработчиков при одновременной установке MSG Video Element и MSG Welcome Element.
Изменено
Настройки poster frame, focal point, modal и overlay перераспределены по контекстным группам.
Изменено
YouTube и Vimeo продолжают использовать штатные сервисы Preferences из YOOtheme.
Изменено
Заголовок видео теперь отображается во всех режимах
Изменено
Inverse style отображается только для совместимых вариантов box decoration.
Удалено
Удалена поддержка прекративших работу сервисов NUUM и PLVideo.
Добавлено
Поддержка Yandex Cloud Video
Изменено
YOOtheme Pro 5
Изменено
Исправления в отображении некоторых свойст
Изменено
Исправлена ошибка при заполнении поля css

Лицензия

Расширение распространяется бесплатно как есть, в соответствии с GNU GPL v3.
Бесплатно
  • Скачивание без ограничений

  • Использование на любом количестве сайтов

Платно
  • Помощь в установке и настройке

  • Техническая поддержка

  • Исправление проблем совместимости со сторонними расширениями и библиотеками

  • Доработка функционала под конкретные требования заказчика

Закажи разработку

Компоненты любой сложности для Joomla! и не только: интеграция сторонних сервисов; большие пакетные решения; e-commerce.