pdoResources — вывод списков ресурсов в MODX

Сниппет pdoResources предназначен для вывода списков ресурсов на сайте и является продвинутой заменой стандартного getResources. Он обладает всеми возможностями оригинального сниппета, но лишен его недостатков и работает в несколько раз быстрее благодаря оптимизированной работе с базой данных. Сниппет поддерживает подключение других таблиц через разные типы JOIN, позволяет указывать конкретные колонки для выборки и создавать гибкие условия фильтрации вплоть до чистого SQL.

Переход с getResources на pdoResources в большинстве случаев требует минимальных изменений — достаточно просто заменить имя сниппета в вызове. Основное отличие заключается в параметре &includeTVs: у getResources он принимает значения Да/Нет, тогда как у pdoResources — список конкретных названий TV-параметров через запятую.

Параметры pdoResources

Параметры выборки ресурсов

Они определяют, какие ресурсы появятся в генерируемом списке.

Параметры шаблонов

Отвечают за внешний вид.

Параметры результатов

Дополнительно определяют, какие данные и каким способом будут выводиться.

Примеры

Простейший вызов сниппета для вывода дочерних ресурсов текущей страницы:

[[!pdoResources?
&tpl=`ListRow`
]]

Вывод ресурсов из конкретного контейнера с ID 5:

[[pdoResources?
  &parents=`5`
  &depth=`0`
  &tpl=`ListRow`
]]

Если используется TV-параметр image, то вызов изменится следующим образом:

[[pdoResources?
  &parents=`5`
  &depth=`0`
  &tpl=`ListRow`
  &includeTVs=`image`
]]

В чанке ListRow за это поле будет отвечать плейсхолдер [[+tv.image]].

Работа с конкретными ресурсами

Если нужно вывести элементы в том же порядке, как они объявлены в параметре &resources:

[[pdoResources? &resources=`213,34,58,290` &sortdir=`ASC` &tpl=`ListRow`]]

Исключение конкретных ресурсов из выборки:

[[pdoResources? &parents=`5` &resources=`-12,-45` &tpl=`ListRow`]]

Сортировка и ограничение

Вывод последних 10 новостей по дате публикации:

[[pdoResources? &parents=`10` &sortby=`publishedon` &sortdir=`DESC` &limit=`10` &tpl=`NewsRow`]]

Случайный вывод 5 ресурсов:

[[pdoResources? &parents=`5` &sortby=`RAND()` &limit=`5` &tpl=`RandomItem`]]

Работа с TV-параметрами

Вывод с несколькими TV и без префикса:

[[pdoResources? &parents=`5` &includeTVs=`image,tags,date` &tvPrefix=`` &tpl=`ArticleRow`]]

Теперь в чанке можно использовать [[+image]] вместо [[+tv.image]].

Сортировка по TV-параметру:

[[pdoResources? &parents=`5` &includeTVs=`price,rating` &sortby=`price` &sortdir=`ASC` &tpl=`ProductRow`]]

Фильтрация

Исключение контейнеров и скрытых ресурсов:

[[pdoResources? &parents=`0` &hideContainers=`1` &showHidden=`0` &tpl=`PageRow`]]

Фильтрация по шаблонам:

[[pdoResources? &parents=`0` &templates=`1,5,7` &tpl=`ListRow`]]

Расширенная фильтрация через where:

[[pdoResources?
  &parents=`5`
  &where=`{
    "publishedon:>": "2025-01-01",
    "template:IN": [1,5,10]
  }`
  &tpl=`NewsRow`
]]

Фильтрация по TV

Простой фильтр по значению TV:

[[pdoResources?
  &parents=`5`
  &includeTVs=`category,status`
  &tvFilters=`category==news,status==published`
  &tpl=`ArticleRow`
]]

Фильтр с логикой OR:

[[pdoResources?
  &parents=`5`
  &includeTVs=`tags`
  &tvFilters=`tags==summer||tags==vacation`
  &tpl=`ArticleRow`
]]

Инлайн-шаблоны

Быстрый вывод без создания отдельного чанка:

[[pdoResources?
  &parents=`5`
  &tpl=`@INLINE 
<article>
  <h3><a href="[[~[[+id]]]]">[[+pagetitle]]</a></h3>
  <p>[[+introtext]]</p>
</article>`
]]

Простой список ссылок:

<ul>
[[pdoResources?
  &parents=`5`
  &tpl=`@INLINE <li><a href="[[~[[+id]]]]">[[+pagetitle]]</a></li>`
]]
</ul>

Вывод в плейсхолдеры

Сохранение результата для использования в другом месте:

[[pdoResources?
  &parents=`5`
  &limit=`5`
  &tpl=`LatestNews`
  &toPlaceholder=`latestNews`
]]

<aside>
  [[+latestNews]]
</aside>

Возврат только ID ресурсов:

[[pdoResources?
  &parents=`5`
  &returnIds=`1`
  &toPlaceholder=`idList`
]]

Список ID: [[+idList]]

Оптимизация

Выборка только нужных полей для ускорения работы:

[[pdoResources?
  &parents=`5`
  &select=`id,pagetitle,publishedon,introtext`
  &includeContent=`0`
  &tpl=`CompactRow`
]]

Быстрый режим без обработки дополнительных тегов:

[[pdoResources?
  &parents=`5`
  &tpl=`SimpleRow`
  &fastMode=`1`
]]

Особенности работы с датами

В отличие от getResources, даты в pdoResources уже хранятся в формате timestamp. Можно сразу применять модификатор date:

[[pdoResources?
  &parents=`5`
  &tpl=`@INLINE 
<article>
  <h3>[[+pagetitle]]</h3>
  <time>[[+publishedon:date=`%d.%m.%Y`]]</time>
</article>`
]]

Не нужно использовать strtotime как в getResources — даты уже в нужном формате.