Поле video

Версия: Free.

Зачем этот тип

Ссылка на YouTube или Vimeo, либо загруженный ролик. После сохранения появляются адрес плеера (embed_url), название сервиса (provider) и ссылка на просмотр (watch_url). Если тип поля video или в имени есть «video», те же значения записываются ещё и ключами video_*.

Когда использовать

• Фоновое видео на первом экране или в блоке с демонстрацией
• Ролик на странице товара
• Один ролик с обложкой и подписью

Советы

В чанке выводите адрес плеера и сервис, не только исходный url. Набор фотографий делают полем gallery, не video.

Похожие типы

• image для неподвижной обложки
• url для обычной ссылки на ролик

Настройка

{
  "name": "video",
  "type": "video",
  "label": "Видео",
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Объект { url, poster }. poster: media-объект как у image. Enrich добавляет embed_url, provider, watch_url.

Данные секции

Ключ video в данных секции после save enrich (SectionFieldEnricher + VideoEmbedResolver):

{
  "video": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "embed_url": "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ",
    "provider": "youtube",
    "watch_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "poster": {
      "url": "assets/images/hero.jpg",
      "id": 12,
      "path": "assets/images/",
      "filename": "hero.jpg",
      "extension": "jpg",
      "name": "hero",
      "title": "hero.jpg",
      "width": 1920,
      "height": 1080,
      "size": 245760,
      "type": "image"
    }
  },
  "video_embed_url": "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ",
  "video_provider": "youtube",
  "video_watch_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

• Плоские video_embed_url, video_provider, video_watch_url добавляются, если имя поля содержит video или секция имеет type=video.

Пример в chunk

modx

<iframe src="[[+video.embed_url]]" title="Video"></iframe>
[[$pagebuilder_partial_image?
  &image=`[[+video.poster]]`
  &alt=`[[+video.poster.title]]`
  &class=`pb-video__poster`
]]

fenom

<iframe src="{$video.embed_url|escape}" title="Video"></iframe>
{include 'pagebuilder_partial_image' image=$video.poster alt=$video.poster.title class='pb-video__poster'}

Примечание

Плоские video_embed_url / video_provider / video_watch_url: только для секции type=video или имени поля с «video».

Общие свойства

Для полей с name, которые сохраняются в данных секции:

Ключ	Тип	Роль	Панель
tab	string	Подзаголовок группы в инспекторе	да
width	25–100	Ширина поля в % строки (flex)	да
description	string	Подсказка под подписью	да
default	any	Начальное значение новой секции	да
active	bool	false: скрыть поле в инспекторе	да
required	bool	Обязательно при publish (черновик сохраняется)	да

• Дополнительно: poster: вложенный media-объект. Enrich: embed_url, provider, watch_url.

Подробнее: обзор полей.

Дальше

• Справочник типов
• Обзор полей
• Менеджер и события