Что такое 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
Имя |
Описание |
По умолчанию |
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-у |
Примеры
Показать навигационную цепочку с символом| для разделения.