- Быстрый старт: выводим дочерние ресурсы
- Создаем чанк одной записи
- Размещаем вызов на странице
- Тот же пример на Fenom
- Документация по pdoResources
- Параметры выборки ресурсов
- Параметры шаблонов
- Параметры результатов
- Дополнительные общие параметры pdoTools
- Как вывести изображение и другие TV
- Сортировка, фильтры и выбор отдельных страниц
- Последние опубликованные статьи
- Дата в карточке
- Вывод только заданных ресурсов
- Исключение текущего ресурса
- Фильтрация по полю ресурса и TV
- Как ничего не выводить, если ресурсов нет
- Два списка на странице без повторяющихся ресурсов
- Подготавливаем чанки
- Создаем сниппет newsWithoutDuplicates
- pdoResources внутри pdoResources
- Внешний вызов
- Чанк раздела allDoc
- Чанк строки allDocListGroups
- Практика FlexStart: подключаем списки к PageBlocks
- Проверяем подготовленные поля PageBlocks
- Подготавливаем TV ресурсов
- Выводим услуги из ресурсов
- Создаем pb_service_card.tpl
- Заменяем статические карточки вызовом
- Проверяем результат
- Выводим портфолио с русскими категориями
- Создаем файловый сниппет projectCategoryKey.php
- Проверяем транслитерацию
- Создаем pb_project_card.tpl
- Обновляем pb_portfolio.tpl
- Проверяем портфолио
- Выводим последние статьи
- Создаем pb_recentpost_card.tpl
- Обновляем pb_recentposts.tpl
- Старый пример услуг: оформление через colorBox
- Сниппет-модификатор colorBox
- Чанк TplServices на стандартных тегах
- Тот же чанк на Fenom
- Проверяем результат и разбираем ошибки
- Что дальше
Для первого примера понадобятся установленный pdoTools, несколько опубликованных дочерних ресурсов и чанк оформления одной записи. PageBlocks, Fenom и конкретный HTML-шаблон для обычного вывода списка не обязательны.
Сначала разберем самостоятельные примеры и параметры pdoResources. Затем продолжим учебный проект FlexStart: заменим статические карточки услуг, проектов и последних статей выборкой из ресурсов.
Быстрый старт: выводим дочерние ресурсы
Создаем чанк одной записи
Откройте «Элементы» — «Чанки», создайте чанк ListRowTpl и вставьте:
<article class="resource-card">
<h3>
<a href="[[~[[+id]]]]">[[+pagetitle:htmlent]]</a>
</h3>
<p>[[+introtext:htmlent]]</p>
</article>
Чанк описывает одну запись, а не весь список. pdoResources повторит его для каждого найденного ресурса.
Внутри чанка используем плейсхолдеры выбранного ресурса: [[+pagetitle]], [[+introtext]], [[+id]]. Тег [[*pagetitle]] относится к текущей открытой странице и для заголовков карточек здесь не подходит.
Размещаем вызов на странице
В шаблоне или содержимом нужной страницы добавьте:
[[!pdoResources?
&parents=`7`
&depth=`0`
&limit=`6`
&sortby=`menuindex`
&sortdir=`ASC`
&tpl=`ListRowTpl`
]]
7 — пример ID раздела. Замените его фактическим ID своего родительского ресурса.
parentsзадает раздел-источник.depth = 0оставляет только непосредственных детей указанного раздела.limit = 6ограничивает список шестью записями.menuindex ASCзадает порядок по позиции ресурса в меню.tplподключает подготовленный чанк одной записи.
Сохраните страницу и откройте сайт. Измените заголовок одной дочерней страницы, сохраните ее и проверьте карточку. Затем добавьте еще один опубликованный ресурс в тот же раздел.
Если список пуст, сначала проверьте ID родителя, публикацию дочерних ресурсов и имя чанка. Не начинайте с изменения всех параметров сразу.
Тот же пример на Fenom
Если в проекте настроен Fenom, вызов можно записать так:
{'!pdoResources' | snippet : [
'parents' => 7,
'depth' => 0,
'limit' => 6,
'sortby' => 'menuindex',
'sortdir' => 'ASC',
'tpl' => 'ListRowTpl'
]}
А чанк ListRowTpl оформить на Fenom:
<article class="resource-card">
<h3>
<a href="{$id | url}">{$pagetitle | escape}</a>
</h3>
<p>{$introtext | escape}</p>
</article>
Выберите один подходящий вариант. Само наличие файловых чанков не требует Fenom, а использование Fenom не обязывает переносить все элементы в файлы.
Установка пакета разобрана в обзоре pdoTools, синтаксис шаблонизатора — в справочнике Fenom.
Документация по pdoResources
pdoResources выбирает ресурсы по заданным условиям и передает данные каждой строки в чанк. Внешний вид списка определяется вашей разметкой и CSS.
Ниже приведены параметры pdoResources и используемой им библиотеки pdoTools. Значения по умолчанию могут быть переопределены в свойствах установленного сниппета и наборах параметров. В важных выборках указывайте родителя, глубину, сортировку и лимит явно.
Для MODX 2 используется совместимая ветка pdoTools 2.x, для MODX 3 — соответствующая ветка pdoTools 3.x. При переносе примеров сверяйте установленную версию, особенно дополнительные возможности и диагностический вывод.
Актуальный справочник: документация pdoResources.
Параметры выборки ресурсов
Эти параметры определяют, какие страницы попадут в результат, в каком порядке и в каком количестве.
| Параметр | По умолчанию | Описание |
|---|---|---|
&parents |
Текущий ресурс | Список ID родителей через запятую. Значение 0 снимает ограничение по родителю, но не остальные условия выборки. Отрицательный ID используется для исключения ветки; глубину обхода задает depth. |
&depth |
10 |
Глубина поиска внутри указанных родителей. При 0 выбираются непосредственные дочерние ресурсы. Это не параметр level из pdoMenu. |
&resources |
Пусто | Список ID ресурсов через запятую. Положительные ID ограничивают список указанными страницами, отрицательные исключают их. Пример исключения: -15,-18. Условия родителя, публикации и другие ограничения продолжают действовать. |
&context |
Пусто | Ограничивает выборку контекстом или списком контекстов. При выборке без ограничения по родителю полезно указывать нужный контекст явно. |
&where |
Пусто | Дополнительные условия выборки в JSON. Например, {"template":5}. В Fenom и PHP можно передать массив условий. Для обращения к TV включите ее в includeTVs. |
&showHidden |
1 |
Разрешает вывод ресурсов со включенным флажком «Скрыть из меню». При 0 такие страницы исключаются. |
&showUnpublished |
0 |
При 0 выводятся только опубликованные ресурсы. Не включайте неопубликованные материалы в публичную выборку без необходимости. |
&showDeleted |
0 |
При 0 удаленные ресурсы исключаются. |
&hideContainers |
0 |
При 1 исключает ресурсы с isfolder = 1. Это проверка поля «Контейнер», а не универсальная проверка наличия дочерних страниц. |
&select |
0 |
Поля для выборки. Можно передать список или JSON с указанием класса, например {"modResource":"id,pagetitle,introtext"}. Если задаете состав полей вручную, включите все поля, необходимые чанку и формированию ссылок. |
&sortby |
pagetitle |
Поле сортировки. Для нескольких полей используется JSON, например {"publishedon":"DESC","id":"DESC"}. Можно сортировать по TV, включенной в includeTVs. Для случайного порядка используется RAND(). |
&sortdir |
DESC |
Направление сортировки: ASC — по возрастанию, DESC — по убыванию. При JSON-сортировке направления можно задать отдельно для каждого поля. |
&setTotal |
0 |
Включает подсчет общего числа результатов до применения лимита. Значение сохраняется в плейсхолдере totalVar. Для обычного короткого списка подсчет обычно не нужен; pdoPage использует его для пагинации. |
&limit |
10 |
Максимальное количество результатов. Значение 0 снимает ограничение по количеству. На больших разделах не используйте его без оценки размера результата. |
&offset |
0 |
Количество записей, которые нужно пропустить. Указывайте вместе с явным limit. Для полноценной постраничной навигации используйте pdoPage. |
&first |
1 |
Номер итерации, используемый при определении первого элемента и выборе tplFirst. Не путайте с offset и стартовым значением idx. |
&last |
Вычисляется автоматически | Номер последнего элемента для выбора tplLast. В документации приведена формула total + first - 1. При нестандартной нумерации и ограничении результата проверяйте применение последнего чанка на своей версии. |
&loadModels |
Пусто | Список моделей компонентов для загрузки перед запросом, через запятую. Нужен в расширенных выборках и зависит от установленных дополнений и их версии. |
&tvFilters |
Пусто | Фильтры по значениям TV. Например, projectcategory==Приложение. По умолчанию запятая объединяет условия через AND, а || — через OR. Сначала формируются OR-группы, внутри них применяются AND-условия. Для оператора == используется LIKE, поэтому % работает как подстановочный символ. Пример: filter2==one,filter1==bar%||filter1==foo. Не рассчитывайте на подстановку значений по умолчанию TV при такой фильтрации: задавайте фильтруемые значения в ресурсах явно. |
&tvFiltersAndDelimiter |
, |
Разделитель условий AND в tvFilters. |
&tvFiltersOrDelimiter |
|| |
Разделитель групп OR в tvFilters. |
Параметры шаблонов
Эти параметры отвечают за оформление отдельных записей и всего результата.
| Параметр | Описание |
|---|---|
&returnIds |
При 1 возвращает строку ID через запятую вместо оформленных карточек. Параметры оформления записей не используются. Подходит для подготовки списка включений или исключений. |
&tpl |
Чанк одной записи. Если не указан, выводится диагностическое представление полей ресурса. Не оставляйте такой вывод на рабочей странице. |
&tplFirst |
Чанк первого элемента результата. |
&tplLast |
Чанк последнего элемента результата. |
&tplOdd |
Альтернативный чанк для чередования. В документации pdoResources отмечено применение к четным элементам, несмотря на название Odd. При переносе из getResources не полагайтесь на одинаковое поведение по названию параметра. |
&tplWrapper |
Чанк общей обертки. Результат записей передается в [[+output]], на Fenom — в {$output}. Поля отдельной карточки в обертку автоматически не передаются. Не применяется совместно с toSeparatePlaceholders. |
&wrapIfEmpty |
При 1 выводит tplWrapper даже при пустом результате. При 0 пустая выборка не создает эту обертку. |
&tplCondition |
Поле, значение которого используется для выбора чанка из conditionalTpls. |
&tplOperator |
Оператор сравнения для tplCondition и условий из conditionalTpls. |
&conditionalTpls |
JSON с соответствиями между значениями условия и именами чанков. Например, {"5":"tplArticle","6":"tplProject"} при сравнении по номеру шаблона. Учитывайте приоритет специальных чанков первого, последнего и чередующегося элемента. |
&outputSeparator |
Строка-разделитель между оформленными записями. Для карточек обычно достаточно пустой строки или переноса строки. |
Параметры результатов
| Параметр | По умолчанию | Описание |
|---|---|---|
&fastMode |
0 |
Быстрый режим обработки чанков: необработанные теги удаляются. Не включайте его без проверки, если чанк содержит вложенные вызовы, условия и другие теги, которым нужна дальнейшая обработка. |
&idx |
Обычно 1 |
Начальное значение счетчика записей. В чанк передается [[+idx]] или {$idx}. При использовании offset нумерация может учитывать число пропущенных записей. |
&totalVar |
total |
Имя плейсхолдера общего количества найденных ресурсов. Для его заполнения включите setTotal. |
&includeContent |
0 |
Добавляет поле content в стандартную выборку. Для карточек с introtext обычно не требуется. Если поля перечислены вручную через select, проверьте и этот список. |
&includeTVs |
Пусто | Список имен TV через запятую. Например, img,postauthor. Это не флаг «включить все TV»: перечисляйте нужные имена. |
&prepareTVs |
1 по справочнику pdoResources |
Подготовка TV, в частности путей к файлам с учетом источника медиа. Можно указать список имен или 1 для всех TV из includeTVs. В примерах ниже подготовка изображения указана явно: img. |
&processTVs |
Пусто | Обработка TV с учетом настроенного типа вывода. Можно передать список имен или 1 для всех выбранных TV. Не включайте без необходимости: для адреса изображения часто нужна подготовка пути, а не готовый HTML от типа вывода. |
&tvPrefix |
tv. |
Префикс имен TV в данных чанка. При стандартном префиксе используется [[+tv.img]]. При пустом — [[+img]] или {$img}. Не выбирайте для TV имена, конфликтующие с полями ресурса. |
&useWeblinkUrl |
Зависит от свойств вызова | Формирует плейсхолдер link с учетом класса ресурса, в том числе ресурса-ссылки. Для обычных документов можно строить URL по ID. |
&toPlaceholder |
Пусто | Сохраняет результат в плейсхолдер с указанным именем вместо непосредственного вывода. |
&toSeparatePlaceholders |
Пусто | Размещает оформленные записи в отдельных плейсхолдерах с указанным префиксом. Например, при myPl используются [[+myPl0]], [[+myPl1]] и следующие. Нумерация таких плейсхолдеров начинается с нуля. |
&showLog |
0 |
Включает диагностику для пользователя с сессией менеджера. В pdoTools 2.x лог может добавляться к результату; в ветке 3.x документация описывает вывод в плейсхолдер. Способ получения лога сверяйте со своей версией, не рассчитывайте на одинаковое поведение. |
Дополнительные общие параметры pdoTools
В расширенных выборках также используются общие параметры библиотеки:
| Параметр | Назначение |
|---|---|
&templates |
Ограничение по ID шаблонов. Отрицательные ID исключают указанные шаблоны. |
&hideUnsearchable |
Исключение ресурсов, у которых отключен поиск. |
&checkPermissions |
Проверка указанных разрешений. Для закрытых разделов нельзя считать одну публикацию ресурса достаточной проверкой доступа. |
&scheme |
Схема генерируемого URL, например full. Не исправляет ошибочно сохраненный адрес изображения в TV. |
&class |
Класс объектов для расширенной выборки. Для обычных страниц менять его не требуется. |
&leftJoin, &innerJoin, &rightJoin |
Присоединение дополнительных таблиц. Используются вместе с корректными моделями, условиями и списком выбираемых полей. |
&groupby |
Группировка результатов запроса. Это не автоматическое создание визуальных заголовков групп. |
Не передавайте в where, sortby, select и параметры соединений необработанные значения из запроса посетителя. Публичные фильтры требуют отдельной проверки входных данных и разрешенного набора условий.
Как вывести изображение и другие TV
Создайте TV с именем img, подписью «Изображение» и типом ввода «Изображение». Подключите ее к шаблонам нужных ресурсов, затем выберите файл в каждой странице и сохраните ресурс.
Подробно создание и доступность TV разобраны в инструкции по дополнительным полям MODX.
Добавьте в обычный вызов:
[[!pdoResources?
&parents=`7`
&depth=`0`
&limit=`6`
&sortby=`menuindex`
&sortdir=`ASC`
&includeTVs=`img`
&prepareTVs=`img`
&tvPrefix=``
&tpl=`ListRowTpl`
]]
Теперь в чанке доступен плейсхолдер [[+img]]. Для первого теста выберите изображение во всех выводимых ресурсах и добавьте перед заголовком:
<img src="[[+img:htmlent]]" alt="[[+pagetitle:htmlent]]" loading="lazy">
На Fenom подключение выглядит так:
{'!pdoResources' | snippet : [
'parents' => 7,
'depth' => 0,
'limit' => 6,
'sortby' => 'menuindex',
'sortdir' => 'ASC',
'includeTVs' => 'img',
'prepareTVs' => 'img',
'tvPrefix' => '',
'tpl' => 'ListRowTpl'
]}
А в Fenom-чанке можно сразу скрыть незаполненное изображение:
{if $img}
<img src="{$img | escape}" alt="{$pagetitle | escape}" loading="lazy">
{/if}
Обычная TV изображения передается здесь строкой с адресом. Используйте {$img}, а не {$img.url}. Составное поле изображения PageBlocks устроено иначе — там обращение к image.url сохраняется.
Если оставить tvPrefix = tv., стандартный плейсхолдер будет называться [[+tv.img]]. Не меняйте префикс в вызове, оставляя старое имя в чанке.
После сохранения посмотрите фактический src в HTML. Не дописывайте assets/img/ к адресу, который уже содержит этот каталог. При нестандартном источнике медиа проверьте его базовый путь и результат prepareTVs.
Если нужны уменьшенные копии изображений, подключите отдельную обработку. Например, при установленном обработчике pThumb можно использовать:
{$img | pthumb : 'w=354&h=156&zc=1'}
Сам pdoResources не создает превью этим параметром. Варианты обработки изображений разобраны в статье о phpThumb.
Сортировка, фильтры и выбор отдельных страниц
Последние опубликованные статьи
Чтобы получить именно последние публикации, задайте поле даты и направление:
[[!pdoResources?
&parents=`10`
&depth=`0`
&limit=`3`
&sortby=`{"publishedon":"DESC","id":"DESC"}`
&tpl=`ListRowTpl`
]]
10 замените ID раздела блога. Дополнительная сортировка по ID делает порядок определенным, если несколько материалов имеют одинаковую дату публикации.
Одного sortdir = DESC недостаточно: без явного sortby сортировка может идти по заголовку, а не по дате.
Дата в карточке
В чанке pdoResources поле publishedon приходит как timestamp. Дополнительный strtotime, встречающийся в примерах для других сниппетов, здесь не нужен.
В Fenom-чанке:
{$publishedon | date : 'd.m.Y'}
Для стандартных тегов в документации pdoTools приведен вариант:
[[+publishedon:date=`%d.%m.%Y`]]
Форматирование дат и различия синтаксиса разобраны в отдельной инструкции.
Вывод только заданных ресурсов
[[!pdoResources?
&parents=`0`
&resources=`15,18,24`
&limit=`3`
&sortby=``
&sortdir=`ASC`
&tpl=`ListRowTpl`
]]
ID в этом примере условные — замените их своими. Пустой sortby позволяет использовать порядок списка resources. Сохраняются остальные ограничения, в том числе публикация и отсутствие удаления.
Исключение текущего ресурса
Например, для списка соседних статей:
[[!pdoResources?
&parents=`[[*parent]]`
&resources=`-[[*id]]`
&depth=`0`
&limit=`4`
&sortby=`{"publishedon":"DESC","id":"DESC"}`
&tpl=`ListRowTpl`
]]
Здесь [[*parent]] и [[*id]] относятся к текущей открытой странице, а плейсхолдеры внутри ListRowTpl — к каждой выбранной статье.
Фильтрация по полю ресурса и TV
Ограничение по шаблону:
&where=`{"template":5}`
5 замените ID нужного шаблона.
Для точного сравнения по TV включите ее в выборку и укажите условие:
[[!pdoResources?
&parents=`7`
&depth=`0`
&limit=`12`
&includeTVs=`projectcategory`
&where=`{"projectcategory":"Приложение"}`
&sortby=`menuindex`
&sortdir=`ASC`
&tpl=`ListRowTpl`
]]
Альтернативный вариант для фильтра с LIKE:
&tvFilters=`projectcategory==Приложение`
Это серверная выборка: условие влияет на получаемые ресурсы. Не путайте ее с фильтром Isotope, который скрывает и показывает уже загруженные карточки в браузере.
Как ничего не выводить, если ресурсов нет
Если заголовок и контейнер списка находятся снаружи вызова, они останутся в HTML даже при пустом результате:
<h2>Похожие статьи</h2>
<div class="row">
[[!pdoResources? ...]]
</div>
Чтобы скрывался весь блок, перенесите его обертку в чанк myWrapper:
<section class="related-posts">
<h2>Похожие статьи</h2>
<div class="row">
[[+output]]
</div>
</section>
Вызов:
[[!pdoResources?
&parents=`[[*parent]]`
&resources=`-[[*id]]`
&depth=`0`
&limit=`4`
&sortby=`{"publishedon":"DESC","id":"DESC"}`
&tpl=`ListRowTpl`
&tplWrapper=`myWrapper`
&wrapIfEmpty=`0`
]]
На странице должен остаться только этот вызов, без прежней внешней обертки. При отсутствии записей не появятся ни заголовок, ни контейнер.
Для Fenom-обертки вместо [[+output]] используйте {$output}.
Этот прием подходит и для блока похожих материалов.

Два списка на странице без повторяющихся ресурсов
Задача: сверху вывести четыре материала, отмеченные редактором, а ниже — десять последних публикаций, исключив только те четыре, которые действительно попали в верхний блок.
Для отметки используем текстовую TV editorSelected. Значение 4news означает, что материал может попасть в верхнюю подборку.
Нельзя просто исключить из нижнего списка все материалы с editorSelected = 4news: отмеченных страниц может быть больше четырех. Нужно получить ID фактически выбранных ресурсов и исключить именно их.
Подготавливаем чанки
Создайте два чанка одной записи:
tplNewsMain04— оформление верхней подборки.tplNewsMain2— оформление нижнего списка.
Для первого теста можно скопировать в оба содержимое ListRowTpl. Затем измените оформление каждого списка отдельно.
Создаем сниппет newsWithoutDuplicates
В нем последовательно выполняются выбор ID, вывод верхней подборки и вывод последних новостей. Так порядок вычислений не зависит от расположения кешируемых и некешируемых тегов на странице.
В поле кода сниппета вставьте содержимое без открывающего <?php:
$parents = '7,9,12,11,10'; // Замените ID разделов своими.
$base = [
'parents' => $parents,
'depth' => 0,
'showHidden' => 1,
'showUnpublished' => 0,
'showDeleted' => 0,
'hideContainers' => 1,
'sortby' => '{"publishedon":"DESC","id":"DESC"}',
];
$selected = $modx->runSnippet('pdoResources', array_merge($base, [
'limit' => 4,
'includeTVs' => 'editorSelected',
'where' => ['editorSelected' => '4news'],
'returnIds' => 1,
]));
$ids = [];
foreach (explode(',', (string)$selected) as $value) {
$id = (int)trim($value);
if ($id > 0) {
$ids[] = $id;
}
}
$ids = array_values(array_unique($ids));
$top = '';
if ($ids) {
$top = $modx->runSnippet('pdoResources', [
'parents' => 0,
'resources' => implode(',', $ids),
'limit' => count($ids),
'showHidden' => 1,
'showUnpublished' => 0,
'showDeleted' => 0,
'sortby' => '',
'sortdir' => 'ASC',
'includeTVs' => 'img',
'prepareTVs' => 'img',
'tvPrefix' => '',
'tpl' => 'tplNewsMain04',
]);
}
$latestConfig = array_merge($base, [
'limit' => 10,
'includeTVs' => 'img',
'prepareTVs' => 'img',
'tvPrefix' => '',
'tpl' => 'tplNewsMain2',
]);
if ($ids) {
$excluded = [];
foreach ($ids as $id) {
$excluded[] = '-' . $id;
}
$latestConfig['resources'] = implode(',', $excluded);
}
$latest = $modx->runSnippet('pdoResources', $latestConfig);
$output = '';
if ($top !== '') {
$output .= '<section class="editor-choice">'
. '<h2>Выбор редакции</h2>' . $top . '</section>';
}
if ($latest !== '') {
$output .= '<section class="latest-news">'
. '<h2>Последние новости</h2>' . $latest . '</section>';
}
return $output;
Замените ID в $parents своими. В примере выбираются непосредственные дети перечисленных разделов. Если структура глубже, настройте depth под нее.
Разместите на странице один вызов:
[[!newsWithoutDuplicates]]
Проверьте три ситуации: отмеченных публикаций больше четырех, меньше четырех и нет совсем. В последнем случае нижний список должен работать без пустого отрицательного ID и без исключения всех отмеченных материалов.
Для чанков с изображениями используйте img: в вызовах выше установлен пустой tvPrefix.
pdoResources внутри pdoResources
Этот вариант нужен, когда сначала выводятся разделы, а под каждым — несколько его дочерних страниц. Например, подразделы документации с пятью материалами и ссылкой «Смотреть все».
Пример структуры из прежней версии статьи:

Для примера считаем, что общий раздел имеет ID 3. В своем проекте укажите фактический ID.
Внешний вызов
<div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4">
[[!pdoResources?
&parents=`3`
&depth=`0`
&limit=`12`
&tpl=`allDoc`
&sortby=`menuindex`
&sortdir=`ASC`
]]
</div>
Чанк раздела allDoc
<div class="col">
<div class="card h-100 text-center">
<div class="card-header">
<h2 class="h5 card-title">[[+pagetitle:htmlent]]</h2>
</div>
<div class="card-body">
<p class="card-text">[[+introtext:htmlent]]</p>
<ul class="list-group list-group-flush">
[[pdoResources?
&parents=`[[+id]]`
&depth=`0`
&limit=`5`
&tpl=`allDocListGroups`
&sortby=`menuindex`
&sortdir=`ASC`
]]
</ul>
</div>
<div class="card-footer">
<a href="[[~[[+id]]]]">Смотреть все</a>
</div>
</div>
</div>
Чанк строки allDocListGroups
<li class="list-group-item">
<a href="[[~[[+id]]]]">[[+pagetitle:htmlent]]</a>
</li>
Во внешнем чанке [[+id]] — ID раздела, который передается в parents внутреннего вызова. В чанке allDocListGroups этот плейсхолдер уже относится к отдельной дочерней странице.
Пример результата из прежней версии статьи:

Каждый внутренний вызов выполняет отдельную выборку. Для нескольких разделов это понятный прием, но вывод сотен родителей с отдельным запросом под каждым нужно оценивать по логу и времени работы.
По тому же принципу внутри чанка можно вызвать другой сниппет. Например, в проекте с miniShop2 вывести товары дочерней категории через msProducts. Это уже отдельный сценарий: нельзя одновременно вернуть только ID через returnIds и ожидать обработки внешнего чанка с вложенным вызовом.
Практика FlexStart: подключаем списки к PageBlocks
Этот раздел продолжает урок PageBlocks. Если вы пришли из поиска и используете другую верстку, применяйте тот же принцип: чанк секции содержит общие обертки и вызов, отдельный чанк — одну карточку.
В предыдущем уроке мы создали блоки и подготовили ресурсы. Теперь не создаем их повторно и не переносим всю страницу заново. Меняем только три секции со статическими карточками.
| Секция PageBlocks | Новый чанк одной карточки | Источник |
|---|---|---|
pb_services.tpl |
pb_service_card.tpl |
Дочерние ресурсы раздела услуг |
pb_portfolio.tpl |
pb_project_card.tpl |
Дочерние ресурсы раздела проектов |
pb_recentposts.tpl |
pb_recentpost_card.tpl |
Дочерние ресурсы блога |
Все шесть файлов находятся в:
core/elements/chunks/pageblocks/
Отдельные определения PageBlocks для трех чанков карточек не нужны. Их будет вызывать pdoResources через @FILE.
Пути рассчитаны на базовый каталог элементов core/elements/. Если вы меняли pdotools_elements_path, сверьте фактическое расположение.
Перед заменой сохраните копии трех рабочих файлов секций. Общий вызов PageBlocks, остальные блоки, шапку, подвал и подключения CSS/JS не меняем.
Проверяем подготовленные поля PageBlocks
| Блок | ID раздела | Количество карточек |
|---|---|---|
pb_services |
servicesparent |
serviceslimit |
pb_portfolio |
portfolioparent |
portfoliolimit |
pb_recentposts |
blogparent |
bloglimit |
Все эти поля — числовые. На главной откройте каждый экземпляр блока, укажите ID своего раздела и положительный лимит. Для учебного примера используем 6 услуг, 12 проектов и 3 статьи.
Заголовки секций title и подзаголовки text остаются в PageBlocks. Названия, аннотации, изображения и ссылки отдельных карточек теперь получаем из ресурсов.
Подготавливаем TV ресурсов
Одну TV img с подписью «Изображение» и типом «Изображение» подключаем к нужным шаблонам услуг, проектов и статей. Отдельные TV для обложки каждого типа страницы не создаем.
В текущем оформлении услуг используются иконки, поэтому в их карточку img пока не выводится. Для портфолио и статей это изображение карточки.
Дополнительно понадобятся:
| Шаблон ресурсов | TV | Тип и содержимое |
|---|---|---|
| Услуги | serviceicon |
Текст. Полные классы Bootstrap Icons, например bi bi-window. |
| Услуги | servicecolor |
Текст. Один код: cyan, orange, teal, red, indigo или pink. |
| Проекты | projectcategory |
Текст. Одно из названий: «Приложение», «Продукт», «Брендинг», «Книга». |
| Статьи | postauthor |
Текстовая подпись автора. |
| Статьи | postcategory |
Текстовая подпись рубрики. |
Создайте недостающие TV, разрешите их для соответствующих шаблонов и заполните значения в ресурсах. Сохраните страницы. Для projectcategory используйте одинаковое написание без дополнительных пробелов и вариантов во множественном числе.

postauthor в этом примере — подпись, а не автоматическое получение пользователя из createdby. postcategory — текстовая TV, а не готовая система рубрик.
Выводим услуги из ресурсов
Создаем pb_service_card.tpl
В pb_services.tpl найдите одну карточку вместе с колонкой col-lg-4 col-md-6. Скопируйте ее в новый файл pb_service_card.tpl.
Замените статические значения данными ресурса:
{set $color = $servicecolor | default : 'cyan'}
{set $icon = $serviceicon | default : 'bi bi-activity'}
<div class="col-lg-4 col-md-6" data-aos="fade-up" data-aos-delay="{$idx * 100}">
<div class="service-item item-{$color | escape} position-relative">
<i class="{$icon | escape} icon" aria-hidden="true"></i>
<h3>{$pagetitle | escape}</h3>
<p>{$introtext | escape}</p>
<a href="{$id | url}" class="read-more stretched-link">
<span>Подробнее</span>
<i class="bi bi-arrow-right" aria-hidden="true"></i>
</a>
</div>
</div>
Классы item-cyan, item-orange и остальные относятся к текущему оформлению FlexStart. Поле servicecolor содержит только код цвета без префикса item-.
В serviceicon вводим полную пару классов, поэтому дополнительный bi в чанке перед переменной не добавлен.
Заменяем статические карточки вызовом
В pb_services.tpl удалите шесть статических колонок карточек. Общий заголовок, контейнер и сетку сохраните.
Полный файл секции:
{set $parent = $servicesparent | default : 0}
{set $limit = $serviceslimit | default : 6}
{if $limit < 1}
{set $limit = 6}
{/if}
<section id="services" class="services section">
<div class="container section-title" data-aos="fade-up">
<h2>{$title}</h2>
{if $text}<p>{$text}<br></p>{/if}
</div>
{if $parent > 0}
<div class="container">
<div class="row gy-4">
{'!pdoResources' | snippet : [
'parents' => $parent,
'depth' => 0,
'limit' => $limit,
'showHidden' => 1,
'showUnpublished' => 0,
'showDeleted' => 0,
'sortby' => '{"menuindex":"ASC","id":"ASC"}',
'includeTVs' => 'serviceicon,servicecolor',
'tvPrefix' => '',
'tpl' => '@FILE chunks/pageblocks/pb_service_card.tpl'
]}
</div>
</div>
{/if}
</section>
Проверка $parent > 0 важна: незаполненный ID раздела не должен превращаться в выборку без ограничения по родителю. Нулевой или отрицательный лимит заменяется учебным значением 6.
Здесь не нужен includeContent: описание карточки берем из аннотации introtext, а подробный текст остается на странице услуги.
Проверяем результат
- Укажите фактический ID раздела услуг в экземпляре блока на главной.
- Опубликуйте дочерние страницы услуг.
- Проверьте названия, аннотации, иконки и переходы.
- Измените
menuindexодной услуги и проверьте порядок. - Добавьте новую услугу: при достаточном лимите она должна появиться без копирования HTML.
Выводим портфолио с русскими категориями
В TV projectcategory храним понятное редактору название. Английские значения app, product, branding и books из исходного HTML больше не требуются.
Для фильтра нужны технические ключи, одинаковые в классе карточки и data-filter кнопки. Получим их одним сниппетом:
| Значение TV и подпись | Технический ключ | Класс карточки |
|---|---|---|
| Приложение | prilozhenie |
filter-prilozhenie |
| Продукт | produkt |
filter-produkt |
| Брендинг | brending |
filter-brending |
| Книга | kniga |
filter-kniga |
Создаем файловый сниппет projectCategoryKey.php
В TV projectcategory оставляем русские названия: «Приложение», «Продукт», «Брендинг» и «Книга». Для CSS-классов карточек и технических значений фильтров будем получать ключи через штатный метод MODX filterPathSegment().
Метод использует настройки формирования псевдонимов, включая настроенную транслитерацию. Отдельный словарь соответствий для четырех категорий не понадобится.
Создайте файл:
core/elements/snippets/projectCategoryKey.php
Вставьте в него:
<?php
/** @var \MODX\Revolution\modX $modx */
/** @var string|null $input */
$value = trim((string)($input ?? ''));
if ($value === '') {
return '';
}
return $modx->filterPathSegment($value);
Открывающий <?php оставляем: это самостоятельный PHP-файл. Отдельно создавать одноименный сниппет в админке не нужно — будем обращаться к файлу через @FILE.
Аннотация @var в примере указывает класс MODX 3 и помогает редактору кода распознать переменную $modx. Для MODX 2 используйте /** @var \modX $modx */. На выполнение сниппета этот комментарий не влияет.
Пути ниже рассчитаны на базовый каталог элементов core/elements/. Если меняли pdotools_elements_path, сверьте фактическое расположение файлов.
Проверяем транслитерацию
Если русские названия страниц уже преобразуются в латинские псевдонимы, сначала проверьте результат с текущими настройками. Менять их только ради этого примера не нужно.
Для транслитерации через пакет Translit используются следующие настройки:
| Настройка | Значение |
|---|---|
friendly_alias_translit |
russian |
friendly_alias_translit_class |
translit.modTransliterate |
friendly_alias_translit_class_path |
{core_path}components/ |
friendly_alias_lowercase_only |
Да |
Пакет Translit должен быть установлен в совместимой с вашим MODX версии. На работающем сайте сначала проверьте существующие настройки: они используются не только этим примером, но и механизмом формирования псевдонимов.
Конкретное написание технического ключа зависит от настроек транслитерации. Не будем прописывать его вручную: один и тот же файловый сниппет сформирует значение и для кнопки фильтра, и для карточки проекта.
Создаем pb_project_card.tpl
Вынесите одну колонку проекта в файл:
core/elements/chunks/pageblocks/pb_project_card.tpl
Замените статические значения данными ресурса:
{set $categoryKey = '@FILE snippets/projectCategoryKey.php' | snippet : [
'input' => $projectcategory
]}
<div class="col-lg-4 col-md-6 portfolio-item isotope-item{if $categoryKey} filter-{$categoryKey | escape}{/if}">
<div class="portfolio-content h-100">
{if $img}
<img src="{$img | escape}" class="img-fluid"
alt="{$pagetitle | escape}" loading="lazy">
{/if}
<div class="portfolio-info">
<h4>{$pagetitle | escape}</h4>
<p>{$introtext | escape}</p>
{if $img}
<a href="{$img | escape}"
title="{$pagetitle | escape}"
data-gallery="portfolio-gallery"
class="glightbox preview-link">
<i class="bi bi-zoom-in" aria-hidden="true"></i>
</a>
{/if}
<a href="{$id | url}"
title="Подробнее о проекте"
class="details-link">
<i class="bi bi-link-45deg" aria-hidden="true"></i>
</a>
</div>
</div>
</div>
В карточке передаем в сниппет именно $projectcategory — значение TV выбранного ресурса. Переменная $category будет использоваться ниже, в отдельном цикле кнопок фильтра.
Если категория не заполнена или после обработки получился пустой ключ, карточка останется в общем списке без класса категории. Если изображение не выбрано, картинка и ссылка увеличения не выводятся.
Обновляем pb_portfolio.tpl
Удалите статические карточки из isotope-container. Список фильтров тоже замените: прежние технические значения filter-app, filter-product и остальные больше не используются.
Полный файл секции:
{set $parent = $portfolioparent | default : 0}
{set $limit = $portfoliolimit | default : 12}
{if $limit < 1}
{set $limit = 12}
{/if}
{set $categories = [
'Приложение',
'Продукт',
'Брендинг',
'Книга'
]}
<section id="portfolio" class="portfolio section">
<div class="container section-title" data-aos="fade-up">
<h2>{$title}</h2>
{if $text}<p>{$text}</p>{/if}
</div>
{if $parent > 0}
<div class="container">
<div class="isotope-layout"
data-default-filter="*"
data-layout="masonry"
data-sort="original-order">
<ul class="portfolio-filters isotope-filters"
data-aos="fade-up" data-aos-delay="100">
<li data-filter="*" class="filter-active">Все</li>
{foreach $categories as $category}
{set $categoryKey = '@FILE snippets/projectCategoryKey.php' | snippet : [
'input' => $category
]}
{if $categoryKey}
<li data-filter=".filter-{$categoryKey | escape}">
{$category | escape}
</li>
{/if}
{/foreach}
</ul>
<div class="row gy-4 isotope-container"
data-aos="fade-up" data-aos-delay="200">
{'!pdoResources' | snippet : [
'parents' => $parent,
'depth' => 0,
'limit' => $limit,
'showHidden' => 1,
'showUnpublished' => 0,
'showDeleted' => 0,
'sortby' => '{"menuindex":"ASC","id":"ASC"}',
'includeTVs' => 'img,projectcategory',
'prepareTVs' => 'img',
'tvPrefix' => '',
'tpl' => '@FILE chunks/pageblocks/pb_project_card.tpl'
]}
</div>
</div>
</div>
{/if}
</section>
В цикле фильтров передаем в сниппет $category — текущее название из массива $categories. В чанке карточки передаем $projectcategory — значение TV ресурса. Оба значения обрабатываются одним файлом, поэтому технические ключи будут совпадать при одинаковом написании категории.
Обертки isotope-layout, isotope-container, классы portfolio-item и isotope-item сохранены. Подключения и инициализация Isotope, imagesLoaded и GLightbox остаются общими для страницы.
Фильтр работает только с карточками, которые уже загружены в HTML. При лимите 12 он не ищет дополнительные проекты в базе. Если среди выбранных двенадцати нет книг, нажатие «Книга» даст пустую группу, даже если такие проекты есть дальше в разделе.
Чтобы добавить новую категорию, внесите ее русское название в массив $categories и заполните таким же значением TV соответствующих проектов. Дописывать PHP-словарь больше не нужно. Сами кнопки при этом не собираются из ресурсов автоматически — их список по-прежнему задается массивом в секции.
Проверяем портфолио
- Заполните у проектов TV
imgиprojectcategory. - Укажите ID раздела проектов и лимит в блоке главной.
- Проверьте, что в HTML карточки приложения есть
filter-prilozhenie. - Проверьте соответствующий фильтр
data-filter=".filter-prilozhenie". - Откройте изображение через GLightbox.
- Перейдите на подробную страницу проекта.

Выводим последние статьи
Создаем pb_recentpost_card.tpl
Вынесите одну колонку из pb_recentposts.tpl в новый файл и замените статические значения:
<div class="col-xl-4 col-md-6">
<div class="post-item position-relative h-100"
data-aos="fade-up" data-aos-delay="{$idx * 100}">
<div class="post-img position-relative overflow-hidden">
{if $img}
<img src="{$img | escape}" class="img-fluid"
alt="{$pagetitle | escape}" loading="lazy">
{/if}
{if $publishedon}
<span class="post-date">
{$publishedon | date : 'd.m.Y'}
</span>
{/if}
</div>
<div class="post-content d-flex flex-column">
<h3 class="post-title">{$pagetitle | escape}</h3>
{if $postauthor || $postcategory}
<div class="meta d-flex align-items-center">
{if $postauthor}
<div class="d-flex align-items-center">
<i class="bi bi-person" aria-hidden="true"></i>
<span class="ps-2">{$postauthor | escape}</span>
</div>
{/if}
{if $postauthor && $postcategory}
<span class="px-3 text-black-50">/</span>
{/if}
{if $postcategory}
<div class="d-flex align-items-center">
<i class="bi bi-folder2" aria-hidden="true"></i>
<span class="ps-2">{$postcategory | escape}</span>
</div>
{/if}
</div>
{/if}
<hr>
<a href="{$id | url}" class="readmore stretched-link">
<span>Подробнее</span>
<i class="bi bi-arrow-right" aria-hidden="true"></i>
</a>
</div>
</div>
</div>
Аннотация introtext тоже доступна в чанке, но в исходной карточке Recent Posts отдельного блока описания нет. Если он нужен, добавьте его осознанно и проверьте высоту карточек:
{if $introtext}
<p>{$introtext | escape}</p>
{/if}
Обновляем pb_recentposts.tpl
Удалите три статические колонки и вставьте вызов внутри прежней сетки:
{set $parent = $blogparent | default : 0}
{set $limit = $bloglimit | default : 3}
{if $limit < 1}
{set $limit = 3}
{/if}
<section id="recent-posts" class="recent-posts section">
<div class="container section-title" data-aos="fade-up">
<h2>{$title}</h2>
{if $text}<p>{$text}</p>{/if}
</div>
{if $parent > 0}
<div class="container">
<div class="row gy-5">
{'!pdoResources' | snippet : [
'parents' => $parent,
'depth' => 0,
'limit' => $limit,
'showHidden' => 1,
'showUnpublished' => 0,
'showDeleted' => 0,
'sortby' => '{"publishedon":"DESC","id":"DESC"}',
'includeTVs' => 'img,postauthor,postcategory',
'prepareTVs' => 'img',
'tvPrefix' => '',
'tpl' => '@FILE chunks/pageblocks/pb_recentpost_card.tpl'
]}
</div>
</div>
{/if}
</section>
Порядок задается по publishedon DESC, а не по заголовку. Во всех примерах курса используется depth = 0. Если статьи разложены по дочерним рубрикам, настройте глубину и ограничения так, чтобы в список не попали сами страницы рубрик.
При необходимости ограничьте выборку шаблоном статьи. Не включайте hideContainers автоматически, если ваши статьи сами помечены контейнерами.
Для сравнения — пример другого оформления списка публикаций из прежней версии статьи:

Этот скриншот показывает прежнюю верстку, а не точный результат текущего чанка Recent Posts.
Старый пример услуг: оформление через colorBox
В прежней версии урока использовалась другая разметка FlexStart: service-box, цветовые классы blue, green, purple и иконки Remix Icon. Ее не нужно смешивать с текущими service-item и item-cyan.
Сохраняю этот вариант для проектов, где старая верстка уже используется.

Сниппет-модификатор colorBox
Здесь цвет зависит от позиции карточки, а не от TV ресурса. Чтобы код продолжал работать после шестой записи, используем циклический выбор:
$colors = ['blue', 'orange', 'green', 'red', 'purple', 'pink'];
$position = max(1, (int)$input);
return $colors[($position - 1) % count($colors)];
Чанк TplServices на стандартных тегах
<div class="col-lg-4 col-md-6" data-aos="fade-up">
<div class="service-box [[+idx:colorBox]]">
<i class="ri-discuss-line icon" aria-hidden="true"></i>
<h3>[[+pagetitle:htmlent]]</h3>
<p>[[+content:strip_tags:ellipsis=`70`:htmlent]]</p>
<a href="[[~[[+id]]]]" class="read-more">
<span>Подробнее</span>
<i class="bi bi-arrow-right" aria-hidden="true"></i>
</a>
</div>
</div>
Тот же чанк на Fenom
<div class="col-lg-4 col-md-6" data-aos="fade-up">
<div class="service-box {$idx | colorBox}">
<i class="ri-discuss-line icon" aria-hidden="true"></i>
<h3>{$pagetitle | escape}</h3>
<p>{$content | notags | truncate : 70 : ' ... ' : true : true | escape}</p>
<a href="{$id | url}" class="read-more">
<span>Подробнее</span>
<i class="bi bi-arrow-right" aria-hidden="true"></i>
</a>
</div>
</div>
Вызов:
[[!pdoResources?
&parents=`7`
&depth=`0`
&limit=`6`
&includeContent=`1`
&sortby=`menuindex`
&sortdir=`ASC`
&tpl=`TplServices`
]]
Здесь includeContent = 1 нужен, потому что описание формируется из content. В новой практике выше используем готовую аннотацию introtext и не выбираем полный текст ради короткой карточки.
В этом подходе после перестановки услуг меняется и цвет. Если оформление должно принадлежать самой услуге, используйте TV, как в основном примере курса.
Проверяем результат и разбираем ошибки
| Проблема | Что проверить |
|---|---|
| Список пуст | ID родителя, публикацию и удаление ресурсов, глубину, условия where, ограничения по шаблону и контексту. |
| Появились страницы из других разделов | Не оказался ли parents равным нулю или пустому значению. В блоках курса проверьте заполнение числового поля родителя. |
| Вывелись рубрики вместе со статьями | Структуру дерева, depth и ограничение по шаблону. hideContainers проверяет флаг контейнера, а не назначение страницы. |
| Вместо карточек виден набор полей | Указан ли tpl, существует ли чанк, правильно ли записан файловый путь. |
| Во всех карточках один заголовок | Не используются ли поля текущей страницы [[*pagetitle]] вместо плейсхолдера [[+pagetitle]]. |
| Не выводится изображение | Доступность TV шаблону, сохраненное значение, includeTVs, tvPrefix, prepareTVs и фактический адрес файла. |
| В адресе изображения повторяется каталог | Не дописывается ли путь вручную к уже подготовленному значению. Параметр scheme для ссылок ресурсов эту ошибку не исправляет. |
| Статьи идут не по дате | Явно ли указано sortby = publishedon и нужное направление. Одного sortdir недостаточно. |
| Нет текста content | includeContent и ручной список полей select. |
| Фильтр портфолио скрывает все карточки | Одинаковы ли ключи в классе карточки и data-filter, корректно ли заполнена категория и загружена ли инициализация Isotope. |
| В выбранной категории нет работ | Есть ли эта категория среди карточек текущей выборки. Фильтр браузера не загружает проекты за пределами лимита. |
| Ссылка открывает неправильную страницу | Формируйте URL по ID или используйте подготовленный link. uri — сохраненный путь, а не универсальная замена генерации ссылки. |
| Остались выражения Fenom | Обработку Fenom, фактический чанк и выбранный способ подключения. Не включайте произвольный PHP только ради условий и вызова сниппета. |
| Не выполняется вложенный вызов | Синтаксис, область плейсхолдеров, порядок обработки и fastMode. |
Сначала установите, на каком этапе возникает ошибка: выборка не нашла записи, чанк не обработался или готовая разметка скрыта CSS и JavaScript.
Для диагностики временно используйте showLog способом, который поддерживает установленная ветка pdoTools. После проверки отключите его. Лог может содержать структуру запроса и внутренние данные.
Если изменения не видны, проверьте сохранение ресурса, путь редактируемого файла и кеш. Некешируемый вызов [[!pdoResources]] не означает, что на сайте отсутствуют другие уровни кеширования.
Для трех секций курса отдельно проверьте:
- Изменение заголовка ресурса отражается в нужной карточке.
- Новая опубликованная дочерняя страница появляется в пределах лимита.
- Неопубликованные и удаленные страницы не выводятся.
- Услуги и проекты сортируются по
menuindex, статьи — по дате публикации. - Категории портфолио отображаются по-русски, а технические ключи совпадают.
- Изображения и ссылки работают без статических адресов
portfolio-details.htmlиblog-details.html. - Старые статические карточки удалены из трех чанков секций и не дублируют выборку.
Что дальше
Для каталога или блога с несколькими страницами результатов переходите к пагинации через pdoPage. Лимит карточек на главной и постраничная навигация полного раздела решают разные задачи.
В практическом проекте FlexStart списки услуг, проектов и статей теперь берутся из ресурсов. Следующий шаг — форма обратной связи через FetchIt: подключим обработчик, проверку полей и сообщения о результате вместо статической формы с отключенной отправкой.











