dimayakovlev.ru


DY Breadcrumbs 2

Описание

Плагин 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.