MODx/Встроенные сниппеты/Breadcrumb

Информация

Назначение: Breadcrumbs (англ. «Хлебные крошки») — элемент навигации по сайту, представляющий собой путь по сайту от его «корня» до текущей страницы, на которой находится пользователь.

Действие: представляет собой полосу в верхней части страницы примерно такого вида:

Главная страница → Раздел → Подраздел → Текущая страница

Параметры

• &maxCrumbs [number] — максимальное число показанных уровней иерархии, не считая корень и текущую страницу. «Лишние» промежуточные уровни заменяются многоточием.
• &pathThruUnPub [ 1 | 0 ] — показывать полностью все папки пути, кроме «непубликуемых», или только часть иерархии ниже нижней «непубликуемой»
• &respectHidemenu [ 1 | 0 ] — скрывать уровни с установленным атрибутом «не показывать в меню» (по умолчанию — 1)
• &showHomeCrumb [ 1 | 0 ] — показывать корень иерархии («домашнюю» страницу) (по умолчанию — 1)
• &showCrumbsAtHome [ 1 | 0 ] — показывать на корневой странице (по умолчанию — 0)
• &showCurrentCrumb [ 1 | 0 ] — показывать текущую страницу (по умолчанию — 1)
• &currentAsLink [ 1 | 0 ] — показывать текущую как ссылку (по умолчанию — 0)
• &crumbSeparator [string] — строка-разделитель (по умолчанию — »)
• &homeCrumbTitle [string] — имя корневой страницы (по умолчанию — ‘Home’)
• &homeCrumbDescription [string] — описание ссылки на корневую страницу (по умолчанию = $homeCrumbTitle)
• &titleField [string] — какое поле страницы использовать в качестве «крошки» (по умолчанию — ‘pagetitle’)
• &descField [string] — какое поле использовать в качестве описания ссылки (по умолчанию — ‘description’), если поле пустое, используется ‘pagetitle’
• &homeId [number] — id главной страницы (по умолчанию — ‘site_start’)

Вызов

[[Breadcrumbs? параметры]]

Пример

[[Breadcrumbs? &homeCrumbTitle=`Главная` &homeCrumbDescription=`На главную страницу`]]

Примечание

При использовании Friendly URL в шаблон необходимо включить строку:

<base href="[(site_url)]" />