Плагин breadcrumbs - «хлебные крошки»

Плагин нужен для удобной организации «хлебных крошек» - навигационных цепочек гипертекстовых ссылок, представляющих собой путь по сайту от его «главной страницы» до текущей страницы, на которой находится пользователь. Кроме помощи в навигации посетителей хлебные крошки также используются как инструмент улучшения сниппетов сайта в поисковых системах.

Текущая версия плагина реализует следующий алгоритм формирования «хлебных крошек» на сайте:

• если вызов функции произошёл на page-странице типа static и у неё нет прописанных рубрик, то будет произведена попытка вывести путь через «родительские страницы».
• если page-страница имеет рубрики и тип отличен от static, то путь будет формироваться из ссылок на рубрики.
• если вызов произошёл на странице категории (рубрики), то будет путь от «главной» и до текущей рубрики через родительские рубрики (если они есть).
• явным образом игнорируются страницы вида - home и page_404.

Как подключить?

В справочном файле help.txt, который идёт вместе с плагином для работы рекомендуется вставит в ушку с именем content-start и типом php следующий код:

<?php
if( function_exists('breadcrumbs') ) echo breadcrumbs('<div class="breadcrumbs">','</div>');
?>

Но в таком виде может и не заработать вывод «крошек» - зависит от возможностей шаблона (есть ли в нужном месте шаблона вывод содержимого ушки с таким именем?). Если у вас именно такой случай, т.е. «не сработало», то можете попробовать подключить иначе - разместить предлагаемый код в файлах папки type_foreach (например, в info-page.php) или в файлы папки custom (например, в content-start.php) вашего используемого шаблона. Однако предварительно надо убедиться, что в вашем шаблоне есть соответствующее подключение требуемого файла в нужном месте страницы (иначе способ тоже может не сработать) и, возможно, продублировать часть кода шаблона в используемый файл (особенно актуально для случая использования type_foreach-файла).

Если указанная ушка и файлы в шаблоне не задействованы, то имеет смысл задуматься о внесении правок в файл main.php вашего шаблона. Найдите в файле /main/main.php defaulte-шаблона строчку с кодом:

if (function_exists('ushka')) echo ushka('content-start');

Вам нужно этот код вставить в main.php-файл вашего шаблона. Место вставки - найдите сами (по аналогии).

Как самый крайний вариант - вы можете внести правки (вставить предлагаемый код в нужном вам месте расположения крошек) в type-файлы вашего шаблона.

Кастомизация вывода хлебных крошек

Т.к. вызов вывода хлебных крошек сейчас осуществляется через «ручной» вызов функции плагина breadcrumbs, а у неё есть параметры, то можно этим воспользоваться и добиться вывода ссылок в нужном виде. Итак, функция принимает следующие параметры (порядок именно такой):

• $do - задаёт текстовую строку, которая будет выводиться в начале блока. По-умолчанию, задаётся пустая строка. Нужно использовать для задания div блока с определённым css-классом, для последующего прописывания css-стилей.
• $posle - задаёт текстовую строку, которая будет выводиться в конце блока ссылок. По-умолчанию, задаётся пустая строка. Нужно использовать для задания закрывающего /div блока, который задан в $do.
• $simple - указывает на необходимость оформления крошек в видео ссылок или простого текста. Принимает значения: true - выводить простой текст, false - выводить ссылки на крошки.
• $ch - разделитель между крошками. По-умолчанию используется символ ». Для задания своего разделителя передайте в параметр строку. Можно использовать коды html-мнемоник или задать любой html-код, например, подключить <img>.
• $last - указывает на необходимость выводить последнюю крошку в виде ссылки. Принимает значения: true - делать ссылку, false - выводить простым текстом.
• $main - название для корневого узла навигационного пути. По-умолчанию, имеет значение «Главная».

Пример задания своих настроек (div-блок с классом breadcrumbs, с разделителем в виде стрелочки ↠, с выводом крошек в виде ссылок, последний узел в виде текста, корневым узлом «Home»):

if( function_exists('breadcrumbs') ) echo breadcrumbs('<div class="breadcrumbs">', '</div>', false, ' &#8608; ', false, 'Home');

Если нужно использовать значения по-умолчанию, то можно не указывать (опустить) значение. Пример такого использования можно видеть в разделе «Как подключить?»

Скачать:

Автор: shuriks

Текущая версия плагина: 1.1 (стабильно работает на cms 0.862)

breadcrumbs_1_1.zip³

ToDo

Плагин отчаянно нуждается в доработке и обновлении. В частности, требуется реализовать следующие возможности:

1. Страница опций - чтобы можно было явно указывать заголовки для неизвестных типов страниц.
2. Микроразметка - сейчас ничего такого в плагине нет и в помине. Но для лучшего представления для поисковых систем желательно внедрить хотя бы рекомендации Яндекса⁸².
3. Заготовки стилей в custom.css - чтобы пользователи плагина со старта могли иметь красивое оформление хлебных крошек или же задать своё собственное.

Также в комментариях можно высказать свои предложения и идеи по плагину. Заранее спасибо!

ЗЫ

Название «Хлебные крошки» является иронической отсылкой к немецкой сказке «Гензель и Гретель», в которой дети, когда их завели в лес во второй раз, не смогли найти обратную дорогу, так как на этот раз вместо маленьких камешков они оставляли за собой хлебные крошки, впоследствии склёванные лесными птицами. © Википедия⁰