Главная

Документация Синтаксис
Документация Шаблонизатор Fenom
Документация на русском
Файловые элементы
Работа с MODX из IDE без админки
Тестирование производительности
расширение pdoTools Шлоков
Репозиторий:
Packagist.org:
Документация:
Баг трекер:
MODX Revolution встречает Fenom
https://my-priv.ru/blog/zametki/shablonizator-fenom-modx.html

https://docs.modx.pro/komponentyi/pdotools/parser

Modx + Fenom. Шпаргалки

Файловые элементы

Документация

Шаблонизатор Fenom – это надстройка для MODX Revo, включённая в состав пакета pdoTools. Позволяет полностью заменить "родные" теги MODX с увеличением скорости и удобства работы с информацией из таблиц базы данных и значительно расширить возможности шаблонизации.

Для тех, кто начинал изучение MODX по официальной документации, поначалу работа с Fenom может показаться неудобной и более сложной, а, открыв первый раз сайт на Fenom, вообще не сообразить, что и как работает.
Это быстро проходит) и, возвращаясь при необходимости к стандартным тегам, начинает не хватать возможностей парсера pdoTools.
Включение Fenom
Для того, чтобы теги Fenom начали обрабатываться в шаблонах, чанках и тексте ресурса, нужно включить следующие настройки: Системные настройки - pdotools:
На обработку шаблонизатором влияют следующие системные настройки:
pdotools_fenom_default -
включает обработку через Fenom чанков pdoTools. Включено по умолчанию.
pdotools_fenom_parser -
включает обработку шаблонизатором всех страниц сайта. То есть, не только чанков, но и шаблонов.
pdotools_fenom_php -
включает поддержку PHP функций в шаблонизаторе. Очень опасная функция, так как любой менеджер получит доступ к PHP прямо из чанка.
pdotools_fenom_modx -
добавляет системные переменные { $modx } и { $pdoTools } в шаблоны Fenom. Тоже очень опасно - любой менеджер может управлять объектами MODX из чанков.
pdotools_fenom_options -
JSON строка с массивом настроек согласно официальной документации. Например:
pdotools_fenom_cache -
кэширование скопмилированных шаблонов. Имеет смысл только для сложных чанков на рабочих сайтах, по умолчанию отключено.
Итак, по умолчанию Fenom включен для работы только в чанках, которые проходят через pdoTools. Это вполне безопасно и менеджеры системы не получают никаких дополнительных возможностей, кроме более удобного синтаксиса и высокой скорости работы.
Включение pdotools_fenom_parser позволяет использовать синтаксис Fenom прямо в контенте документов и шаблонах страниц, но есть один нюанс - шаблонизатор может неверно реагировать на фигурные скобочки, которые в MODX очень любят.
В таких случаях автор рекомендует использовать тег { ignore }.
Если вы планируете включить Fenom глобально для всего сайта, вам нужно проверить, на всех ли страницах он нормально работает. Базовые понятия
Основные источники информации по работе с Fenom – в документации modx.pro и в исходной документации.