Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

top элементов каталога по параметру (магазин) - не поддерживается с версии 12.5


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

Выводит в таблице top элементов из всех разделов в соответствии с заданной сортировкой (используется как правило на главной странице сайта). Компонент разработан специально для решения sitestore.

В визуальном редакторе компонент расположен по пути Решение: Магазин > Каталог > Top элементов каталога.



Параметры

ПолеПараметрОписание
Основные параметры
Тип инфо-блокаIBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
Инфо-блокIBLOCK_IDДля выбранного типа инфоблоков указывается идентификатор информационного блока, из которого будет выводиться top элементов сгруппированных по разделам.
Источник данных
По какому полю сортируем элементыELEMENT_SORT_FIELDУказывается поле, по которому будет происходить сортировка элементов:
  • SHOWS – по количеству просмотров в среднем;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате изменения;
  • NAME – по названию;
  • ID – по идентификатору;
  • ACTIVE_FROM – по дате активности с;
  • ACTIVE_TO – по дате активности по.
Порядок сортировки элементовELEMENT_SORT_ORDERЗадается порядок сортировки элементов:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Шаблоны ссылок
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Задается имя переменной, в которой будет передаваться идентификатор раздела.
Дополнительные настройки
Выводить кнопку сравненияDISPLAY_COMPARE[Y|N] При отмеченной опции будет выведена кнопка Сравнить, с помощью которой элемент добавляется в список сравнения.
Внешний вид
Количество выводимых элементовELEMENT_COUNTУказывается количество элементов, отображаемых на одной странице. Все элементы будут выведены с помощью постраничной навигации.
Количество элементов выводимых в одной строке таблицыLINE_ELEMENT_COUNTУказывается количество элементов выводимых в одной строке таблицы.
СвойстваPROPERTY_CODEУказываются свойства инфоблока, которые будут отображены при показе элементов в таблице. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
Необходимый для отображения флагFLAG_PROPERTY_CODEВыбирается необходимый для отображения параметр каталога.
Цены
Тип ценыPRICE_CODEУказывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара и кнопки Купить и В корзину показаны не будут.
Использовать вывод цен с диапазонамиUSE_PRICE_COUNT[Y/N] При отмеченной опции будут отображаться цены всех типов на товары.
Выводить цены для количестваSHOW_PRICE_COUNTПараметр определяет количество единиц товара, для которых выводить стоимость.
Включать НДС в ценуPRICE_VAT_INCLUDE[Y|N] При отмеченной опции цены будут показаны с учетом НДС.
Характеристики товараPRODUCT_PROPERTIESВыбираются характеристики товара.
Разрешить указание количества товараUSE_PRODUCT_QUANTITY[Y|N] При установленной опции будет разрешено указание количества товара.
Настройки кеширования
Тип кешированияCACHE_TYPEТип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
Учитывать права доступаCACHE_GROUPS[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.


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

<?$APPLICATION->IncludeComponent(
"bitrix:store.catalog.top",
	"",
	Array(
		"IBLOCK_TYPE_ID" => "xmlcatalog",
		"IBLOCK_ID" => array("8"),
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"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",
		"ELEMENT_COUNT" => "9",
		"LINE_ELEMENT_COUNT" => "3",
		"PROPERTY_CODE" => array(),
		"PRICE_CODE" => array(),
		"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_GROUPS" => "Y"
	)
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024