Документация для разработчиков
Темная тема

Разделы с TOP'ом фотографий


Описание 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"
	)
);?>


© «Битрикс», 2001-2021, «1С-Битрикс», 2021
Наверх