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

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
Наверх