DLBuildMenu: документация, параметры, шаблоны

DLBuildMenu – сниппет для вывода меню сайта на Evolution CMS. Построен на основе ДокЛистера, по сути это сниппет-обертка с вызовом DocLister внутри – поэтому в нём можно использовать практически все параметры и фишки самого DocLister.

Применяя prepare, мы получаем неограниченные возможности подготовки данных. А развитая система шаблонизации ДокЛистер, дополненная в DLBuildMenu новыми параметрами, даёт в руки, на мой взгляд, даже чрезмерно богатый инструментарий.

Зависимости и требования

Для работы DLBuildMenu у вас должен быть установлен DocLister (есть в последних релизах MODx Evo по умолчанию).
Требуется PHP не ниже версии 5.3.

Установка

DLBuildMenu входит по умолчанию в новую кастомную сборку MODx Evo 1.2.1-d9.1.2 от 21.03.2017.
На более старых кастомных сборках и на официальной сборке для его установки нужно установить или переустановить ДокЛистер из Extras, при этом нужно, чтобы DLBuildMenu был отмечен галочкой в списке при установке.

Файлы

assets/snippets/DocLister/snippet.DLBuildMenu.php
assets/snippets/DocLister/lib/DLFixedPrepare.class.php (метод buildMenu)

Преимущества DLBuildMenu

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

Кроме того, в DLBuildMenu работают и другие фишки из арсенала ДокЛистер, описывать которые здесь не стану, для этого нужно изучать сам DL.