- Как записываются модификаторы
- Запасное значение: default
- Проверка на пустоту: empty и notempty
- Условия: is, then и else
- Сравнение чисел
- Условия И и ИЛИ
- Обрезка текста: limit и ellipsis
- Справочник основных модификаторов
- Условный вывод чанка и вложенные теги
- Модификатор результата сниппета
- Кеширование и модификаторы
- Как создать свой модификатор
- Форматирование дат
- Модификаторы для пользователей
- Если модификатор дает неожиданный результат
- Следующий шаг
Мы уже разобрали теги MODX и научились вызывать сниппеты с параметрами. Теперь рассмотрим обработку полученных значений: запасной текст, проверку заполнения, условия и сокращение строк.
В MODX Revolution эти возможности называются фильтрами или модификаторами вывода и встроены в ядро. Название PHx встречается в старых материалах по аналогии с MODX Evolution, но отдельное дополнение для примеров этого урока не требуется.
Практику выполняем стандартным синтаксисом на учебных страницах. Готовый дизайн не нужен. Настройку и подробный разбор Fenom пройдем отдельно.
Как записываются модификаторы
Модификатор добавляется после имени поля или элемента через двоеточие:
[[*pagetitle:htmlent]]
Если модификатору нужно значение, оно указывается в обратных кавычках:
[[*longtitle:default=`Запасной заголовок`]]
Несколько модификаторов образуют цепочку и выполняются слева направо:
[[*longtitle:default=`[[*pagetitle]]`:htmlent]]
Сначала выбирается longtitle или запасной pagetitle, затем результат экранируется для вывода как текст.
Модификатор меняет результат вывода, а не значение, сохраненное в админке. Например, ellipsis не сокращает само поле content в базе данных.
Фильтры могут применяться к полям ресурсов, TV, плейсхолдерам, чанкам и результатам сниппетов. Но сначала убедитесь, что источник данных существует и содержит ожидаемое значение.
Запасное значение: default
Выведем расширенный заголовок longtitle, а если он не заполнен — основной pagetitle:
<h1>[[*longtitle:default=`[[*pagetitle]]`:htmlent]]</h1>
- Откройте один из учебных ресурсов и посмотрите назначенный ему шаблон.
- В этом шаблоне замените существующий h1 приведенным кодом и сохраните. Второй h1 добавлять не нужно.
- Вернитесь к тому же ресурсу, заполните расширенный заголовок и сохраните.
- Откройте страницу: в заголовке должно появиться значение longtitle.
- Очистите longtitle, сохраните ресурс и проверьте, что теперь выводится pagetitle.
default удобен для текстовых запасных значений. Если у числового поля 0 имеет самостоятельный смысл, проверяйте его явно, а не заменяйте такую проверку условием «пусто».
Проверка на пустоту: empty и notempty
Модификаторы default и empty позволяют подставить значение при пустом исходном поле. notempty делает обратное: выводит указанное содержимое, когда исходное значение не пусто.
Например, нужно вывести описание страницы только при заполненном поле description:
[[*description:notempty=`
<p class="page-description">[[*description:htmlent]]</p>
`]]
Проверяется поле description. Если оно заполнено, выводится весь абзац; если нет — абзац не появляется.
Для meta description применяется тот же принцип. Этот код размещается в head шаблона:
[[*description:notempty=`<meta name="description" content="[[*description:htmlent]]">`]]
Перед добавлением проверьте, нет ли в шаблоне уже существующего meta description. Не создавайте два одинаковых метатега.
Если проверяете дополнительное поле TV, замените description его техническим именем. Само TV должно быть создано и доступно для используемого шаблона.
У notempty есть синоним !empty. Важно различать два случая: восклицательный знак после открывающих скобок управляет кешированием, а !empty после двоеточия — это название модификатора.
Условия: is, then и else
Условие состоит из проверяемого значения, сравнения и результата:
[[*id:is=`[[++site_start]]`
:then=`Главная страница`
:else=`Внутренняя страница`
]]
- *id — ID текущего ресурса.
- site_start — ID главной страницы из настроек.
- is — проверка равенства.
- then — результат при выполненном условии.
- else — результат в противном случае.
Так мы не предполагаем, что главная обязательно имеет ID 1.
Для сравнения с конкретным ресурсом можно указать число:
[[*id:is=`7`:then=`Страница с ID 7`:else=`Другая страница`]]
7 — пример. При использовании замените его своим ID.
Сравнение чисел
Для числового плейсхолдера используются такие проверки:
[[+numbooks:gt=`0`:then=`Книги в наличии`:else=`Книг нет`]]
numbooks здесь должен содержать количество книг, переданное сниппетом или другим кодом. ID страницы не подходит для проверки наличия товара.
Условия И и ИЛИ
ИЛИ: значение равно 7 или 8.
[[+numbooks:is=`7`:or:is=`8`
:then=`Здесь 7 или 8 книг`
:else=`Другое количество`
]]
И: значение строго больше 7 и строго меньше 10.
[[+numbooks:gt=`7`:and:lt=`10`
:then=`Здесь 8 или 9 книг`
:else=`Количество вне этого диапазона`
]]
Если нужно включить границы диапазона, используйте gte и lte. Строгие сравнения gt и lt границы не включают.
Обрезка текста: limit и ellipsis
limit ограничивает длину строки, а ellipsis сокращает длинный текст и добавляет многоточие. Значение задается по длине текста, а не по количеству слов.
Для анонса из HTML-содержимого сначала уберите теги и лишние пробелы, затем сократите текст:
[[*content:strip_tags:strip:ellipsis=`150`:htmlent]]
Последовательность здесь важна:
- strip_tags убирает HTML-теги.
- strip сводит переносы, табуляции и повторяющиеся пробелы к обычным пробелам.
- ellipsis сокращает текст при превышении заданной длины.
- htmlent подготавливает результат для вывода как текста.
Запись ellipsis=`30` не означает 30 слов. Для ограничения по словам нужен другой алгоритм или пользовательский модификатор.
Не обрезайте готовую HTML-разметку через limit или ellipsis без подготовки: можно разорвать тег или оставить незакрытый элемент.
Для аккуратного анонса обычно удобнее заполненное поле introtext:
[[*introtext:strip_tags:strip:ellipsis=`150`:htmlent]]
Справочник основных модификаторов
Ниже сгруппированы полезные варианты. Примеры с плюсом работают с плейсхолдерами: их значения должны быть переданы в чанк или установлены другим кодом.
Условия и проверки
| Модификатор | Назначение | Пример |
|---|---|---|
| is, eq, equals | Равно указанному значению | [[+count:is=`7`:then=`Да`:else=`Нет`]] |
| ne, neq, isnt, isnot | Не равно | [[+count:ne=`7`:then=`Да`:else=`Нет`]] |
| gt | Строго больше | [[+count:gt=`7`:then=`Больше семи`]] |
| gte | Больше или равно | [[+count:gte=`7`:then=`Семь или больше`]] |
| lt | Строго меньше | [[+count:lt=`7`:then=`Меньше семи`]] |
| lte | Меньше или равно | [[+count:lte=`7`:then=`Семь или меньше`]] |
| contains | Содержит указанную подстроку | [[+title:contains=`MODX`:then=`Найдено`]] |
| containsnot | Не содержит указанную подстроку | [[+title:containsnot=`MODX`:then=`Не найдено`]] |
| in | Значение входит в список | [[*id:in=`5,15,22`:then=`Да`:else=`Нет`]] |
| default, ifempty, empty, isempty | Запасное значение при пустом исходном | [[+name:default=`Гость`]] |
| notempty, !empty, ifnotempty, isnotempty | Указанное содержимое при непустом исходном | [[+name:notempty=`Имя заполнено`]] |
| hide | Скрывает исходное значение при выполненном условии | [[+count:lt=`1`:hide]] |
| show | Показывает исходное значение при выполненном условии | [[+count:gt=`0`:show]] |
| input | Подменяет входное значение для следующей обработки | [[*id:input=`[[+count]]`:gt=`0`:then=`Есть`]] |
then и else задают ветки результата, and и or связывают проверки. if используется для дополнительного условия, в том числе с другим входным значением:
[[*id:gt=`0`:and:if=`[[*template]]`:gt=`0`
:then=`Ресурс существует и использует шаблон`
:else=`Условие не выполнено`
]]
Чем сложнее цепочка, тем важнее проверять ее на всех вариантах данных. Не пытайтесь выразить всю логику страницы одним тегом.
Строки и обработка текста
| Модификатор | Назначение | Пример |
|---|---|---|
| cat | Добавляет текст после значения | [[+count:cat=` книг`]] |
| before, prepend | Добавляет текст перед непустым значением | [[+count:before=`Количество: `]] |
| after, append | Добавляет текст после непустого значения | [[+count:after=` шт.`]] |
| lcase, lowercase, strtolower | Нижний регистр | [[+title:lcase]] |
| ucase, uppercase, strtoupper | Верхний регистр | [[+title:ucase]] |
| ucfirst | Заглавная первая буква строки | [[+title:ucfirst]] |
| ucwords | Заглавные первые буквы слов | [[+title:ucwords]] |
| htmlent, htmlentities | Преобразует специальные символы в HTML-сущности | [[+title:htmlent]] |
| esc, escape | Экранирует специальные символы, включая скобки тегов MODX | [[+text:escape]] |
| strip | Убирает лишние пробелы, переносы и табуляции | [[+text:strip]] |
| stripString | Удаляет указанную подстроку | [[+name:stripString=`Mr.`]] |
| replace | Заменяет одну подстроку другой | [[+title:replace=`старое==новое`]] |
| strip_tags, striptags, notags | Удаляет HTML-теги | [[+text:strip_tags]] |
| len, length, strlen | Возвращает длину строки | [[+text:len]] |
| limit | Ограничивает длину строки | [[+text:limit=`50`]] |
| ellipsis | Сокращает длинную строку с многоточием | [[+text:ellipsis=`150`]] |
| nl2br | Преобразует переносы строк в HTML-теги br | [[+text:htmlent:nl2br]] |
| wordwrap | Добавляет переносы по заданной ширине без разбиения слов | [[+text:wordwrap=`80`]] |
| wordwrapcut | Добавляет переносы с возможным разбиением длинных слов | [[+text:wordwrapcut=`80`]] |
| reverse, strrev | Переворачивает строку | [[+text:reverse]] |
| urlencode | Кодирует значение для передачи в параметре URL | [[+query:urlencode]] |
| urldecode | Декодирует значение URL | [[+query:urldecode]] |
strip_tags не является полноценной защитой от опасного HTML. Экранирование также выбирается под место вывода: HTML-текст, атрибут, URL и JavaScript требуют разного подхода.
Для работы с кириллицей проверяйте результат на своей версии MODX и окружении. Не считайте любой строковый модификатор гарантированно одинаковым для всех кодировок.
Числа и дополнительные преобразования
| Модификатор | Назначение | Пример |
|---|---|---|
| add, increment, incr | Прибавляет число | [[+count:add=`2`]] |
| subtract, decrement, decr | Вычитает число | [[+count:subtract=`1`]] |
| multiply, mpy | Умножает | [[+count:multiply=`3`]] |
| divide, div | Делит; делитель не должен быть нулем | [[+count:divide=`2`]] |
| modulus, mod | Остаток от деления | [[+count:mod=`2`]] |
| md5 | Создает MD5-хеш строки | [[+text:md5]] |
| cdata | Оборачивает результат в CDATA | [[+text:cdata]] |
| tag | Выводит исходную запись тега без модификатора tag | [[*pagetitle:tag]] |
MD5 не используйте для хранения паролей. Это не подходящий пример применения данного модификатора.
Оборачивание в CDATA не заменяет корректную подготовку XML. А tag не нужно считать универсальным способом безопасно показать любой вложенный код в статье.
Условный вывод чанка и вложенные теги
Допустим, чанк carusel нужно показывать только на главной. Прямой вариант выглядит так:
[[*id:is=`[[++site_start]]`:then=`[[$carusel]]`]]
Но вложенный вызов чанка может обработаться до выбора результата внешнего условия. Поэтому нельзя считать then гарантией того, что код внутри чанка не выполняется на других страницах.
Если в чанке только небольшой HTML, это одна ситуация. Если внутри находятся запросы, сниппеты и регистрация скриптов, порядок обработки становится существенным.
Для стандартного синтаксиса можно сначала сформировать вызов нужной ветки, а затем обработать его:
[[[[*id:is=`[[++site_start]]`:then=`$carusel`:else=`-`]]]]
На главной внутреннее условие дает $carusel, и получается вызов чанка. На остальных страницах формируется комментарий. Сам вызов carusel не находится внутри значения then как вложенный тег.
Это не означает «нулевую нагрузку» и не отменяет проверку самого чанка. Способ обработки и кеширование его содержимого нужно учитывать отдельно.
Не усложняйте запись частями имени вроде caru и sel. Если условие становится трудно читать, выделите логику в сниппет или позже используйте подходящую конструкцию Fenom. Здесь важно понимать порядок обработки вложенных вызовов.
Модификатор результата сниппета
У сниппета модификатор записывается после имени и перед знаком вопроса. Параметры вызова идут дальше:
[[pdoResources:default=`Ничего не найдено`?
&parents=`2,3,4,8`
&limit=`7`
]]
В этом примере default обрабатывает результат pdoResources, а parents и limit остаются параметрами сниппета.
ID приведены для примера. Сам pdoResources должен быть установлен с pdoTools. Настройку списка ресурсов разберем в соответствующем уроке.
Если сниппет выводит данные, меняющиеся от запроса к запросу, выбирайте подходящий режим кеширования. Сам факт наличия default не требует добавлять ! ко всем вызовам.
Кеширование и модификаторы
Восклицательный знак сразу после открывающих скобок делает вызов некешируемым:
[[!snippetName]]
[[!+result:default=`Значение пока не получено`]]
Если некешируемый сниппет устанавливает динамический плейсхолдер, его вывод также вызывайте некешируемым. Иначе плейсхолдер может обработаться раньше или сохранить неактуальное значение.
Удаление ! возвращает кешируемый режим, а не отключает кеширование.
Не ставьте ! перед каждым полем и чанком. Определяйте, что действительно должно обрабатываться при каждом запросе MODX. Этот знак не управляет кешем браузера, CDN или отдельным кешем компонента.
Как создать свой модификатор
Пользовательским модификатором может быть сниппет. Его имя указывается после двоеточия, как имя встроенного фильтра.
Сохраним простой пример: добавление восклицательных знаков к тексту.
- Откройте вкладку «Элементы» и раздел «Сниппеты».
- Создайте сниппет с именем makeExciting.
- Вставьте код ниже и сохраните.
Код для поля сниппета, без открывающего PHP-тега:
$text = (string) ($input ?? '');
$count = isset($options) ? (int) $options : 1;
$count = max(0, min(10, $count));
return $text . str_repeat('!', $count);
Вызов в шаблоне:
[[*pagetitle:makeExciting=`4`:htmlent]]
Если pagetitle содержит «Главная», результат будет «Главная!!!!».
Сниппет получает:
| Параметр | Назначение |
|---|---|
| input | Исходное значение тега |
| options | Значение после знака равенства у модификатора; в примере 4 |
| token | Тип исходного тега; в примере * |
| name | Имя исходного поля или элемента; в примере pagetitle |
| tag | Полная запись исходного тега |
Модификатор должен возвращать результат через return. Не выводите его через echo.
У стандартного механизма есть особенность: пустая строка из пользовательского фильтра может привести к возврату исходного значения. Поэтому не используйте return ''; как универсальный способ скрыть текст — задавайте условие вывода явно.
Пример ограничивает количество знаков десятью, чтобы случайный параметр не создавал огромную строку. Это учебная демонстрация, а не обязательная часть оформления сайта.
Форматирование дат
В старых примерах MODX используется модификатор date с форматом strftime:
[[+timestamp:date=`%d.%m.%Y`]]
Такой вызов ожидает Unix timestamp. Если исходное значение — текстовая дата, перед форматированием требуется преобразование:
[[+dateString:strtotime:date=`%d.%m.%Y`]]
Не добавляйте strtotime вслепую: сначала проверьте, получает тег число или текстовую дату.
В версиях MODX, где date вызывает PHP-функцию strftime(), на PHP 8.1+ возможно предупреждение Deprecated. Форматы strftime и PHP date отличаются: простая замена %d.%m.%Y на d.m.Y в старом встроенном модификаторе проблему не решает.
Не правьте ядро MODX ради одного вывода даты. Для числового формата можно создать пользовательский модификатор.
Модификатор formatDate без strftime
Создайте сниппет formatDate и вставьте следующий код без открывающего PHP-тега:
$value = trim((string) ($input ?? ''));
if ($value === '') {
return '';
}
$timestamp = preg_match('/^-?\d+$/D', $value)
? (int) $value
: strtotime($value);
if ($timestamp === false || $timestamp <= 0) {
return $value;
}
$format = isset($options) && $options !== ''
? (string) $options
: 'd.m.Y';
return date($format, $timestamp);
Пример вызова:
[[*publishedon:formatDate=`d.m.Y`]]
Сниппет принимает числовой timestamp или распознаваемую текстовую дату. Пустое значение не форматируется; при нераспознанном или неположительном timestamp возвращается исходное значение.
Здесь используется формат PHP date без знаков процента. Результат зависит от часового пояса PHP-окружения. Для русских названий месяцев и других локализованных форматов потребуется отдельное решение.
Дополнительные примеры находятся в статье о датах и времени в MODX.
Модификаторы для пользователей
Для данных текущего пользователя используйте некешируемые вызовы. Например, его ID и логин доступны через плейсхолдеры:
[[!+modx.user.id]]
[[!+modx.user.username:htmlent]]
Для проверки авторизации в текущем контексте используется isloggedin:
[[!+modx.user.id:isloggedin:is=`1`
:then=`Вы авторизованы`
:else=`Вы не авторизованы`
]]
userinfo получает поле пользователя по его ID. Например, полное имя:
[[!+modx.user.id:userinfo=`fullname`:htmlent]]
Такой вывод используйте там, где данные действительно нужны, например в защищенной области профиля. Не переносите в публичную разметку таблицу всех пользовательских полей.
memberof проверяет членство в группе:
[[!+modx.user.id:memberof=`Administrator`
:then=`Пользователь входит в группу`
:else=`Пользователь не входит в группу`
]]
Название группы должно соответствовать вашему сайту. Скрытие кнопки или блока таким условием не заменяет серверную проверку прав и защиту ресурса.
Не выводите пароль, его хеш, временный пароль или другие служебные учетные данные. Даже некешируемый тег не делает такой вывод безопасным.
Если модификатор дает неожиданный результат
- Сначала выведите исходный тег без цепочки и проверьте данные.
- Убедитесь, что используете поле со звездочкой или плейсхолдер с плюсом по назначению.
- Проверьте обратные кавычки и положение модификаторов перед знаком вопроса.
- Проверьте границы: gt отличается от gte, а lt — от lte.
- Для чисел проверяйте 0 отдельно, а не полагайтесь только на empty.
- Для HTML сначала определите, нужно ли сохранить разметку или вывести обычный текст.
- Для дат проверьте тип исходного значения, формат и версию окружения.
- Для динамических плейсхолдеров проверьте источник и кеширование.
- Для пользовательского фильтра убедитесь, что сниппет существует и возвращает результат.
При длинной цепочке добавляйте модификаторы по одному. Так проще найти шаг, после которого результат меняется неправильно.
Следующий шаг
Базовый блок MODX пройден. Переходим к дополнениям: разберем установщик пакетов, подключение репозитория и подготовим инструменты для учебной практики.
Затем подключим готовый HTML-шаблон Creative и на его блоках рассмотрим MIGX, Gallery, формы и другие выбранные компоненты. Нужные настройки будем разбирать по мере появления задач.
Подробную настройку нового проекта пройдем перед сборкой рабочего сайта на FlexStart. Этот практический курс будет отдельной последовательностью на Fenom, файловых элементах и PageBlocks.











