Сладкий синтаксис в Fenom

На просторах сообщества уже много раз поднималась тема расширяемости синтаксиса Fenom. В pdoTools для этого есть даже событие плагина pdoToolsOnFenomInit. В этой заметке предлагаю добавить некий синтаксический сахар для ещё более приятного использования классного шаблонизатора. Мы добавим подключение файлового чанка в шаблон таким образом

{chunk 'path/to/chunk'}

и вызов сниппета таким

{snippet 'pdoResources' ['param' => 'value']}

Плагин

Вешаем плагин на событие pdoToolsOnFenomInit

<?php
$pdoTools = $modx->getService('pdoTools');

// usage: {chunk 'path/to/chunk' ['param' => 'value']}
$fenom->addFunction('chunk', function (array $data) use ($pdoTools) {
    $name = '@FILE chunks/' . $data[0] . '.tpl';
    $properties = empty($data[1]) ? [] : $data[1];
    $pdoTools->debugParserModifier($name, 'chunk', $properties);
    $result = $pdoTools->getChunk($name, $properties);
    $pdoTools->debugParserModifier($name, 'chunk', $properties);

    return $result;
});

// usage: {snippet 'pdoResources' ['param' => 'value']}
$fenom->addFunction('snippet', function (array $data) use ($pdoTools) {
    $name = $data[0];
    $properties = empty($data[1]) ? [] : $data[1];
    $pdoTools->debugParserModifier($name, 'snippet', $properties);
    $result = $pdoTools->runSnippet($name, $properties);
    $pdoTools->debugParserModifier($name, 'snippet', $properties);

    return $result;
});

Как использовать

Создаём файл в core/elements/chunks/content/base.tpl с кодом чанка. Вызываем так:

{chunk 'content/base'}

Как видите, здесь только часть пути. Без chunks/ и расширения.

Как это работает

Для чанков, подключаемых таким способом, нужно соблюдать 2 условия. Они должны
1) Быть файловыми и лежать в /core/elements/chunks/
2) Иметь расширение .tpl

Со сниппетами думаю итак всё понятно.

Итого

Достаточно просто, не так ли? Таким образом можно добавить, что угодно! Например, у меня помимо этих кастомных функций, есть ещё несколько, которые я использую почти на всех сайтах. Дерзайте!

// pdoTools
{'pdoResources' | snippet : ['param' => 'value']}
// Твой вариант
{snippet 'pdoResources' ['param' => 'value']}