Поле relation

Версия: Pro.

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

Модальный picker с поиском, не ручной id. searchAction для ms3 и кастомных connector. В data только id и pagetitle, не весь resource.

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

• Ссылка на страницу «О нас» или товар MS3
• Один связанный ресурс в секции
• Внутренняя ссылка с читаемым title в chunk

Советы

Несколько ресурсов: multirelation. Только id из xPDO без модалки: combo.

Похожие типы

• multirelation для списка ресурсов
• resourcelist: alias того же модального picker

Настройка

{
  "name": "product",
  "type": "relation",
  "label": "Товар",
  "searchAction": "mgr/ms3/products/search",
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Объект { id, pagetitle, … }.

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

Ключ product в данных секции (picker сохраняет только выбранное):

{
  "product": {
    "id": 42,
    "pagetitle": "О компании"
  }
}

• Поиск в менеджере может показывать uri и context_key, но в data пишутся id и pagetitle.

Пример в chunk

{if $product.id}
  <span class="related">{$product.pagetitle|escape}</span>
{/if}

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

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

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

• Дополнительно: searchAction для кастомного connector (напр. ms3).

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

Дальше

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