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)]" />