Разделы с top'ом элементов

Описание catalog.sections.top

Компонент выводит top элементов сгруппированных по разделам; элементы выводятся в таблице. Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути Контент > Каталог > Разделы с top'ом элементов.

Компонент относится к модулю Информационные блоки.

Параметры

Поле

Параметр

Описание

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

Тип инфоблока

IBLOCK_TYPE

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

Инфоблок

IBLOCK_ID

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

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

Поля разделов

SECTION_FIELDS

Указываются поля раздела, которые будут отображены на странице структуры разделов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:

 Array("ID","CODE",""),

При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив) ничего отображаться не будет.

Свойства раздела

SECTION_USER_FIELDS

Указываются свойства раздела, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, свойства не будут выведены.

По какому полю сортируем разделы

SECTION_SORT_FIELD

Указывается поле, по которому будет происходить сортировка разделов:

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 – по дате активности по;
CATALOG_AVAILABLE – доступность к покупке;
SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)

Порядок сортировки элементов

ELEMENT_SORT_ORDER

Задается порядок сортировки элементов:

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

Поле для второй сортировки элементов

ELEMENT_SORT_FIELD2

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

shows – по количеству просмотров в среднем;
sort – по индексу сортировки;
timestamp_x – по дате изменения;
name – по названию;
id – по идентификатору;
active_from – по дате активности с;
active_to – по дате активности по;
CATALOG_AVAILABLE – доступность к покупке;
SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)

Порядок второй сортировки элементов

ELEMENT_SORT_ORDER2

Задается порядок второй сортировки элементов:

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

Имя массива со значениями фильтра для фильтрации элементов

FILTER_NAME

Задается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию.

Не отображать товары, которых нет на складах

HIDE_NOT_AVAILABLE

[Y|N] При отмеченной опции будут скрыты товары, для которых общее количество на складах меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.

Внешний вид

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

SECTION_COUNT

Указывается максимальное количество разделов, отображаемых на странице.

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

ELEMENT_COUNT

Указывается максимальное количество элементов выводимых в каждом разделе. Все элементы раздела будут выведены с помощью постраничной навигации.

Количество элементов, выводимых в одной строке таблицы

LINE_ELEMENT_COUNT

Указывается количество элементов выводимых в одной строке таблицы.

Свойства

PROPERTY_CODE

Указываются свойства инфоблока, которые будут отображены при показе элементов в таблице. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.

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

URL, ведущий на страницу с содержимым раздела

SECTION_URL

Указывается путь к странице с детальным содержимым раздела.

URL, ведущий на страницу с содержимым элемента раздела

DETAIL_URL

Указывается путь к странице с детальным описанием элемента раздела.

URL, ведущий на страницу с корзиной покупателя

BASKET_URL

Указывается путь к странице с корзиной покупателя.

Название переменной, в которой передается действие

ACTION_VARIABLE

Указывается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию ACTION. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.

Название переменной, в которой передается код товара для покупки

PRODUCT_ID_VARIABLE

Задается имя переменной, в которой будет передаваться идентификатор товара для покупки.

Название переменной, в которой передается количество товара

PRODUCT_QUANTITY_VARIABLE

Задается имя переменной, в которой будет передаваться количество товара.

Название переменной, в которой передаются характеристики товара

PRODUCT_PROPS_VARIABLE

Задается имя переменной, в которой будет передаваться характеристики товара.

Название переменной, в которой передается код группы

SECTION_ID_VARIABLE

Задается имя переменной, в которой будет передаваться идентификатор группы.

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

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

CACHE_TYPE

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

A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
Y - Кешировать: для кеширования необходимо определить время кеширования;
N - Не кешировать: кеширования нет в любом случае.

Время кеширования (сек.)

CACHE_TIME

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

Кешировать при установленном фильтре

CACHE_FILTER

[Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.

Учитывать права доступа

CACHE_GROUPS

[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.

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

Выводить кнопку сравнения

DISPLAY_COMPARE

[Y|N] При отмеченной опции будет выведена кнопка Сравнить, с помощью которой элемент добавляется в список сравнения.

Использовать основной раздел для показа элемента

USE_MAIN_ELEMENT_SECTION

[Y|N] Если опция отмечена, то при переходе на детальную страницу элемента в адресную строку браузера будет подставляться тот путь, который формируется при просмотре элемента через основной раздел, даже если элемент открыт через другой родительский его раздел.

Если опция не отмечена, про ссылка на детальную страницу элемента формируется с учетом того раздела, через который элемент открыт на просмотр.

Рассмотрим пример, когда опция в настройках отмечена. Допустим, что элемент с символьным кодом marketing привязан к двум разделам с кодами bisness и science соответственно, причем раздел с кодом bisness является основным. В результате, если пользователь пришел в раздел science и кликнул на элемент marketing, то в строке браузера вместо http://mysite.ru/catalog/science/marketing/ будет отображено http://mysite.ru/catalog/bisness/marketing/.

Цены

Тип цены

PRICE_CODE

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

Использовать вывод цен с диапазонами

USE_PRICE_COUNT

[Y/N] При отмеченной опции будут отображаться цены всех типов на товары.

Выводить цены для количества

SHOW_PRICE_COUNT

Параметр определяет количество единиц товара, для которых выводить стоимость.

Включать НДС в цену

PRICE_VAT_INCLUDE

[Y|N] При отмеченной опции цены будут показаны с учетом НДС.

Характеристики товара

PRODUCT_PROPERTIES

Указываются характеристики товара.

Разрешить указание количества товара

USE_PRODUCT_QUANTITY

[Y|N] При отмеченной опции будет разрешен вывод количества товара.

Показывать цены в одной валюте

CONVERT_CURRENCY

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

Валюта, в которую будут сконвертированы цены

CURRENCY_ID

Выбор валюты в которой будут отображаться цены.

Разрешить указание дробного количества товара

QUANTITY_FLOAT

[Y|N] При отмеченной опции в корзину можно будет добавлять дробное количество товара. Опция доступна, если отмечен параметр Разрешить указание количества товара, до версии модуля 14.0.0.

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

<?$APPLICATION->IncludeComponent("bitrix:catalog.sections.top","",Array(
		"IBLOCK_TYPE" => "books",
		"IBLOCK_ID" => "6",
		"SECTION_FIELDS" => Array(""),
		"SECTION_USER_FIELDS" => Array(""),
		"SECTION_SORT_FIELD" => "sort",
		"SECTION_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD" => "active_from",
		"ELEMENT_SORT_ORDER" => "asc",
		"FILTER_NAME" => "arrFilter",
		"SECTION_URL" => "",
		"DETAIL_URL" => "",
		"BASKET_URL" => "/personal/basket.php",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
	    "PRODUCT_QUANTITY_VARIABLE" =>  "quantity",
	    "PRODUCT_PROPS_VARIABLE" =>  "prop",
		"SECTION_ID_VARIABLE" => "SECTION_ID",
		"DISPLAY_COMPARE" => "Y",
		"USE_MAIN_ELEMENT_SECTION" => "Y",
		"SECTION_COUNT" => "20",
		"ELEMENT_COUNT" => "9",
		"LINE_ELEMENT_COUNT" => "3",
		"PROPERTY_CODE" => Array("YEAR", "ISBN", "PAGES", "CML2_ARTICLE"),
		"PRICE_CODE" => Array("BASE"),
		"USE_PRICE_COUNT" => "Y",
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"PRODUCT_PROPERTIES" => array(),
	    "USE_PRODUCT_QUANTITY" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_FILTER" => "Y",
		"CACHE_GROUPS" => "Y",
		"HIDE_NOT_AVAILABLE" => "N",
		"QUANTITY_FLOAT" => "N",
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
	)
);?>

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх