Описание photo.sections.top
Одностраничный компонент служит для вывода TOP'а фотографий, сгруппированных по разделам. Компонент стандартный и входит в дистрибутив модуля.
В визуальном редакторе компонент расположен по пути: Контент > Фотогалерея > Разделы с TOP'ом фотографий.
Компонент относится к модулю Информационные блоки.
Параметры
Описание параметров
| Поле |
Параметр |
Описание |
| Основные параметры |
|---|
| Тип инфоблока |
IBLOCK_TYPE |
Указывается один из созданных в системе типов информационного блока. |
| Инфоблок |
IBLOCK_ID |
Для выбранного типа инфоблока указывается идентификатор информационного блока, фотографии из которого будут выводиться. |
| Источник данных |
|---|
| Поля разделов | SECTION_FIELDS | Указываются поля раздела, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
Array("ID","CODE",""),
При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив) ничего отображаться не будет. |
| Свойства раздела | SECTION_USER_FIELDS | Указываются свойства раздела, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, свойства не будут выведены. |
| По какому полю сортируем разделы |
SECTION_SORT_FIELD |
Указывается поле, по которому будет происходить сортировка разделов в TOP’е элементов:
- SORT - по индексу сортировки;
- TIMESTAMP_X - по дате изменения;
- NAME - по названию;
- ID - по идентификатору;
- DEPTH_LEVEL - по уровню вложенности папки.
Можно указать код любого другого поля. |
| Порядок сортировки разделов |
SECTION_SORT_ORDER |
Задается порядок сортировки разделов:
- ASC – По возрастанию;
- DESC – По убыванию.
|
| По какому полю сортируем фотографии |
ELEMENT_SORT_FIELD |
Указывается поле, по которому будет происходить сортировка фотографий внутри каждого раздела:
- SHOWS – по количеству просмотров в среднем;
- SORT – по индексу сортировки;
- TIMESTAMP_X – по дате последнего изменения;
- NAME – по названию;
- ID – по идентификатору;
- ACTIVE_FROM – по дате активности с;
- ACTIVE_TO – по дате активности по.
|
| Порядок сортировки фотографий в разделе |
ELEMENT_SORT_ORDER |
Задается порядок сортировки фотографий в разделе:
- ASC – По возрастанию;
- DESC – По убыванию.
|
| Имя выходящего массива для фильтрации |
FILTER_NAME |
Задается имя переменной, в которой передается массив параметров из фильтра. Служит для определения выходящих из фильтра элементов. Поле может быть оставлено пустым, тогда используется значение по умолчанию. |
| Поля |
FIELD_CODE |
Указываются поля, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),
При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив), на странице списка будут выведены поля по умолчанию.
|
| Свойства |
PROPERTY_CODE |
Указываются свойства, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, на странице детального просмотра свойства не будут выведены. |
| Внешний вид |
|---|
| Максимальное количество выводимых разделов |
SECTION_COUNT |
Задается максимальное количество выводимых разделов. |
| Максимальное количество фотографий, выводимых в каждом разделе |
ELEMENT_COUNT |
Задается максимальное количество фотографий, выводимых в TOP’е элементов в каждом разделе. |
| Количество фотографий, выводимых в одной строке таблицы |
LINE_ELEMENT_COUNT |
Указывается количество фотографий, выводимых в одной строке таблицы. |
| Шаблоны ссылок |
|---|
| URL, ведущий на страницу с содержимым раздела |
SECTION_URL |
Указывается адрес страницы с содержимым раздела. |
| URL, ведущий на страницу с содержимым элемента раздела |
DETAIL_URL |
Указывается адрес страницы с содержимым элемента раздела. |
| Настройки кеширования |
|---|
| Тип кеширования |
CACHE_TYPE |
Тип кеширования:
- A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
- Y - Кешировать: для кеширования необходимо определить время кеширования;
- N - Не кешировать: кеширования нет в любом случае.
|
| Время кеширования (сек.) |
CACHE_TIME |
Время кеширования, указанное в секундах. |
| Кешировать при установленном фильтре |
CACHE_FILTER |
[Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться. |
| Учитывать права доступа |
CACHE_GROUPS |
[Y|N] При отмеченной опции будут учитываться права доступа при кешировании. |
Пример вызова
<$APPLICATION->IncludeComponent("bitrix:photo.sections.top","",Array(
"IBLOCK_TYPE" => "gallery",
"IBLOCK_ID" => 9,
"SECTION_FIELDS" => array("ID"),
"SECTION_USER_FIELDS" => array(),
"SECTION_SORT_FIELD" => "sort",
"SECTION_SORT_ORDER" => "asc",
"ELEMENT_SORT_FIELD" => "sort",
"ELEMENT_SORT_ORDER" => "asc",
"FILTER_NAME" => "arrFilter",
"FIELD_CODE" => Array(),
"PROPERTY_CODE" => Array(),
"SECTION_URL" => "section.php?SECTION_ID=#SECTION_ID#",
"DETAIL_URL" => "detail.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
"CACHE_TYPE" => "A",
"CACHE_TIME" => 3600,
"CACHE_FILTER" => "N",
"CACHE_GROUPS" => "Y",
"SECTION_COUNT" => "20",
"ELEMENT_COUNT" => "9",
"LINE_ELEMENT_COUNT" => "3"
)
);?>