top элементов каталога
Компонент выводит в таблице top элементов из всех разделов в соответствии с заданной сортировкой (используется как правило на главной странице сайта).
Описание catalog.top
Компонент содержит три шаблона: .default, slider и bootstrap_v4. Компонент стандартный и входит в дистрибутив модуля.
В визуальном редакторе компонент расположен по пути Контент > Каталог > Top элементов каталога.
Компонент относится к модулю Информационные блоки.
Параметры
Поле | Параметр | Описание | Примечание | ||||||||||||||||
Основные параметры | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Тип инфоблока | IBLOCK_TYPE | Указывается один из созданных в системе типов информационных блоков. | |||||||||||||||||
Инфоблок | IBLOCK_ID | Для выбранного типа инфоблоков указывается идентификатор информационного блока, из которого будет выводиться top элементов сгруппированных по разделам. | |||||||||||||||||
Источник данных | |||||||||||||||||||
Имя массива со значениями фильтра для фильтрации элементов | FILTER_NAME | Задается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию. | |||||||||||||||||
Фильтр товаров | CUSTOM_FILTER |
В данном поле настраиваются условия отбора товаров для показа. Выбор каждого условия осуществляется из выпадающего списка, доступного по ссылке Добавить условие. Для выбранного поля/свойства товара задается соответствие некоторому значению. Допускается создание нескольких условий и использование между ними как логики "И", так и логики "ИЛИ".
|
|||||||||||||||||
Недоступные товары | HIDE_NOT_AVAILABLE |
Указывается способ отборажения недоступных для покупки товаров:
Примечание: недоступные для покупки товары - это товары, для которых количество меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
|
|||||||||||||||||
Недоступные торговые предложения | HIDE_NOT_AVAILABLE_OFFERS |
Указывается способ отборажения недоступных для покупки торговых предложений:
|
|||||||||||||||||
Настройки сортировки | |||||||||||||||||||
По какому полю сортируем элементы | ELEMENT_SORT_FIELD |
Указывается поле, по которому будет происходить сортировка элементов:
|
|||||||||||||||||
Порядок сортировки элементов | ELEMENT_SORT_ORDER |
Задается порядок сортировки элементов:
|
|||||||||||||||||
Поле для второй сортировки элементов | ELEMENT_SORT_FIELD2 |
Указывается поле, по которому будет происходить вторая сортировка элементов:
|
|||||||||||||||||
Порядок второй сортировки элементов | ELEMENT_SORT_ORDER2 |
Задается порядок второй сортировки элементов:
|
|||||||||||||||||
По какому полю сортируем предложения товара | OFFERS_SORT_FIELD |
Указывается поле, по которому сортируется весь список предложений товара.
См. примечание в конце страницы.
|
Данные параметры появляются при настройке компонента на инфоблок с поддержкой SKU. | ||||||||||||||||
Порядок сортировки предложений товара | OFFERS_SORT_ORDER | Выбирается как сортировать предложения товара: по возрастанию, или по убыванию. | |||||||||||||||||
Поле для второй сортировки предложений товара | OFFERS_SORT_FIELD2 |
Указывается поле, по которому выполняется вторая сортировка списка предложений товара.
См. примечание в конце страницы.
|
|||||||||||||||||
Порядок второй сортировки предложений товара | OFFERS_SORT_ORDER2 | Выбирается направление второй сортировки предложений товара: по возрастанию, или по убыванию. | |||||||||||||||||
Внешний вид | |||||||||||||||||||
Свойства | PROPERTY_CODE |
Указываются свойства инфоблока, которые будут отображены при показе элементов в таблице. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут. Внимание! При включенной опции Использовать параметры свойств в компонентах и формах эта настройка может быть скрыта. В этом случае показ свойств настраивается только в форме редактирования инфоблока . Подробнее о настройке свойств инфоблока в уроке. |
|||||||||||||||||
Свойства товаров, отображаемые на мобильных устройствах | PROPERTY_CODE_MOBILE | Выбираются свойства инфоблока (перечень формируется из выбранных в параметре выше свойств), которые будут отображены в списке товаров при просмотре с мобильных устройств. | |||||||||||||||||
Поля предложений | OFFERS_FIELD_CODE | Выбираются поля предложений. С помощью клавиши Ctrl можно выбрать несколько значений. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU. | |||||||||||||||||
Свойства предложений | OFFERS_PROPERTY_CODE |
Указываются свойства предложений. Можно добавлять свои. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU. Внимание! При включенной опции Использовать параметры свойств в компонентах и формах эта настройка может быть скрыта. В этом случае показ свойств настраивается только в форме редактирования инфоблока . Подробнее о настройке свойств инфоблока в уроке. |
|||||||||||||||||
Максимальное количество предложений для показа | OFFERS_LIMIT | Указывается максимальное для вывода на страницу число предложений (0 - все). | Параметр доступен, если опция Включить режим совместимости включена. | ||||||||||||||||
Показ элементов | VIEW_MODE | Определяется способ отображения элементов: баннер (BANNER), слайдер (SLIDER) или список (SECTION). | |||||||||||||||||
Цветовая тема | TEMPLATE_THEME | Задается цветовая схема для отображения top'а элементов. По умолчанию используется синяя схема (blue). | |||||||||||||||||
Схема отображения | PRODUCT_DISPLAY_MODE | Задается режим отображения товаров: простой (N) или расширенный (Y). Параметр доступен для инфоблока с торговыми предложениями. | |||||||||||||||||
Дополнительная картинка основного товара | ADD_PICT_PROP | Задается свойство, в котором хранится дополнительная картинка для основного товара. | |||||||||||||||||
Свойство меток товара | LABEL_PROP | Указываются свойство, в котором хранится метка товара (например, новинка). | |||||||||||||||||
Свойства меток товара, отображаемые на мобильных устройствах | LABEL_PROP_MOBILE | Выбираются свойства меток (перечень формируется из выбранных в параметре выше свойств), которые будут отображены в списке товаров при просмотре с мобильных устройств. | |||||||||||||||||
Дополнительные картинки предложения | OFFER_ADD_PICT_PROP | Задается свойство, в котором хранится дополнительная картинка для торгового предложения. Параметр доступен для инфоблока с торговыми предложениями.. | Данные настройки доступны, если в параметре Схема отображения выбрано значение расширенный. | ||||||||||||||||
Свойства для отбора предложений | OFFER_TREE_PROPS |
Указываются свойства, по значениям которых будут группироваться торговые предложения. Параметр доступен для инфоблока с торговыми предложениями. Внимание! При включенной опции Использовать параметры свойств в компонентах и формах эта настройка может быть скрыта. В этом случае показ свойств настраивается только в форме редактирования инфоблока . Подробнее о настройке свойств инфоблока в уроке. |
|||||||||||||||||
Расположение меток товара | LABEL_PROP_POSITION | Выберите подходящее место для меток на карточке товара. | |||||||||||||||||
Показывать процент скидки | SHOW_DISCOUNT_PERCENT | [Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана. | |||||||||||||||||
Показывать старую цену | SHOW_OLD_PRICE | [Y|N] Если задана скидка на товар, то при отмеченной опции будет отображаться старая цена. | |||||||||||||||||
Показывать остаток товара | SHOW_MAX_QUANTITY |
Укажите способ отображения остатка товара:
|
|||||||||||||||||
Текст для остатка | MESS_SHOW_MAX_QUANTITY | Задается текст для отображения информации о наличии товара. | Доступность данных параметров компонента определяется настройками параметра Показывать остаток товара. | ||||||||||||||||
Значение, от которого происходит подмена | RELATIVE_QUANTITY_FACTOR | Указывается значение, меньше (больше) которого о количестве товара на складе будет отображаться выражение, что товара мало (много). | |||||||||||||||||
Текст для значения больше | MESS_RELATIVE_QUANTITY_MANY | Задается текст, который будет отображаться при наличии товара в количестве большем, чем значение в параметре Значение, от которого происходит подмена. | |||||||||||||||||
Текст для значения меньше | MESS_RELATIVE_QUANTITY_FEW | Задается текст, который будет отображаться при наличии товара в количестве меньшем, чем значение в параметре Значение, от которого происходит подмена.. | |||||||||||||||||
Показывать кнопку продолжения покупок во всплывающих окнах | SHOW_CLOSE_POPUP | [Y|N] При отмеченной опции будет отображаться кнопка Продолжить покупки во всплывающем окне, появляющемся после добавления товара в корзину. | |||||||||||||||||
Разрешить оповещения для отсутствующих товаров | PRODUCT_SUBSCRIPTION | [Y|N] При отмеченной опции клиент будет оповещаться, что интересующий его товар стал доступным для покупки. | Данные параметры доступны, если в параметре Показ элементов выбрано значение список. | ||||||||||||||||
Расположение процента скидки | "DISCOUNT_PERCENT_POSITION | Выберите подходящее место для отображения процентной скидки на карточке товара. | |||||||||||||||||
Вариант отображения товаров | PRODUCT_ROW_VARIANTS |
В правой части поля выберите подходящий вам вариант отображения одной строки товаров на странице и перетащите его в левую часть. Аналогичным образом настройте остальные строки для формирования таблицы товаров.
|
|||||||||||||||||
Количество товаров на странице | ELEMENT_COUNT | Отображается информация по количеству товаров на странице в соответствии с выбранным вариантом отображения товаров. | |||||||||||||||||
Выделять товары в списке | ENLARGE_PRODUCT |
Выберите способ выделения товаров в списке:
Примечание: выделение товаров осуществляется в том случае, если для показа списка товаров выбран хотя бы один вариант вида:
|
|||||||||||||||||
Выделять по выбранному свойству | ENLARGE_PROP | Указывается то свойство товара, при наличии которого товар будет выделен в списке просмотренных (если позволяет вариант отображения товаров, см. поле Вариант отображения товаров). Параметр доступен, если в параметре Выделять товары в списке указано значение по свойству (подгонять по шаблону). | |||||||||||||||||
Порядок отображения блоков товара | PRODUCT_BLOCKS_ORDER |
Перетаскивая блоки, определите необходимый вам порядок следования блоков товара.
|
|||||||||||||||||
Показывать слайдер для товаров | SHOW_SLIDER |
[Y|N] При отмеченной опции для товаров будет использоваться слайдер для показа изображений; станет доступным
дополнительное окно
|
Данные параметры доступны, если в параметре Показ элементов выбрано значение баннер или слайдер. | ||||||||||||||||
Время показа одного слайда, сек (0 - выключить автоматическую смену слайдов) | ROTATE_TIMER | Указывается время показа одного слайда (в сек.). Используется для автоматической прокрутки слайдов. | |||||||||||||||||
Показывать навигацию по слайдам | SHOW_PAGINATION | [Y|N] При отмеченной опции будет доступна навигация по слайдам. | |||||||||||||||||
Текст кнопки "Купить" | MESS_BTN_BUY | Задается текст, который должен быть отображен на кнопке "Купить". | |||||||||||||||||
Текст кнопки "Добавить в корзину" | MESS_BTN_ADD_TO_BASKET | Задается текст, который должен быть отображен на кнопке добавления в корзину. | |||||||||||||||||
Текст кнопки "Сравнить" | MESS_BTN_COMPARE | Задается текст, который должен быть отображен на кнопке "Сравнить". | |||||||||||||||||
Текст кнопки "Подробнее" | MESS_BTN_DETAIL | Задается текст, который должен быть отображен на кнопке "Подробнее". | |||||||||||||||||
Сообщение об отсутствии товара | MESS_NOT_AVAILABLE | Указывается текст, который будет отображаться при отсутствии товара и невозможности его купить. | |||||||||||||||||
Сообщение о недоступности услуги | MESS_NOT_AVAILABLE_SERVICE | Указывается текст, который будет отображаться при недоступности услуги. | |||||||||||||||||
Шаблоны ссылок | |||||||||||||||||||
URL, ведущий на страницу с содержимым раздела | SECTION_URL | Указывается путь к странице с детальным содержимым раздела. | |||||||||||||||||
URL, ведущий на страницу с содержимым элемента раздела | DETAIL_URL | Указывается путь к странице с детальным описанием элемента раздела. | |||||||||||||||||
Название переменной, в которой передается количество товара | PRODUCT_QUANTITY_VARIABLE | Задается имя переменной, в которой будет передаваться количество товара. | |||||||||||||||||
Управление адресами страниц | |||||||||||||||||||
Включить поддержку ЧПУ | SEF_MODE |
[Y|N] При отмеченной опции включается поддержка ЧПУ и становятся доступными
поля настройки ЧПУ.
|
|||||||||||||||||
Настройки кеширования | |||||||||||||||||||
Тип кеширования | CACHE_TYPE |
Тип кеширования:
|
|||||||||||||||||
Время кеширования (сек.) | CACHE_TIME | Время кеширования, указанное в секундах. | |||||||||||||||||
Учитывать права доступа | CACHE_GROUPS | [Y|N] При отмеченной опции будут учитываться права доступа при кешировании. | |||||||||||||||||
Дополнительные настройки | |||||||||||||||||||
Кешировать при установленном фильтре | CACHE_FILTER | [Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться. | |||||||||||||||||
Включить режим совместимости | COMPATIBLE_MODE | [Y|N] При отмеченной опции будет включен режим совместимости. Опцию необходимо отмечать при наличии старого кастомизированного шаблона компонента версии ниже 16.6.2 модуля Информационные блоки. | |||||||||||||||||
Настройки действий | |||||||||||||||||||
Название переменной, в которой передается действие | ACTION_VARIABLE | Задается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице. | |||||||||||||||||
Название переменной, в которой передается код товара для покупки | PRODUCT_ID_VARIABLE | Задается имя переменной, в которой будет передаваться идентификатор товара. | |||||||||||||||||
Цены | |||||||||||||||||||
Тип цены | PRICE_CODE | Указывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара и кнопки Купить и В корзину показаны не будут. | |||||||||||||||||
Использовать вывод цен с диапазонами | USE_PRICE_COUNT | [Y/N] При отмеченной опции будут отображаться цены всех типов на товары. | |||||||||||||||||
Выводить цены для количества | SHOW_PRICE_COUNT | Параметр определяет количество единиц товара, для которых выводить стоимость. | |||||||||||||||||
Включать НДС в цену | PRICE_VAT_INCLUDE | [Y|N] При отмеченной опции цены будут показаны с учетом НДС. | |||||||||||||||||
Показывать цены в одной валюте | CONVERT_CURRENCY |
При установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах; станет доступным
дополнительное окно
|
|||||||||||||||||
Добавление в корзину | |||||||||||||||||||
URL, ведущий на страницу с корзиной покупателя | BASKET_URL | Указывается путь к странице с корзиной покупателя. | |||||||||||||||||
Разрешить указание количества товара | USE_PRODUCT_QUANTITY | [Y|N] При отмеченной опции будет разрешен вывод количества товара. | |||||||||||||||||
Добавлять в корзину свойства товаров и предложений | ADD_PROPERTIES_TO_BASKET |
[Y|N] При отмеченной опции становятся доступными
настройки выбора свойств товаров и предложений
|
|||||||||||||||||
Показывать кнопку добавления в корзину или покупки | ADD_TO_BASKET_ACTION | Выберите какая кнопка должна отображаться: кнопка покупки (BUY) или кнопка добавления в корзину (ADD). | |||||||||||||||||
Сравнение товаров | |||||||||||||||||||
Разрешить сравнение товаров | DISPLAY_COMPARE |
[Y|N] Если опция отмечена, то будет отображаться кнопка для сравнения товаров, станет активным
дополнительное окно
|
|||||||||||||||||
Уникальное имя для списка сравнения | COMPARE_NAME | Задается имя переменной, в которой передается список сравниваемых элементов. По умолчанию CATALOG_COMPARE_LIST. | |||||||||||||||||
Настройки аналитики | |||||||||||||||||||
Отправлять данные электронной торговли в Google и Яндекс | USE_ENHANCED_ECOMMERCE |
[Y|N] Включение опции. После включения станут доступны ещё
два поля
Примечание: Настройка Яндекс метрикой не сложна, и данные в ней отображаются довольно быстро (полчаса-час). У Google используется Google Tag Manager с плагином электронной коммерции, его нужно настроить и добавить на страницу в шаблоне. После настройки на "той" стороне, нужно настроить компоненты для работы с электронной коммерцией и включить это поле настройки. |
|||||||||||||||||
Служебные параметры (не отображаются в настройках компонента) | |||||||||||||||||||
Кастомная сортировка по произвольному числу параметров | CUSTOM_ELEMENT_SORT | Данный служебный параметр можно передать в вызове компонента. Тип параметра - массив. Структура массива соответствует ключу $arOrder метода CIBlockElement::GetList. | Доступно с версии модуля iblock 20.0.400.
Параметр не используется в штатных шаблонах комплексного компонента catalog. |
Если же все значения совпадают, то будет показано то торговое предложение, у которого сортировка участвующих в выборе SKU значений свойств минимальна.
Пример вызова
<?$APPLICATION->IncludeComponent( "bitrix:catalog.top", "", Array( "ACTION_VARIABLE" => "action", "ADD_PICT_PROP" => "MORE_PHOTO", "ADD_PROPERTIES_TO_BASKET" => "Y", "ADD_TO_BASKET_ACTION" => "ADD", "BASKET_URL" => "/personal/basket.php", "BRAND_PROPERTY" => "BRAND_REF", "CACHE_FILTER" => "N", "CACHE_GROUPS" => "Y", "CACHE_TIME" => "36000000", "CACHE_TYPE" => "A", "COMPARE_NAME" => "CATALOG_COMPARE_LIST", "COMPARE_PATH" => "", "COMPATIBLE_MODE" => "N", "CONVERT_CURRENCY" => "Y", "CURRENCY_ID" => "RUB", "CUSTOM_FILTER" => "{\"CLASS_ID\":\"CondGroup\",\"DATA\":{\"All\":\"OR\",\"True\":\"True\"},\"CHILDREN\":{\"4\":{\"CLASS_ID\":\"CondIBSection\",\"DATA\":{\"logic\":\"Equal\",\"value\":1}},\"6\":{\"CLASS_ID\":\"CondIBProp:2:8\",\"DATA\":{\"logic\":\"Equal\",\"value\":3}}}}", "DATA_LAYER_NAME" => "dataLayer", "DETAIL_URL" => "", "DISCOUNT_PERCENT_POSITION" => "bottom-right", "DISPLAY_COMPARE" => "N", "ELEMENT_COUNT" => "9", "ELEMENT_SORT_FIELD" => "sort", "ELEMENT_SORT_FIELD2" => "id", "ELEMENT_SORT_ORDER" => "asc", "ELEMENT_SORT_ORDER2" => "desc", "ENLARGE_PRODUCT" => "STRICT", "FILTER_NAME" => "", "HIDE_NOT_AVAILABLE" => "L", "HIDE_NOT_AVAILABLE_OFFERS" => "L", "IBLOCK_ID" => "2", "IBLOCK_TYPE" => "catalog", "LABEL_PROP" => array("SALELEADER"), "LABEL_PROP_MOBILE" => array(), "LABEL_PROP_POSITION" => "top-left", "LINE_ELEMENT_COUNT" => "", "MESS_BTN_ADD_TO_BASKET" => "В корзину", "MESS_BTN_BUY" => "Купить", "MESS_BTN_COMPARE" => "Сравнить", "MESS_BTN_DETAIL" => "Подробнее", "MESS_NOT_AVAILABLE" => "Нет в наличии", "MESS_NOT_AVAILABLE_SERVICE" => "Недоступно", "MESS_RELATIVE_QUANTITY_FEW" => "мало", "MESS_RELATIVE_QUANTITY_MANY" => "много", "MESS_SHOW_MAX_QUANTITY" => "Наличие", "OFFERS_CART_PROPERTIES" => array("COLOR_REF","SIZES_SHOES","SIZES_CLOTHES"), "OFFERS_FIELD_CODE" => array("",""), "OFFERS_LIMIT" => "5", "OFFERS_PROPERTY_CODE" => array("SIZES_SHOES","SIZES_CLOTHES","MORE_PHOTO",""), "OFFERS_SORT_FIELD" => "sort", "OFFERS_SORT_FIELD2" => "id", "OFFERS_SORT_ORDER" => "asc", "OFFERS_SORT_ORDER2" => "desc", "OFFER_ADD_PICT_PROP" => "MORE_PHOTO", "OFFER_TREE_PROPS" => array("COLOR_REF","SIZES_SHOES"), "PARTIAL_PRODUCT_PROPERTIES" => "N", "PRICE_CODE" => array("BASE"), "PRICE_VAT_INCLUDE" => "Y", "PRODUCT_BLOCKS_ORDER" => "price,props,sku,quantityLimit,quantity,buttons,compare", "PRODUCT_DISPLAY_MODE" => "Y", "PRODUCT_ID_VARIABLE" => "id", "PRODUCT_PROPERTIES" => array("NEWPRODUCT"), "PRODUCT_PROPS_VARIABLE" => "prop", "PRODUCT_QUANTITY_VARIABLE" => "", "PRODUCT_ROW_VARIANTS" => "[{'VARIANT':'2','BIG_DATA':false},{'VARIANT':'2','BIG_DATA':false},{'VARIANT':'2','BIG_DATA':false}]", "PRODUCT_SUBSCRIPTION" => "Y", "PROPERTY_CODE" => array("MANUFACTURER","MATERIAL",""), "PROPERTY_CODE_MOBILE" => array(), "RELATIVE_QUANTITY_FACTOR" => "5", "ROTATE_TIMER" => "30", "SECTION_URL" => "", "SEF_MODE" => "N", "SEF_RULE" => "", "SHOW_CLOSE_POPUP" => "N", "SHOW_DISCOUNT_PERCENT" => "Y", "SHOW_MAX_QUANTITY" => "M", "SHOW_OLD_PRICE" => "Y", "SHOW_PAGINATION" => "Y", "SHOW_PRICE_COUNT" => "1", "SHOW_SLIDER" => "Y", "SLIDER_INTERVAL" => "3000", "SLIDER_PROGRESS" => "N", "TEMPLATE_THEME" => "blue", "USE_ENHANCED_ECOMMERCE" => "Y", "USE_PRICE_COUNT" => "N", "USE_PRODUCT_QUANTITY" => "Y", "VIEW_MODE" => "SECTION" ) );?>