pdoCrumbs как замена Breadcrumb
Данные сниппеты строят путь от корня сайта к текущему ресурсу. Но рекомендуемым к использованию является сниппет pdoCrumbs, среди преимуществ которого отмечу гибкость, работу с различными контекстами и наименьшее количество запросов при обращении к базе данных.
Даже если не указывать никаких параметров, сниппет всё равно будет работать, поскольку много информации для его работы по сути и не требуется. Для остальных случаев есть:
Основные параметры
| Breadcrumb (значение по умолчанию) | pdoCrumbs (значение по умолчанию) | Применение |
|---|---|---|
|
&from=`0` |
&from=`0` |
Ресурс, от которого будут строиться хлебные крошки. |
|
&to=`[[*id]]` |
&to=`[[*id]]` |
Ресурс, к которому будет строиться путь из хлебных крошек. |
|
&exclude=`` |
&exclude=`` |
ID ресурсов через запятую, которые будут исключены из вывода. |
| &maxCrumbs=`100` |
&limit=`0` |
Максимальное количество элементов для вывода. |
| &showHidden=`0` |
&showHidden=`0` |
Показывать ли скрытые пункты меню в хлебных крошках. |
| &showContainer=`1` |
&hideContainers=`0` |
Включать ли в цепочку ресурсы, которые являются родительскими или у которых отмечена галочка "Контейнер". Как pdoCrumbs, так и Breadcrumb по умолчанию такие ресурсы показывают. |
| &showUnPub=`1` |
&showUnpublished=`0` |
Включать ли в цепочку ресурсы, которые являются неопубликованными. |
| &showCurrentCrumb=`1` |
&showCurrent=`1` |
Показывать ли в хлебных крошках текущий ресурс. |
| &showBreadCrumbAtHome=`1` |
&showAtHome=`1` |
Показывать ли хлебные крошки на главной странице. |
| &showHomeCrumb=`1` |
&showHome=`0` |
Включать ли главную страницу в цепочку из хлебных крошек. |
| &useWebLinkUrl=`1` |
&useWeblinkUrl=`1` |
Учитывать ли класс ресурса при формировании ссылки. Значение 0 обычно используется, если класс ресурса является отличным от стандартного. Например, ресурс типа "символическая ссылка". |
| &direction=`ltr` |
&direction=`ltr` |
Направление вывода хлебных крошек. По умолчанию - слева-направо. |
| &scheme=`-1` |
&scheme=`-1` |
Схема формирования адреса страницы. Все возможные варианты можно посмотреть здесь https://docs.modx.com/current/en/extending-modx/modx-class/reference/modx.makeurl |
Параметры шаблонов
| Breadcrumb (значение по умолчанию) | pdoCrumbs (значение по умолчанию) | Применение |
|---|---|---|
| &containerTpl | &tplWrapper |
Имя чанка для обёртки пунктов хлебных крошек. |
| &homeCrumbTpl | &tplHome |
Имя чанка главной страницы. |
| ¤tCrumbTpl | &tplCurrent |
Имя чанка текущей страницы. |
| &linkCrumbTpl | &tpl |
Имя чанка для любого элемента. |
| &maxCrumbTpl | &tplMax |
Имя чанка, который будет выводиться в том случае, если количество результатов превышено. Зависит напрямую от свойств maxCrumbs (Breadcrumb) и limit (pdoCrumbs). |
Вы должны авторизоваться, чтобы оставлять комментарии.
Комментарии ()