pdoTools3 для MODX3

Друзья!
Как вы все знаете (или почти все), @Mark Hamstra взял быка за рога и своим решением утвердил график выхода MODX3:

• 3.0.0-alpha3 – 27 октября
• 3.0.0-beta1 – 8 ноября
• 3.0.0-beta2 – 22 ноября
• 3.0.0-rc1 – 6 января 2022
• 3.0.0-rc2 – 17 января
• 3.0.0-pl – 31 января

Об этом недавно писал @Іван Клімчук. Пока всё идёт по графику и следующий релиз должен быть 6 января. Давайте поддержим Марка и поможем довести до логического завершения эту долгоиграющую историю. Это будет охренительный прорыв и даст новый толчок развитию MODX. Ведь многие из нас уже разочаровались увидеть при своей жизни MODX3.

Теперь по теме. Многие говорили, что для тестирования MODX3 им нужен адаптированный pdoTools, так как они ведут разработку исключительно с ним. Пару дней я назад выпустил новую версию этой библиотеки, предназначенную только для MODX3.

Список изменений получился такой

• Requires MODX 3.
• Requires PHP 7.2+.
• Refactored to use PSR-4 autoload.
• pdoTools snippet logs are stored now in the corresponding placeholder (#316).
• Added system setting «pdotools_filter_path».
• Removed anchor links in skip/empty templates (#303).
• Removed «nestedChunkPrefix» parameter.
• Removed the system settings «pdoTools.class», «pdotools_class_path», «pdoFetch.class» and «pdofetch_class_path».
• Removed the «setOption» Fenom modifier.
• Removed the snippet parameters «tplPath» and «elementsPath».

Итак, это версия исключительно для MODX3. А это значит, что она использует функционал MODX3. И в частности механизм контейнера зависимостей. И теперь получить, например, объект сервиса pdoTools можно так —

$modx->services->get('pdotools');

Также теперь для работы pdoTools требуется PHP версия не ниже 7.2. А классы имеют неймспейсы и загружаются по стандартам PSR-4. Базовое пространство имён — ModxPro\PdoTools.

Следующий важный момент — теперь все логи сниппетов будут писаться исключительно в плейсхолдер, а не в конец данных сниппета.

{'!pdoResources' | snippet : [
    ...,
    'showLog' => true,
]}
{'pdoResourcesLog' | placeholder}

Таким образом, не будет проблем в режиме, когда сниппет должен вернуть массив. Плюс плейсхолдер можно разместить в любом месте. Отсюда есть мысль про дебаг панель, чтобы можно было собирать эти данные в одном месте. Но это вопрос будущего.
Как нетрудно догадаться, название плейсхолдера образуется из название сниппета и суффикса Log.

В следующем пункте говорится о системной настройке «pdotools_filter_path». Она необходима для фильтрации путей файловых элементов, т.е. вырезает конструкцию "../". Эта конструкция дает большую гибкость при работе с файловыми элементами, но если что, позволяет админу держать под контролем свободу контент-менеджеров гулять по всему сайту.
Раз уж заговорили про файловые элементы, то хочу отметить, что теперь можно указывать любой путь в настройке «elements_path». Даже за пределами сайта (тут надо будет ещё помозговать). Раньше к файлу всегда добавлялся базовый путь сайта. Также можно указывать относительный путь к файловым элементам (относительно базового пути сайта) — "./elements/" => «путь/к/корню/сайта/elements».

Ещё поправлены ссылки в skip/empty шаблонах. Тег «a» заменён на «span». Это доработка Jako.

Убран параметр nestedChunkPrefix, так как с внедрением Fenom в этих конструкциях нет никакого смысла. Их давным-давно придумал Василий для большей гибкости, ибо стандартный шаблонизатор ограничен в возможностях. По-моему, в Tickets ещё можно найти чанки с такими плейсхолдерами.

По пунктам с системными настройками — они удалены за ненадобностью. Так как теперь автозагрузкой управляет композер, то нет нужды указывать пути к классам.

Ну и в конце говорится, что удалены задеприкейченные в прошлой версии возможности, позволяющие контент-менеджерам менять системные настройки и указывать любые пути прямо на странице сайта.

Я старался максимально внимательно проверить базовую функциональность. Но понятно, что всё-всё проверить невозможно. Поэтому нужна ваша помощь в этом. Особенно желательно, чтобы при тестировании использовались максимально близкие фичи с рабочих проектов.

Пакет уже есть на modstore.pro. Пока MODX3 можно тестировать только на локалке, но @Илья Уткин обещал в ближайшее время сделать доступной такую возможность и на modhost.pro на тестовом тарифе.

PHP notice: Undefined property: MODX\Revolution\modX::$service


Fatal error:  Uncaught Error: Call to a member function get() on null in /var/www/modx3beta2/www/core/cache/includes/elements/modx/revolution/modplugin/1.include.cache.php:7
Stack trace:
#0 /var/www/modx3beta2/www/core/src/Revolution/modScript.php(88): include()
#1 /var/www/modx3beta2/www/core/src/Revolution/modX.php(1706): MODX\Revolution\modScript->process()
#2 /var/www/modx3beta2/www/core/src/Revolution/Processors/System/ClearCache.php(48): MODX\Revolution\modX->invokeEvent()
#3 /var/www/modx3beta2/www/core/src/Revolution/Processors/Processor.php(189): MODX\Revolution\Processors\System\ClearCache->process()
#4 /var/www/modx3beta2/www/core/src/Revolution/modX.php(1771): MODX\Revolution\Processors\Processor->run()
#5 /var/www/modx3beta2/www/_easyComm/_build/build.transport.php(394): MODX\Revolution\modX->runProcessor()
#6 {main}
  thrown in /var/www/modx3beta2/www/core/cache/includes/elements/modx/revolution/modplugin/1.include.cache.php on line 7

<ul class="test">
    {'!pdoMenu' | snippet : [
        'parents' => 0,
        'level' => 2,
        'tplOuter' => '@INLINE {$wrapper}',
        '-tplParentRow' => '@INLINE <li class="submenu_wrapp {$classnames}"><a href="{$link}" {$attributes}>{$menutitle}</a><ul>{$wrapper}<ul></li>'
    ]}
    <li>
        <a href="#">Заказ звонка</a>
    </li>
</ul>