Цепочка навигации (хлебные крошки) в 1С-Битрикс

Опубликовано автором

Вывод цепочки навигации:

<?$APPLICATION->ShowNavChain();?>

Шаблон по умолчанию нужно расположить:

/bitrix/templates/<ID текущего шаблона сайта>/chain_template.php

или

/bitrix/templates/.default/chain_template.php

Пример шаблона:

<?
$sChainProlog = '<ul>';
if (strlen($LINK))
	$sChainBody = '<li><a href="' . $LINK . '">' . htmlspecialchars($TITLE) . '</a></li>';
else
	$sChainBody = '<li><span>' . htmlspecialchars($TITLE) . '</span></li>';
$sChainEpilog = '</ul>';

Переменными результата в шаблоне:

  • $sChainProlog — HTML код выводимый перед навигационной цепочкой
  • $sChainBody — HTML код определяющий внешний вид одного пункта навигационной цепочки
  • $sChainEpilog — HTML код выводимый после навигационной цепочки
  • $strChain — HTML код всей навигационной цепочки собранный к моменту подключения шаблона

Вводные переменные:

  • $TITLE — заголовок очередного пункта навигационной цепочки
  • $LINK — ссылка на очередном пункте навигационной цепочки
  • $arCHAIN — копия массива элементов навигационной цепочки
  • $arCHAIN_LINK — ссылка на массив элементов навигационной цепочки
  • $ITEM_COUNT — количество элементов массива навигационной цепочки
  • $ITEM_INDEX — порядковый номер очередного пункта навигационной цепочки

Для заполнения цепочки статичными страницами в директорию к каждому index.php нужно добавить .section.php с переменной указывающей наименование страницы в цепочке:

<?
$sSectionName = "Главная";

Для динамического заполнения:

$APPLICATION->AddChainItem("Наименование", "/адрес_страницы/");

 

Параметры ShowNavChain

CMain::ShowNavChain(
   mixed path = false,
   int NumFrom = 0, 
   mixed NavChainPath = false
)

path — Путь для которого будет построена навигационная цепочка. В случае многосайтовой версии, если DOCUMENT_ROOT у сайтов разный (задается в поле «Путь к корневой папке веб-сервера» в настройках сайта), то в данном параметре необходимо передавать массив вида:

array("ID сайта", "путь")

Необязателен. По умолчанию — «false» — текущий путь.

NumFrom — Номер пункта начиная с которого будет построена навигационная цепочка. Пункты навигационной цепочки нумеруются с нуля.
Необязателен. По умолчанию — «0».

NavChainPath — Путь к шаблону навигационной цепочки (путь указывается относительно DOCUMENT_ROOT, к примеру, если шаблон расположен в /inc/chain_tmp.php, в пути указать: «/inc/chain_tmp.php»).
Необязателен. По умолчанию — «false»

Пример:

<?$APPLICATION->ShowNavChain(false, 0, "/includes/chain_template_header.php");?>