Skip to content
PageBuilder
PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
  • MODX 3
  • PHP 8.2
  • Vue 3
  1. Компоненты
  2. PageBuilder
  3. Типы полей
  4. Pro
  5. relation

Поле relation ​

Версия: Pro (advanced-fields).

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

Выбор записи через Autocomplete с поиском в выпадающем списке, без модального окна: запросы идут через searchAction. По умолчанию это mgr/resources/search (до 20 результатов на запрос), свой connector — например mgr/ms3/products/search для miniShop3. В данных сохраняются id и pagetitle, не весь ресурс.

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

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

Советы ​

Только id из xPDO без picker: combo.

Похожие типы ​

  • multirelation для списка ресурсов
  • resourcelist: тот же редактор picker, отдельный Free-тип в каталоге

Настройка ​

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

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

Ключ product — объект { id, pagetitle }, picker сохраняет только выбранное:

json
{
  "product": {
    "id": 42,
    "pagetitle": "О компании"
  }
}
  • Поиск в менеджере может показывать uri и context_key, но в data пишутся id и pagetitle.

Пример в chunk ​

modx
<span class="related">[[+product.pagetitle]]</span>
fenom
{if $product.id}
  <span class="related">{$product.pagetitle|pb_text}</span>
{/if}

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

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

Дальше ​