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" ) );?>
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.