VS-engine

CMF ModX Breadcrumbs - хлебные крошки

Breadcrumbs – это простой навигационный сниппет для MODx Revolution

Что такое Breadcrumbs?

Breadcrumbs – это простой навигационный сниппет для MODx Revolution. С его помощью Вы можете легко добавить простую навигационную цепочку в любом месте Вашей страницы.

Требования

• MODx Revolution 2.0.0-beta5 или более новая версия

• PHP5 или более новая версия

История

Breadcrums появился примерно в одно время с MODx 0.9.1, или MODx Evolution, первый релиз состоялся 30 июня 2006 года. С момента создания сниппета уже много разных авторов приложили руку к его усовершенствованию.

Официальные релизы

Версия Дата Автор Продукт
1.1-beta3 23 ноября 2009 года splittingred Revolution
1.1-beta2 5 ноября 2009 года splittingred Revolution
1.1-beta1 21 мая 2009 года splittingred Revolution
1.0-alpha4 21 апреля 2009 года splittingred Revolution
1.0-alpha3 24 марта 2009 года splittingred Revolution
1.0.1 25 апреля 2008 года jaredc Evolution
1.0.0 22 апреля 2008 года jaredc Evolution
0.9g 26 марта 2008 года webe Evolution
0.9f 17 января 2008 года Jaredc Evolution
0.9e 11 января 2008 года Jaredc Evolution
0.9d 12 июля 2006 года Jaredc Evolution
0.91 10 июля 2006 года tillda Evolution
0.9c 30 июня 2006 года jaredc Evolution

Скачивание

Сниппет можно загрузить в рамках менеджера MODx Revolution с помощью Package Management, или с MODx Extras Repository.

Использование

Сниппет Breadcrumbs вызывается через теги:

[ [Breadcrumbs] ]

Свойства Breadcrumbs

Имя Описание По умолчанию
crumbSeparator Определяет то, что Вам нужно, между «крошками» (crumbs). »
currentAsLink Если Вы хотите, чтобы crumb текущей страницы был ссылкой (на себя) – "1" для true, "0" для false (без кавычек) true
descField Чтобы изменить по умолчанию использование поля страницы в качестве описания навигационной цепочки, по умолчанию – description. Если description пуст, возвращается к pagetitle. description
homeCrumbDescription В случае, если Вы хотите иметь настраиваемый description домашней ссылки. По умолчанию – тайтл домашней ссылки. Home
homeCrumbTitle В случае, если Вы хотите иметь домашнюю ссылку, вызывающую что-то другое. Home
maxCrumbs Максимальное количество элементов в цепочке. 100 –произвольно большое количество. Если Вы выберете меньшее значение, скажем 2 (при этом есть 5 уровней глубины), она будет выглядеть так: Home> ... > Уровень 4> Level 5. Следует отметить, что " Home" и текущая страница не принимаются в рассчет. Каждая из них настраивается отдельно. 100
maxDelimiter Строка, которая будет выводится, если максимальное количество элементов цепочки было показано. ...
pathThruUnPub Когда Ваш путь включает в себя неопубликованную папку, установка true покажет все ресурсы пути, кроме неопубликованных. Пример пути (неопубликованные заглавными): home > news > CURRENT > SPORTS > skiiing > article $pathThruUnPub = true. Отсюда: home > news > skiiing > article $pathThruUnPub = false. Отсюда:  home > skiiing > article  (если Ваш home crumb включен) true
respectHidemenu Если true, будут скрываться элементы в навигационной цепочке, которые, согласно установок, скрываются в и меню. true
showCrumbsAtHome Можно использовать для переключения breadcrumb-ов на главной странице. false
showCurrentCrumb Показывает текущую страницу в виде пути. true
showHomeCrumb Хотите, чтобы Ваша crumb-строка начиналась ссылкой на home? Некоторые не будут, потому что домашняя ссылка обычно находится в лого сайта или другом месте схемы навигации. true
titleField Чтобы изменить поля страницы по умолчанию, используется в качестве тайтла breadcrumb. По умолчанию pagetitle. pagetitle

Классы breadcrumb-ов

Выводится неупорядоченный список с микроданными (см. http://diveintohtml5.info/extensibility.html для получения дополнительной информации), которые можно стилизировать, используя следующие имена классов.

Classname (имя класса) Описание
B_crumbBox Span, который окружает все выводимые crumb-ы
B_hideCrumb Span, который окружает "...", если crumb-ов больше, чем будет показано
B_currentCrumb Span или A-тег, окружающий текущий crumb
B_firstCrumb Span, который всегда окружает первый crumb, "home" это или нет
B_lastCrumb Span, окружающий последний crumb, будь он на текущей странице или нет.
B_crumb Класс, который присваивается каждому A-тегу, окружающему промежуточные crumb-ы (не домашние или скрытые)
B_homeCrumb Класс, который присваивается домашнему crumb-у

Примеры

Показать навигационную цепочку с символом| для разделения.

[ [Breadcrumbs? &crumbSeparator=`|`] ]