====== Блок "Список альбомов" ======
{{:blocks:block.gif }}Блок предназначен для формирования списка ссылок на страницы альбомов выбранного раздела на базе модуля [[:modules:gallery|"Фотогалерея"]].

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

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

{{ :blocks:blockalbums.jpg }}

===== Параметры =====
^ Название ^ Идентификатор ^ Описание ^
| Раздел  | idsec | Раздел-источник альбомов.  |
| Шаблон  | template | Шаблон блока, по умолчанию albums.tpl.  |
| Категория  | idcat | Категория из которой будут выбраны альбомы.  |
| Сортировка  | sort | Способ сортировки.  |
| Фильтр  | filter | Выражение определяющее фильтр записей. Пишется в виде фрагмента условия SQL запроса, например: favorite='Y' AND type=1 . Доступно только администратору с полными правами.  |
| Количество альбомов  | rows | Количество выводимых записей.  |

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

==== $category ====
Массив с данными о категории (если выбрано), состоит из ключей:

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

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

=== description ===
Описание категории.

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

=== citems ===
Количество материалов в категории.

=== level ===
Уровень в дереве категорий, 0 - находится в корне.

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

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

=== name ===
Название альбома.

=== description ===
Описание альбома, форматированный или простой текст в зависимости от значения опции "Использовать визуальный редактор".

=== link ===
Ссылка на страницу альбома.

=== category ===
Полное название категории, которой принадлежит альбом.

=== date ===
Дата создания в формате UTC.

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

=== vote ===
Текущая оценка материала.

=== cvote ===
Количество голосов.

=== comments ===
Количество комментариев.

=== images ===
Массив записей с данными о фото в альбоме, может использоваться в качестве параметра функции [[:smarty:smarty6#image|image]]. Каждая запись представляет собой массив с ключами:
  * **id** - числовой идентификатор.
  * **path** - путь к файлу изображения на сервере.
  * **caption** - описание.
  * **width** - ширина изображения.
  * **height** - высота изображения.

=== idimg ===
Числовой идентификатор главного фото в альбоме.

=== tags ===
Если включено использование тегов, то содержит массив записей с данными о тегах. Каждая запись представляет собой массив с ключами:
  * **name** - название тега.
  * **link** - ссылка на результаты поиска по тегу.

=== дополнительное поле ===
Значение дополнительного поля.

=== fields ===
Массив записей с данными о дополнительных полях. Каждая запись представляет собой массив с ключами:
  * **field** - Строковой идентификатор поля.
  * **name** - Описание поля.
  * **value** - Значение.



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

<code smarty>
{section name=i loop=$albums}
    <h3><a href="{$albums[i].link}">{$albums[i].name}</a></h3>
    {image id=$albums[i].idimg width=80 height=80 align="center"}
{/section}
</code>