Поле tv

Версия: Free. Тип не предлагается при создании нового поля в CMP; уже сохранённый в schema открывается.

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

Редактор выбирает дополнительное поле ресурса (TV). На сайте значение читают из ресурса по имени TV из данных секции: {$_modx->resource[$tv.name]} в Fenom или [[*hero_image]] в синтаксисе MODX. Секция не копирует значение к себе, а указывает, какую TV читать.

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

• Секция читает TV ресурса по выбору редактора
• Общая TV hero-image для нескольких шаблонов
• Для разработчика: выбор, какую TV отдать в секцию

Советы

Загрузка файла в секции: image или file.

Похожие типы

• chunk для выбора чанка по name
• relation для ресурса, не TV

Настройка

{
  "name": "tv",
  "type": "tv",
  "label": "TV",
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Объект { id, name, caption }.

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

Ключ tv в данных секции:

{
  "tv": {
    "id": 7,
    "name": "hero_image",
    "caption": "Hero image"
  }
}

Пример в chunk

modx

[[*hero_image]]

fenom

{$_modx->resource[$tv.name]}

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

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

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

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

Дальше

• Справочник типов
• Обзор полей
• Pro в менеджере