Одностраничный компонент. Служит для вывода TOP'а фотографий, сгруппированных по разделам.

Пример вызова

<?$APPLICATION->IncludeComponent(
	"bitrix:photo.sections.top",
	"",
	Array(
		"IBLOCK_TYPE" => "photo", 
		"IBLOCK_ID" => "8", 
		"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#", 
		"DISPLAY_PANEL" => "N", 
		"CACHE_TYPE" => "A", 
		"CACHE_TIME" => "3600", 
		"CACHE_FILTER" => "N", 
		"SECTION_COUNT" => "5", 
		"ELEMENT_COUNT" => "9", 
		"LINE_ELEMENT_COUNT" => "3" 
		)
);?>

Описание параметров

Основные параметры

IBLOCK_TYPE

Тип информационного блока. Указывается один из созданных в системе типов инфоблоков.

IBLOCK_ID

Код информационного блока, из которого будет выводиться информация.

Источник данных

SECTION_SORT_FIELD

Указывается поле, по которому будет происходить сортировка разделов в TOP’е элементов.

• sort - по индексу сортировки;
• timestamp_x - по дате изменения;
• name - по названию;
• ID - по ID;
• depth_level - по уровню вложенности.

Можно указать код любого другого поля.

SECTION_SORT_ORDER

Порядок сортировки разделов.

• asc – по возрастанию;
• desc – по убыванию.

ELEMENT_SORT_FIELD

Указывается поле, по которому будет происходить сортировка фотографий внутри каждого раздела.

• shows - по количеству просмотров в среднем;
• sort - по индексу сортировки;
• timestamp_x - по дате изменения;
• name - по названию;
• ID - по ID;
• active_from - по дате начала активности;
• active_to - по дате окончания активности.

Можно указать код любого другого поля.

ELEMENT_SORT_ORDER

Порядок сортировки фотографий в разделе.

• asc – по возрастанию;
• desc – по убыванию.

FILTER_NAME

Задается имя переменной, в которой передается массив параметров из фильтра. Служит для определения выходящих из фильтра элементов. Поле может быть оставлено пустым, тогда используется значение по умолчанию.

FIELD_CODE

Поля, которые будут отображены на странице TOP'а элементов. Задается в виде массива с символьными именами полей в коде или в публичной части редактора, удерживая клавишу Ctrl. Если ничего не выбрано, то будут выведены поля по умолчанию.

PROPERTY_CODE

Свойства, которые будут отображены на странице TOP'а элементов. Задается в виде массива с символьными именами свойств в коде либо в публичной части редактора, удерживая клавишу Ctrl. Если ничего не выбрано, то свойства отображены не будут.

Внешний вид

SECTION_COUNT

Максимальное количество выводимых разделов.

ELEMENT_COUNT

Максимальное количество фотографий, выводимых в каждом разделе.

LINE_ELEMENT_COUNT

Количество фотографий, выводимых в одной строке таблицы списка разделов.

Шаблоны ссылок

SECTION_URL

URL, ведущий на страницу с содержимым раздела. По умолчанию поле содержит section.php?SECTION_ID=#SECTION_ID#.

DETAIL_URL

URL, ведущий на страницу с содержимым элемента раздела. По умолчанию поле содержит detail.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#.

Настройки кэширования

CACHE_TYPE

Тип кеширования:

• А - Авто: действует при включенном автокешировании на странице Настройки кеширования (Настройки > Настройки продукта > Автокеширование) и при установленном времени кеширования в поле CACHE_TIME.
• Y - Кешировать: должно быть установлено время кеширования (CACHE_TIME). Настройки автокеширования не влияют на данный тип кеширования.
• N - Не кешировать: кеширование не происходит.

CACHE_TIME

Время кеширования в секундах.

CACHE_FILTER

Кешировать при установленном фильтре. При установленной опции каждый результат, полученный из фильтра будет кэшироваться. Имеет смысл отмечать, если многие пользователи используют одну и туже выборку из фильтра.

Дополнительные настройки

DISPLAY_PANEL

Добавляться кнопки в режиме редактирования сайта в Административную панель и в набор кнопок области редактирования данного компонента.

© «Битрикс», 2001-2008, «1C-Битрикс», 2008

1С-Битрикс: Управление сайтом