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

top элементов каталога

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

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

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

Пример вызова компонента catalog.top

Секции настроек компонента:

  • Основные параметры
  • Источник данных
  • Настройки сортировки
  • Внешний вид
  • Шаблоны ссылок
  • Управление адресами страниц
  • Настройки кеширования
  • Дополнительные настройки
  • Настройки действий
  • Цены
  • Добавление в корзину
  • Сравнение товаров
  • Настройки аналитики
  • Описание параметров

    ПолеПараметрОписаниеПримечание
    Основные параметры
    Тип инфоблокаIBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
    ИнфоблокIBLOCK_IDДля выбранного типа инфоблоков указывается идентификатор информационного блока, из которого будет выводиться top элементов сгруппированных по разделам.
    Источник данных
    Имя массива со значениями фильтра для фильтрации элементовFILTER_NAMEЗадается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию.
    Фильтр товаровCUSTOM_FILTERВ данном поле настраиваются условия отбора товаров для показа. Выбор каждого условия осуществляется из выпадающего списка, доступного по ссылке Добавить условие. Для выбранного поля/свойства товара задается соответствие некоторому значению. Допускается создание нескольких условий и использование между ними как логики "И", так и логики "ИЛИ".

    Товары, недоступные для покупкиHIDE_NOT_AVAILABLEУказывается способ отборажения недоступных для покупки товаров:
    • не отображать;
    • отображать в конце;
    • отображать в общем списке.
    Примечание: недоступные для покупки товары - это товары, для которых количество меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
    Торговые предложения, недоступные для покупкиHIDE_NOT_AVAILABLE_OFFERSУказывается способ отборажения недоступных для покупки торговых предложений:
    • не отображать;
    • отображать только с возможностью подписки;
    • отображать все.
    Настройки сортировки
    По какому полю сортируем элементыELEMENT_SORT_FIELDУказывается поле, по которому будет происходить сортировка элементов:
    • shows – по количеству просмотров в среднем;
    • sort – по индексу сортировки;
    • timestamp_x – по дате изменения;
    • name – по названию;
    • id – по идентификатору;
    • active_from – по дате активности с;
    • active_to – по дате активности по;
    • CATALOG_AVAILABLE – по доступности на складах.
    Порядок сортировки элементовELEMENT_SORT_ORDERЗадается порядок сортировки элементов:
    • ascПо возрастанию;
    • descПо убыванию.
    Поле для второй сортировки элементовELEMENT_SORT_FIELD2Указывается поле, по которому будет происходить вторая сортировка элементов:
    • shows – по количеству просмотров в среднем;
    • sort – по индексу сортировки;
    • timestamp_x – по дате изменения;
    • name – по названию;
    • id – по идентификатору;
    • active_from – по дате активности с;
    • active_to – по дате активности по;
    • CATALOG_AVAILABLE – по доступности на складах.
    Порядок второй сортировки элементовELEMENT_SORT_ORDER2Задается порядок второй сортировки элементов:
    • ascПо возрастанию;
    • descПо убыванию.
    По какому полю сортируем предложения товараOFFERS_SORT_FIELDУказывается поле, по которому сортируется весь список предложений товара. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.

    См. примечание в конце страницы.
    Порядок сортировки предложений товараOFFERS_SORT_ORDERВыбирается как сортировать предложения товара: по возрастанию, или по убыванию. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
    Поле для второй сортировки предложений товараOFFERS_SORT_FIELD2Указывается поле, по которому выполняется вторая сортировка списка предложений товара. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.

    См. примечание в конце страницы.
    Порядок второй сортировки предложений товараOFFERS_SORT_ORDER2Выбирается направление второй сортировки предложений товара: по возрастанию, или по убыванию. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
    Внешний вид
    Свойства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] При отмеченной опции для товаров будет использоваться слайдер для показа изображений; станет доступным дополнительное окно
    Интервал смены слайдов, мсSLIDER_INTERVALУказывается интервал смены слайдов в миллисекундах. Параметр настраивается, если отмечена опция Показывать слайдер для товаров.
    Показывать полосу прогрессаSLIDER_PROGRESS[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Указывается текст, который будет отображаться при отсутствии товара и невозможности его купить.
    Шаблоны ссылок
    URL, ведущий на страницу с содержимым разделаSECTION_URLУказывается путь к странице с детальным содержимым раздела.
    URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
    Название переменной, в которой передается количество товараPRODUCT_QUANTITY_VARIABLEЗадается имя переменной, в которой будет передаваться количество товара.
    Управление адресами страниц
    Включить поддержку ЧПУSEF_MODE[Y|N] При отмеченной опции включается поддержка ЧПУ и становятся доступными поля настройки ЧПУ.
    Правило для обработкиSEF_RULEУказывается правило обработки вызова страницы. Для создания правила следует использовать шаблоны, доступные по кнопке [...].
    Настройки кеширования
    Тип кешированияCACHE_TYPEТип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.)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При установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах; станет доступным дополнительное окно
    Валюта, в которую будут сконвертированы ценыCURRENCY_IDВыбор валюты в которой будут отображаться цены.
    . При выборе этой опции кеш компонента будет автоматически сбрасываться при изменении курсов валют тех товаров, что показываются компонентом. К примеру, если выбрана конвертация в рубли, а цены в инфоблоке сохранены в евро, то кеш сбросится при изменении курса евро или рубля. Изменения остальных валют на кеш не окажут влияния.
    Добавление в корзину
    URL, ведущий на страницу с корзиной покупателяBASKET_URLУказывается путь к странице с корзиной покупателя.
    Разрешить указание количества товараUSE_PRODUCT_QUANTITY[Y|N] При отмеченной опции будет разрешен вывод количества товара.
    Добавлять в корзину свойства товаров и предложенийADD_PROPERTIES_TO_BASKET[Y|N] При отмеченной опции становятся доступными настройки выбора свойств товаров и предложений
    Название переменной, в которой передаются характеристики товараPRODUCT_PROPS_VARIABLEЗадается имя переменной, в которой будет передаваться характеристики товара.
    Разрешить добавлять в корзину товары, у которых заполнены не все характеристикиPARTIAL_PRODUCT_PROPERTIES[Y|N] При отмеченной опции в корзину будут добавляться и те товары, у которых заполнены не все характеристики. Если же опция не отмечена, то товар будет добавлен в корзину только при условии, что все характеристики, добавляемые в корзину, заполнены. На торговые предложения этот параметр не влияет.
    Характеристики товараPRODUCT_PROPERTIESУказываются характеристики товара.
    Свойства предложений, добавляемые в корзинуOFFERS_CART_PROPERTIESИз списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использоать клавишу Ctrl. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
    для передачи их в корзину и заказ.
    Показывать кнопку добавления в корзину или покупкиADD_TO_BASKET_ACTIONВыберите какая кнопка должна отображаться: кнопка покупки (BUY) или кнопка добавления в корзину (ADD).
    Сравнение товаров
    Разрешить сравнение товаровDISPLAY_COMPARE[Y|N] Если опция отмечена, то будет отображаться кнопка для сравнения товаров, станет активным дополнительное окно
    Путь к странице сравненияCOMPARE_PATHПуть к странице с компонентом сравнения товаров. Если значение параметра пустое, будет использована текущая страница.
    .
    Уникальное имя для списка сравненияCOMPARE_NAMEЗадается имя переменной, в которой передается список сравниваемых элементов. По умолчанию CATALOG_COMPARE_LIST.
    Настройки аналитики
    Отправлять данные электронной торговли в Google и ЯндексUSE_ENHANCED_ECOMMERCE[Y|N] Включение опции. После включения станут доступны ещё два поля
    Имя контейнера данныхDATA_LAYER_NAMEУказываются свойства инфоблока, которые будут отображены в списке просмотренных товаров. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
    Свойство брендовBRAND_PROPERTYИз списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использовать клавишу Ctrl.
    . Требуется дополнительная настройка в Google Analytics Enhanced Ecommerce и/или Яндекс.Метрике.

    Примечание: Настройка Яндекс метрикой не сложна, и данные в ней отображаются довольно быстро (полчаса-час). У Google используется Google Tag Manager с плагином электронной коммерции, его нужно настроить и добавить на страницу в шаблоне. После настройки на "той" стороне, нужно настроить компоненты для работы с электронной коммерцией и включить это поле настройки.

    Примечание: если указаны поля сортировки, отличные от ID и CATALOG_AVAILABLE, и значения этих полей для торговых предложений разные, то для выбора первого для показа предложения будет выбрано то предложение, которое отсортировано первым.
    Если же все значения совпадают, то будет показано то торговое предложение, у которого сортировка участвующих в выборе SKU значений свойств минимальна.



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

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

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

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

    Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
    © «Битрикс», 2001-2018, «1С-Битрикс», 2018
    Наверх