Описание
Плагин DY Breadcrumbs 2 для системы управления контентом GetSimple CMS является продолжением плагина DY Breadcrumbs.
Возможности
DY Breadcrumbs 2 обладает всеми возможностями плагина DY Breadcrumbs и предоставляет новые:
- настройка параметров через веб-интерфейс: DY Breadcrumbs 2 позволяет произвести настройку параметров навигационной цепочки с использованием веб-интерфейса, что значительно повышает удобство и простоту использования плагина, освобождая пользователя от необходимости ручного редактирования файлов шаблона оформления;
- экономичное использование ресурсов веб-сервера: DY Breadcrumbs 2 использует кэширования данных, что позволяет снизить потребление вычислительных ресурсов веб-сервера при использовании плагина на высокопосещаемых веб-сайтах;
- неограниченный уровень вложенности: DY Breadcrumbs 2 позволяет формировать навигационную цепочку для страниц с любой степенью вложенности, поддерживаемой GetSimple CMS. В отличие от DY Breadcrumbs, формируемые URL могут включать в себя только непосредственную родительскую страницу, в соответствии с реализацией данной возможности на уровне ядра GetSimple CMS текущей версии (3.3.x).
Так же, как DY Breadcrumbs, DY Breadcrumbs 2 не использует предопределёные стили, позволяя пользователю самостоятельно настроить вид навигационной цепочки без необходимости их переопределения.
Использование
Для вывода “хлебных крошек” в файле шаблона оформления страницы или компоненте следует разместить вызов PHP функции:
<?php dyGetBreadcrumbs2($homeShow, $homeAnchor, $currentShow, $currentLink, $useMenuData, $anchorLength, $homeAnchorFullLength, $currentAnchorFullLength, $tag) ?>
Параметры, принимаемые функцией dyGetBreadcrumbs2:
- $homeShow - необязательный аргумент, управляет выводом корневого элемента навигационной цепочки. По умолчанию
true
, корневой элемент навигационной цепочки выводится; - $homeAnchor - необязательный аргумент,передаёт название для корневого элемента навигационной цепочки. По умолчанию пустая строка, название корневого элемента формируется по тем же правилам, что и названия других родительских элементов;
- $currentShow - необязательный аргумент, управляет выводом элемента навигационной цепочки, соответствующего текущей странице. По умолчанию
true
, текущая страница входит в навигационную цепочку; - $currentLink - необязательный аргумент, управляет форматом вывода элемента навигационной цепочки, соответствующего текущей странице в виде гиперссылки. По умолчанию
false
, название текущей страницы выводится простым текстом; - $useMenuData - необязательный аргумент, управляет возможностью использования для названий родительских страниц в навигационной цепочке названий, заданных для использования в меню. По умолчанию
false
, для названий родительских страниц используются стандартные названия; - $anchorLength - необязательный параметр, задающий длину выводимых названий элементов навигационной цепочки в символах. По умолчанию
0
, названия выводятся полностью; - $homeAnchorFullLength - необязательный параметр, управляет выводом полного названия элемента навигационной цепочки, соответствующего текущей странице, в случае передачи значения параметра $anchorLength > 0. По умолчанию
true
, название выводится полностью; - $currentAnchorFullLength - необязательный параметр, управляет выводом полного названия элемента навигационной цепочки, соответствующего текущей странице, в случае передачи значения параметра $anchorLength > 0. По умолчанию
true
, название выводится полностью.; - $tag - необязательный параметр, задаёт HTML-тег, используемый для элементов навигационной цепочки. По умолчанию
li
, элементы навигационной цепочки заключаются в HTML-теги <li></li>
.
Пример использования
<ol class="breadcrumbs" itemscope itemtype="http://schema.org/BreadcrumbList">
<?php echo dyBreadcrumbs2(true, 'Главная', true, false, true, 0, true, true, 'li'); ?>
</ol>
Важно!
При изменении значений параметров вызываемой функции, требуется очистить кэш. Возможность очистки кэша доступна в разделе “Настройки” панели администрирования GetSimple CMS.