- Что такое чанк MODX
- Где находятся и хранятся чанки
- Создаем первый чанк
- Подключаем чанк в шаблоне
- Редактируем общий фрагмент
- Параметры чанка: одна карточка с разными данными
- Передаем поля ресурса и TV
- Свойства по умолчанию и наборы свойств
- Кешируемый и некешируемый вызов
- Вложенные чанки и условия
- Fenom — для сравнения
- Хранение кода чанка в файле
- Использование чанка из PHP-сниппета
- Как разумно делить оформление
- Переносим общий код в tpl
- Отделяем различающееся содержание
- Как схема используется у разных типов страниц
- Альтернатива: наследование Fenom через админку
- Если на странице виден вызов Fenom
- Ошибки компиляции и фигурные скобки
- Если чанк не выводится
- Следующий урок
В предыдущих уроках мы создали учебные шаблоны и подключили поля ресурсов. Теперь вынесем повторяемую разметку в чанки, чтобы не изменять один и тот же фрагмент в нескольких местах.
Сначала подключим общий подвал, затем создадим карточку с параметрами. Готовый дизайн для этого не нужен. Практику выполняем стандартным синтаксисом MODX, варианты Fenom приведены для сравнения.
Что такое чанк MODX
Чанк — именованный элемент с текстом или разметкой. При обработке страницы MODX заменяет его вызов содержимым этого элемента.
Например, в чанк можно вынести подвал, контактную информацию, форму или карточку записи. Внутри разрешено вызывать поля, TV, сниппеты и другие чанки.
PHP-код из чанка не исполняется как код сниппета. Не вставляйте туда серверные скрипты в расчете, что они заработают или будут скрыты. Для PHP предназначены сниппеты.
Шаблон назначается ресурсу и определяет представление страницы. Чанк не назначают вместо шаблона — его подключают в нужном месте.
Где находятся и хранятся чанки
В менеджере откройте вкладку «Элементы» и раздел «Чанки».
Обычные чанки хранятся в базе данных, в таблице с именем вида modx_site_htmlsnippets. modx_ — префикс установки, который у вас может отличаться. Открывать таблицу вручную для редактирования не требуется.
Код можно связывать и с файлами. Этот вариант рассмотрен отдельно ниже, для основной практики оставляем хранение через админку.
Создаем первый чанк
Выделим общий подвал учебных шаблонов.
- На вкладке «Элементы» найдите раздел «Чанки».
- Нажмите кнопку добавления или откройте контекстное меню раздела и выберите создание чанка.
- Укажите имя siteFooter.
- При необходимости добавьте описание: «Общий подвал учебных страниц».
- В поле кода вставьте разметку ниже и сохраните элемент.

<footer>
<p>Учебный сайт на MODX.</p>
</footer>
Имя siteFooter используется в вызове. Описание и категория помогают организовать элементы в менеджере, но не выводятся посетителю как содержимое чанка.
Другие способы создания
В зависимости от версии менеджера доступны создание через плюс рядом с разделом и быстрое создание из контекстного меню.
TagElementPlugin позволяет работать с элементами по выделенным в редакторе тегам. Для выполнения этого урока пакет не обязателен.
Подключаем чанк в шаблоне
Стандартный вызов:
[[$siteFooter]]
- Откройте шаблон «Учебный», созданный в предыдущем уроке.
- Найдите его подвал — фрагмент от открывающего footer до закрывающего /footer.
- Замените весь этот фрагмент вызовом siteFooter.
- Сохраните шаблон и откройте использующую его страницу.
Не вставляйте вызов внутрь старого footer: чанк уже содержит этот тег. Иначе получится подвал внутри подвала.
Если у вас есть второй шаблон «Учебный — с примечанием», замените его подвал тем же вызовом. Другой код, поля и дополнительный блок не меняйте.

Редактируем общий фрагмент
- Откройте siteFooter в разделе чанков.
- Замените текст на «Общий подвал всех учебных страниц».
- Сохраните чанк.
- Обновите обе страницы; при необходимости очистите кеш MODX.
Подпись изменится везде, где подключен siteFooter. Для этого больше не нужно редактировать HTML каждого шаблона.
Заголовки и содержимое ресурсов при этом остаются своими: мы вынесли только выбранную часть оформления.
Параметры чанка: одна карточка с разными данными
Чанк можно использовать не только для одинакового текста, но и для одинаковой структуры. Создайте новый элемент serviceCard:
<article class="service-card">
<h2>[[+title:htmlent]]</h2>
<p>[[+text:htmlent]]</p>
</article>
title и text — плейсхолдеры. При вызове передадим им значения:
[[$serviceCard?
&title=`Подготовка материалов`
&text=`Оформляем тексты и изображения для публикации.`
]]
Второй вызов того же чанка:
[[$serviceCard?
&title=`Поддержка сайта`
&text=`Проверяем страницы и обновляем содержание.`
]]
Временно добавьте оба вызова внутрь body учебного шаблона. Получатся две карточки с разными текстами. Класс service-card только обозначает блок: отдельные стили для проверки не требуются.

Знак вопроса начинает параметры, перед каждым именем ставится амперсанд, а значение заключается в обратные кавычки. Параметр title подставляется в плейсхолдер title, text — в text.
htmlent используется для вывода этих значений как обычного текста. Если передаете доверенную HTML-разметку, ее обработку выбирают отдельно.
Передаем поля ресурса и TV
Значением параметра может быть другой тег:
[[$serviceCard?
&title=`[[*pagetitle]]`
&text=`[[*introtext]]`
]]
Теперь карточка получает заголовок и аннотацию открытой страницы. Внутри самого чанка по-прежнему остаются плейсхолдеры title и text.
Таким же способом передается созданное TV. Его техническое имя подставляется в тег со звездочкой.
Не путайте источники: [[*pagetitle]] относится к текущему ресурсу, а [[+title]] получает переданное значение. Параметры делают чанк пригодным для разных данных, а не только для одной страницы.
Свойства по умолчанию и наборы свойств
Повторяемые параметры можно сохранить в свойствах элемента или отдельном наборе. Например, если для serviceCard заранее создан набор CardDefaults:
[[$serviceCard@CardDefaults]]
Значение непосредственно в вызове может переопределить соответствующее свойство:
[[$serviceCard@CardDefaults?
&title=`Другой заголовок`
]]
CardDefaults здесь не создается автоматически. Для первого упражнения достаточно параметров прямо в вызове.
Что возвращает свойство типа «Список»
Варианты списка в редакторе свойства нужны для выбора значения. В плейсхолдер попадает выбранное значение свойства, а не автоматически весь перечень его опций.
Например, у свойства view могут быть подписи «Кратко» и «Подробно» со значениями compact и full. Если выбран compact, обычный вывод:
[[+view]]
даст compact. Перебор всех доступных вариантов — отдельная задача получения данных; он не выполняется простым вызовом этого плейсхолдера.
Кешируемый и некешируемый вызов
Обычный вызов чанка:
[[$siteFooter]]
Некешируемый:
[[!$siteFooter]]
Восклицательный знак меняет режим обработки тега. При кешировании ресурса результат обычного вызова может попасть в кеш страницы; некешируемый вызов обрабатывается на соответствующем этапе генерации ответа MODX.
Это не означает, что каждый такой чанк обязательно заново читается из базы отдельным запросом. В системе действуют разные уровни кеширования.
Для нашего общего подвала и карточек с постоянными параметрами достаточно обычного вызова. Не добавляйте ! ко всем элементам на всякий случай.
Также учитывайте внутренние теги. Если в чанке есть сниппет, форма или персональные данные, их режим обработки нужно определить отдельно. Внешний ! не является универсальной настройкой всего содержимого.
Вложенные чанки и условия
Чанк может подключать другие чанки. Например, контактный блок можно использовать внутри общего подвала. Но не вызывайте элемент из него самого напрямую или через замкнутую цепочку.
Если знакомы с модификаторами MODX, можно выбрать один из двух чанков по условию.
Допустим, созданы sectionNotice и commonNotice. Для ресурсов с родителем 7 нужен первый, для остальных — второй:
[[$[[*parent:is=`7`:then=`sectionNotice`:else=`commonNotice`]]]]
Внутренний тег выбирает имя, внешний подключает результат. 7 заменяется вашим ID родителя, оба чанка должны существовать.
Почему не просто поместить готовые вызовы в then и else? Вложенные теги могут обработаться до выбора результата внешнего условия. Если внутри находятся тяжелые сниппеты, скрытая ветка не всегда означает отсутствие их обработки.
Само число чанков не измеряет нагрузку. Важнее их содержимое, повторные вызовы и работа кеша.
Fenom — для сравнения
Основную практику выполняем стандартными тегами. После настройки Fenom обычный чанк можно подключать так:
{include 'siteFooter'}
Или через microMODX:
{$_modx->getChunk('siteFooter')}
Передача параметров:
{$_modx->getChunk('serviceCard', [
'title' => 'Подготовка материалов',
'text' => 'Оформляем тексты и изображения для публикации.'
])}
Содержимое карточки на Fenom:
<article class="service-card">
<h2>{$title | escape}</h2>
<p>{$text | escape}</p>
</article>
Не вставляйте обе версии разметки подряд. Для этого варианта должна быть настроена соответствующая обработка Fenom в шаблоне страницы и чанках pdoTools.
Вариант условия:
{if $_modx->resource.parent == 7}
{include 'sectionNotice'}
{else}
{include 'commonNotice'}
{/if}
При заранее созданном наборе свойств pdoTools также поддерживает загрузку:
{$_modx->getChunk('serviceCard@CardDefaults')}
Это возможность интеграции с MODX, а не требование создавать набор свойств для каждого include.
Хранение кода чанка в файле
Штатный статический чанк MODX
Начиная с MODX Revolution 2.2 чанк можно связать с файлом:
- Сохраните его HTML-код в файл, доступный через выбранный источник файлов.
- В редакторе чанка включите флажок «Статичный».
- Выберите источник и укажите путь к файлу относительно его базового каталога.
- Сохраните элемент.
Вызов чанка по имени остается прежним. Код можно редактировать в файле, а при проверке изменений нужно учитывать кеш.
Этот механизм не требует Fenom. Расширение .tpl само по себе также не включает шаблонизатор.
Для автоматизации в MODX 2.7+ есть static_elements_automate_chunks, static_elements_default_mediasource и static_elements_basepath. В начальном упражнении включать автоматизацию не требуется: она влияет на создание и обслуживание связанных файлов.
Прямое файловое подключение pdoTools/Fenom
Другой вариант — загружать код напрямую через файловые элементы pdoTools, не создавая отдельный чанк в дереве для каждого файла.
Например, на настроенном Fenom:
{include 'file:chunks/siteFooter.tpl'}
Файл должен находиться в согласованном каталоге элементов. Это не штатная привязка через флажок «Статичный», а другой способ загрузки.
Пути и остальные варианты разобраны в статье о файловых элементах pdoTools. Для основной практики текущего урока переходить в файлы не нужно.
Использование чанка из PHP-сниппета
Дополнительный пример после знакомства со сниппетами
Чанк часто служит шаблоном результата сниппета. Вместо сборки HTML внутри PHP передаем данные в getChunk().
Пример для serviceCard со стандартными плейсхолдерами. Код вставляется в сниппет без открывающего PHP-тега:
$services = [
[
'title' => 'Подготовка материалов',
'text' => 'Оформляем тексты и изображения для публикации.',
],
[
'title' => 'Поддержка сайта',
'text' => 'Проверяем страницы и обновляем содержание.',
],
];
$output = '';
foreach ($services as $service) {
$output .= $modx->getChunk('serviceCard', $service);
}
return $output;
Каждый ключ массива становится плейсхолдером внутри чанка. Один элемент оформления используется для всех записей.
Пример не делает запросов к базе и не создает реальные услуги: данные заданы в учебном массиве. Получение ресурсов и другие источники изучаются отдельно.
Не путайте стандартный $modx->getChunk() в PHP с обработкой через pdoTools. Одинаковое название метода не делает все режимы идентичными.
Как разумно делить оформление
Чанк полезен, если разметка повторяется, получает разные данные или представляет самостоятельную часть страницы.
Не нужно выносить каждый тег ради количества элементов. Но и правило «выносить только то, что когда-нибудь изменится» слишком узкое: карточка списка может не меняться годами и все равно быть подходящим чанком.
Сначала добивайтесь понятной структуры. Скорость проверяйте по реальной обработке, а не по числу элементов или обещанию, что один способ всегда быстрее другого.
Дополнительная практика: общий tpl, чанки tpl.ID и наследование Fenom
Ниже сохранена авторская схема из прежних уроков — так я делал раньше. Это отдельный способ организации готового оформления, а не обязательное продолжение базового упражнения.
Для него нужен рабочий HTML-макет. Выполняйте перенос на учебной копии и сохраните исходный код. Если оформление уже подключено к MODX, переносите текущую версию с полями и исправленными путями, а не чистый файл из архива дизайна.
Переносим общий код в tpl
- Создайте чанк tpl.
- Скопируйте в него полный текущий код используемого шаблона.
- Сохраните чанк.
- В записи шаблона замените полный код одним вызовом tpl.
[[$tpl]]
На Fenom:
{include 'tpl'}

После сохранения проверьте страницу: само перемещение кода не должно менять ее вид.
Отделяем различающееся содержание
Определите ID назначенного шаблона. Для проверки можно временно вывести поле template:
[[*template]]
Не путайте его с ID ресурса. Если ID шаблона равен 1, создайте чанк tpl.1; если 5 — tpl.5.
Вырежьте из tpl центральную часть, которая различается у типов страниц, и перенесите в этот чанк. Например, у макета с main можно оставить обертку в общем tpl, а ее внутреннее содержимое перенести в tpl.ID.
На месте вырезанной части:
[[$tpl.[[*template]]]]
На Fenom:
{include ('tpl.' ~ $_modx->resource.template)}

Границы выбираются по фактическому HTML. Если в вашем дизайне нет main, не нужно искать несуществующий тег или вырезать блоки по чужим номерам строк.
Шапка, подвал, стили, скрипты и закрывающие теги должны остаться на своих местах. Не переносите открывающую обертку в один элемент, а ее закрытие в другой без понимания структуры.
Как схема используется у разных типов страниц
В записях назначаемых шаблонов находится общий вызов tpl. Он определяет ID открытого шаблона и подключает соответствующее содержание: tpl.1, tpl.2 и так далее.

Это не отдельный чанк для каждого ресурса. Несколько обычных страниц могут использовать один шаблон, один tpl.ID и разные значения своих полей.
Для каждого используемого ID должен существовать соответствующий чанк. Схема не создает отсутствующие элементы автоматически.
Альтернатива: наследование Fenom через админку
Если выбрали наследование, общий каркас можно хранить в базовом шаблоне base, а различающееся содержание — в дочернем home.
- Сохраните копию полного рабочего кода.
- Создайте или подготовьте шаблон base с общей разметкой.
- На месте меняющейся части объявите блок content.
{block 'content'}{/block}

Создайте обычный шаблон home:
{extends 'template:base'}
{block 'content'}
<h1>{$_modx->resource.pagetitle | escape}</h1>
{$_modx->resource.content}
{/block}
Здесь показан небольшой работающий вариант центральной части. Для готового дизайна вместо этих двух строк переносится его нужная разметка с подключенными данными.

Назначьте home нужному ресурсу и проверьте результат. Префикс template: обращается к шаблону MODX с именем base, а не к файлу.
Эта альтернатива не требует сначала выполнять всю схему tpl.ID. Выбирайте один способ организации. Наследование также не делает чанки ненужными: повторяемые карточки и другие фрагменты могут использоваться дальше.
Если на странице виден вызов Fenom

Проверьте обработку Fenom в месте вызова. Для кода шаблона страницы и чанков pdoTools действуют разные настройки.

Это снимок из исходной редакции, а не инструкция повторить все значения. Для показанных конструкций не требуется включать расширенные разрешения pdotools_fenom_php и pdotools_fenom_modx.
Настройку проверяйте по уроку Fenom и своей версии pdoTools.
Ошибки компиляции и фигурные скобки
Сначала прочитайте актуальную запись в журнале MODX после запроса страницы.

Причиной может быть имя элемента, незакрытая конструкция Fenom, inline JavaScript или другая ошибка PHP. Не всякая белая страница связана со скобками.
![]()
В прежнем примере показывалась правка пробелами. Не меняйте так весь JavaScript механически. Статичный inline-код можно отделить через ignore, а динамические вставки нужно подготовить с учетом обработки шаблона.

Если содержимое обрабатывается повторно, проверьте цепочку подключений: обертка ignore первого прохода может уже отсутствовать. Не исправляйте это бесконечным добавлением вложенных оберток.
Перед продолжением проверьте также поля страницы, стили, изображения, скрипты и отсутствие дублирующихся оберток документа.
Если чанк не выводится
| Проблема | Что проверить |
|---|---|
| Вместо блока пустое место | Существование и имя чанка, знак доллара в стандартном вызове, сохранение кода. |
| Параметр пуст | Совпадение имени параметра и плейсхолдера, обратные кавычки и переданное значение. |
| Везде одинаковые данные | Не заменены ли параметры прямыми вызовами полей текущего ресурса. |
| Изменения не видны | Нужный элемент, назначенный ресурсу шаблон, сохранение и кеш. |
| Виден сам вызов | Обычные скобки вместо HTML-сущностей и обработку выбранного синтаксиса. |
Для проверки временно оставьте в чанке одну обычную фразу. Если она появилась, подключение работает, а причину нужно искать в данных или внутренних вызовах.
Следующий урок
Дальше переходим к сниппетам MODX: разберем выполнение PHP, параметры и возврат результата. Большую практику разбиения готового дизайна можно оставить до соответствующего этапа сборки сайта.











