Главная
Документация Синтаксис
Документация Шаблонизатор Fenom
Документация на русском
Файловые элементы
Работа с MODX из IDE без админки
Тестирование производительности
расширение pdoTools Шлоков
Репозиторий: github.com/bzick/fenom
Packagist.org: packagist.org/packages/bzick/fenom
Composer: "fenom/fenom": "1.*"
Документация: github.com/bzick/fenom/blob/master/docs/readme.md
Баг трекер: github.com/bzick/fenom/issues
MODX Revolution встречает Fenom
https://my-priv.ru/blog/zametki/shablonizator-fenom-modx.htmlhttps://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 и в исходной документации.
Желательно сразу освоить файловые элементы (официальное руководство).