====== Блок "Список категорий раздела" ======
{{:blocks:block.gif }}Блок предназначен для вывода списка ссылок на страницы категорий выбранного раздела. Поддерживает двухуровневый вывод, а так же позволяет отслеживать активность ссылок.

===== Свойства =====
  * Входит в базовый дистрибутив: Да
  * Многократное использование: Да
  * Кэширование данных: Да
  * Сопутствует модулю: Все модули, поддерживающие категории, например: [[:modules:catalog|"Каталог материалов"]] , [[:modules:gallery|"Фотогалерея"]] , [[:modules:faq|"Вопрос-Ответ"]] , [[:modules:shoplite|"Магазин Lite"]]

===== Создание блока =====
Для создания блока нужно перейти к управлению блоками в "Сайт" -> "Блоки" и добавить новый блок, выбрав при этом в 
качестве базового типа "Список категорий раздела".

{{ :blocks:blockcategories.jpg }}

===== Параметры =====
^ Название ^ Идентификатор ^ Описание ^
| Раздел  | idsec | Раздел-источник, категории которого будут выводиться в блоке.  |
| Шаблон  | template | Шаблон блока, по умолчанию categories.tpl.  |
| Текущий уровень  | curcheck | Если включено, то список категорий будет формироваться в зависимости от текущей страницы на сайте, если это страница категории, то в список попадут уже подкатегории для нее.  |
| Ссылки на подкатегории из  | idcat | Позволяет выбрать корневую категорию, подкатегории которой попадут в список. Если не выбрано, то выводится первый уровень категорий от корня.  |
| Количество  | rows | Позволяет ограничить список категорий заданным количеством.  |

===== Данные доступные в шаблоне (categories.tpl) =====

==== $categories ====
Массив записей с данными о ссылках на категории. Каждая запись представляет собой массив с ключами:

=== id ===
Числовой идентификатор категории.

=== name ===
Название категории.

=== link ===
Ссылка на страницу категории.

=== selected ===
Логическое значение, истина, если страница на сайте принадлежит этой категории.

=== latname ===
Строковой идентификатор категории.

=== idimg ===
Числовой идентификатор прикрепленного изображения.

=== level ===
Уровень категории начиная с нуля.

=== subcategories ===
Массив записей с данными о ссылках на категории следующего уровня. Каждая запись имеет формат аналогичный [[#categories|описанному выше]].

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

<code smarty>
{section name=i loop=$categories}
    {if $categories[i].selected}
        <a href="{$categories[i].link}"><b>{$categories[i].name}</b></a><br>
    {else}
        <a href="{$categories[i].link}">{$categories[i].name}</a><br>
    {/if}
{/section}
</code>