Сниппет PageBuilderTableRows

Возвращает строки табличных данных ресурса (вкладка Таблицы в менеджере). Формат: JSON или Fenom-chunk.

Назначение

Нужен, когда таблицу выводят своей разметкой: в шаблоне, виджете или отдельном chunk. Секция Pro data_table использует встроенный chunk pagebuilder_data_table.

Где вызывать

Шаблон, chunk, другая секция через snippet-поле. Таблица создана на том же или указанном resource_id.

Параметры

Параметр	По умолчанию	Описание
resource_id	0	ID ресурса. 0 = текущий
table_key	пусто	Ключ таблицы на ресурсе
table_id	0	ID таблицы в БД вместо table_key
limit	20	Максимум строк (1–100)
return	json	json или chunk
tpl	pagebuilder_table_rows	Chunk при return=chunk

Фильтрация и пагинация

Все ключи работают в сниппете. Менеджерский процессор mgr/datatable/rows/list принимает только page, limit, search и filters: контекстные и UTM-фильтры в него не передаются.

Параметр	По умолчанию	Описание
page	1	Номер страницы
search	пусто	Поиск по строкам
filters	пусто	JSON фильтров по колонкам
context_column	пусто	Колонка для фильтра по контексту
use_context	1	Подставить context_key текущего ресурса в context_column
context_key	пусто	Явный контекст вместо текущего
use_utm	0	Добавить фильтры из UTM-сессии
utm / utm_filters	пусто	JSON UTM-фильтров для колонок

Пример filters:

{"price": {"op": "gte", "value": "100"}}

Операторы: eq, contains, in, gt, lt, gte, lte, between, empty, not_empty. Подробнее: Системные настройки → Табличные данные.

Запрос строк меняет событие pbOnBeforeTableGetList: ему передают table, query и criteria, причём criteria передаётся ссылкой. Событие вызывается на каждый запрос строк, и из сниппета, и из менеджерского процессора.

JSON

Ответ: JSON-массив объектов строк (поле data каждой записи). Таблица не найдена → [].

modx

[[!PageBuilderTableRows?
  &table_key=`offices`
  &limit=`50`
]]

fenom

{'!PageBuilderTableRows' | snippet : [
  'table_key' => 'offices',
  'limit' => 50
]}

Chunk

В chunk доступны Fenom-переменные rows (массив data строк) и table (метаданные таблицы). В пакете есть chunk pagebuilder_table_rows.

modx

[[!PageBuilderTableRows?
  &table_key=`offices`
  &return=`chunk`
  &tpl=`my_table_rows`
]]

fenom

{'!PageBuilderTableRows' | snippet : [
  'table_key' => 'offices',
  'return' => 'chunk',
  'tpl' => 'my_table_rows'
]}

См. также

• Секция data_table
• Разработчик → Таблицы данных