PdoCrumbs

Опубликовано: 15.07.2018

видео pdoCrumbs

MODX Revolution урок 7 MODX Revolution Вывод хлебных крошек PdoCrumbs

Сниппет для построения навигации в стиле хлебных крошек.

Хорошо заменяет BreadCrumb , работает с документами из любых контекстов и позволяет указывать различные условия для выборки ресурсов.


Дополнение pdoCrumbs MODX Revolution создание хлебных крошек на сайте

Сниппет обладает очень высокой скоростью работы, за счет выборки всех нужных элементов из БД за один запрос.

Параметры

Принимает все параметры pdoTools и некоторые свои:

Параметр По умолчанию Описание
&showLog 0 Показывать дополнительную информацию о работе сниппета. Только для авторизованных в контекте «mgr».
&from 0 Id ресурса, от которого строить хлебные крошки. Обычно это корень сайта, то есть «0».
&to Id ресурса для которого строятся хлебные крошки. По умолчанию это id текущей страницы.
&exclude Список id ресурсов, которые нужно исключить из выборки.
&toPlaceholder Если не пусто, сниппет сохранит все данные в плейсхолдер с этим именем, вместо вывода не экран.
&outputSeparator \n Разделитель между крошками
&tpl Имя чанка для оформления ресурса. Если не указан, то содержимое полей ресурса будет распечатано на экран.
&tplCurrent Чанк оформления текущего документа в навигации.
&tplMax Чанк, который добавляется в начало результатов, если их больше чем &limit .
&tplHome Чанк оформления ссылки на главную страницу.
&tplWrapper Чанк-обёртка, для заворачивания всех результатов. Понимает один плейсхолдер: [[+output]]. Не работает вместе с параметром &toSeparatePlaceholders .
&wrapIfEmpty Включает вывод чанка-обертки &tplWrapper даже если результатов нет.
&showCurrent 1 Выводить текущий документ в навигации.
&showHome 0 Выводить ссылку на главную в начале навигации.
&showAtHome 1 Показывать хлебные крошки на главной странице сайта.
&hideSingle 0 Не выводить результат, если он один единственный.
&direction ltr Направление навигации: слева направо «ltr» или справа налево «rtl», например для Арабского языка.

Шаблоны

Шаблон По умолчанию
&tpl @INLINE <li><a href="[[+link]]">[[+menutitle]]</a></li>
&tplCurrent @INLINE <li class="active">[[+menutitle]]</li>
&tplMax @INLINE <li class="disabled">&nbsp;...&nbsp;</li>
&tplHome
&tplWrapper @INLINE <ul class="breadcrumb">[[+output]]</ul>

Примеры

Генерация хлебных крошек для текущей страницы:


Создание хлебных крошек в MODX

[[pdoCrumbs]]

Генерация в ограничением по количеству пунктов:

[[pdoCrumbs? &limit=`2` ]]

Сниппет хорошо работает при вызове из pdoResources. Например, вот такой чанк:

<h3>[[+pagetitle]]</h3> <p>[[+introtext]]</p> [[pdoCrumbs? &to=`[[+id]]` &showCurrent=`0` ]]

Демо

Рабочий пример генерации хлебных крошек в результатах поиска mSearch2.