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

Просмотренные товары


Описание catalog.products.viewed

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

В визуальном редакторе компонент расположен по пути Магазин > Информация о товарах > Просмотренные товары.

Компонент относится к модулю Торговый каталог.



Параметры

ПолеПараметрОписание
Источник данных
Показывать товары изIBLOCK_MODEУказывается как выбирать для отображения просмотренные товары: из одного инфоблока ("single") или из нескольких ("multi"). Если выбрано значение одного инфоблока, то необходимо настроить параметры инфоблока ниже.
Тип инфоблока*IBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
Инфоблок*IBLOCK_IDДля выбранного типа инфоблоков указывается информационныйо блок, из которого будут выводиться просмотренные товары.
Показывать товары из раздела*SHOW_FROM_SECTION[Y|N] При отмеченной опции просмотренные товары будут показываться из того раздела, который указан в следующих настройках
ID разделаSECTION_IDУказывается идентификатор раздела, товары из которого должны быть показаны. Можно не указывать, если задан Код раздела.
Код разделаSECTION_CODEУказывается код раздела, товары из которого должны быть показаны. Можно не указывать, если задан ID раздела.
ID элемента, для которого будет выбран разделSECTION_ELEMENT_IDУказывается идентификатор элемента, по которому будет выбран раздел для показа товаров. Можно не указывать, если задан Символьный код элемента, для которого будет выбран раздел.
Символьный код элемента, для которого будет выбран разделSECTION_ELEMENT_CODEУказывается код элемента, по которому будет выбран раздел для показа товаров. Можно не указывать, если задан ID элемента, для которого будет выбран раздел.
Максимальная отображаемая глубина разделовDEPTHПараметр определяет максимальную глубину вложенности разделов, из которых будут показаны товары.
: ID раздела, Код раздела, ID элемента, для которого будет выбран раздел и Символьный код элемента, для которого будет выбран раздел. Если опция не отмечена, то данные настройки скрыты.
Недоступные товарыHIDE_NOT_AVAILABLE[Y|N] При отмеченной опции будут скрыты товары, для которых общее количество на складах меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара. Товар, имеющий торговое предложение, считается доступным, если есть хоть одно торговое предложение, доступное к покупке.
Недоступные торговые предложенияHIDE_NOT_AVAILABLE_OFFERSУказывается способ отображения недоступных для покупки торговых предложений:
  • не отображать;
  • отображать только с возможностью подписки;
  • отображать все.
Внешний вид
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения списка элементов. По умолчанию используется синяя схема (blue).
Порядок отображения блоков товараPRODUCT_BLOCKS_ORDERПеретаскивая блоки, определите необходимый вам порядок следования блоков товара.

Вариант отображения товаровPRODUCT_ROW_VARIANTSВ правой части поля выберите подходящий вам вариант отображения одной строки товаров на странице и перетащите его в левую часть. Аналогичным образом настройте остальные строки для формирования таблицы товаров.

Количество товаров на страницеPAGE_ELEMENT_COUNTОтображается информация по количеству товаров на странице в соответствии с выбранным вариантом отображения товаров.
Выделять товары в спискеENLARGE_PRODUCTВыберите способ выделения товаров в списке:
  • по выбранному шаблону (строго) - товар будет выделятся строго по настроенному варианту отображения товаров;
  • по свойству, подгонять по шаблону (в этом случае возможно изменение сортировки элементов) - в списке будет выделяться тот товар, для которого заполнено указанное в параметре Выделять по выбранному свойству свойство.
Примечание: выделение товаров осуществляется в том случае, если для показа списка товаров выбран хотя бы один вариант вида:

Показывать слайдер для товаровSHOW_SLIDER[Y|N] При отмеченной опции для товаров будет использоваться слайдер для показа изображений, для которого нужно задать интервал смены слайдов
Интервал смены слайдов, мсSLIDER_INTERVALУказывается интервал смены слайдов в миллисекундах.
.
Показывать полосу прогрессаSLIDER_PROGRESS[Y|N] При отмеченной опции будет отображаться полоса прогресса до начала показа следующего слайда.
Расположение меток товараLABEL_PROP_POSITIONВыберите подходящее место для меток на карточке товара.
Разрешить оповещения для отсутствующих товаровPRODUCT_SUBSCRIPTION[Y|N] При отмеченной опции клиент будет оповещаться, что интересующий его товар стал доступным для покупки.
Показывать процент скидкиSHOW_DISCOUNT_PERCENT[Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана. Можно указать место расположения
Расположение процента скидки"DISCOUNT_PERCENT_POSITIONВыберите подходящее место для отображения процентной скидки на карточке товара.
скидки.
Показывать старую ценуSHOW_OLD_PRICE[Y|N] Если задана скидка на товар, то при отмеченной опции будет отображаться старая цена.
Показывать остаток товараSHOW_MAX_QUANTITYУкажите способ отображения остатка товара:
  • не показывать;
  • с отображением реального остатка
    Текст для остаткаMESS_SHOW_MAX_QUANTITYЗадается текст для отображения информации о наличии товара.
    - в этом случае необходимо настроить параметр Текст для остатка;
  • с подменой остатка текстом
    Текст для остаткаMESS_SHOW_MAX_QUANTITYЗадается текст для отображения информации о наличии товара.
    Значение, от которого происходит подменаRELATIVE_QUANTITY_FACTORУказывается значение, меньше (больше) которого о количестве товара на складе будет отображаться выражение, что товара мало (много).
    Текст для значения большеMESS_RELATIVE_QUANTITY_MANYЗадается текст, который будет отображаться при наличии товара в количестве большем, чем значение в параметре Значение, от которого происходит подмена.
    Текст для значения меньшеMESS_RELATIVE_QUANTITY_FEWЗадается текст, который будет отображаться при наличии товара в количестве меньшем, чем значение в параметре Значение, от которого происходит подмена..
    - в этом случае необходимо настроить параметры Текст для остатка, Значение, от которого происходит подмена, Текст для значения больше и Текст для значения меньше.
Показывать кнопку продолжения покупок во всплывающих окнахSHOW_CLOSE_POPUP[Y|N] При отмеченной опции будет отображаться кнопка Продолжить покупки во всплывающем окне, появляющемся после добавления товара в корзину.
Текст кнопки "Купить"MESS_BTN_BUYЗадается текст, который должен быть отображен на кнопке "Купить".
Текст кнопки "Добавить в корзину"MESS_BTN_ADD_TO_BASKETЗадается текст, который должен быть отображен на кнопке добавления в корзину.
Текст кнопки "Уведомить о поступлении"MESS_BTN_SUBSCRIBEЗадается текст, который должен быть отображен на кнопке уведомления о поступлении товара.
Текст кнопки "Подробнее"MESS_BTN_DETAILЗадается текст, который должен быть отображен на кнопке "Подробнее".
Сообщение об отсутствии товараMESS_NOT_AVAILABLEУказывается текст, который будет отображаться при отсутствии товара и невозможности его купить.
Настройки кеширования
Тип кешированияCACHE_TYPEТип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
Учитывать права доступаCACHE_GROUPS[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Настройки действий
Название переменной, в которой передается действиеACTION_VARIABLEЗадается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action_cpv. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.
Название переменной, в которой передается код товара для покупки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] При отмеченной опции будет разрешено указывать количества товара; нужно заполнить дополнительное поле.
Название переменной, в которой передается количество товараPRODUCT_QUANTITY_VARIABLEЗадается имя переменной, в которой будет передаваться количество товара.
Добавлять в корзину свойства товаров и предложенийADD_PROPERTIES_TO_BASKET[Y|N] При отмеченной опции свойства товаров и предложений будут передаваться в корзину. Кроме того, становятся доступными для настройки параметры
Название переменной, в которой передаются характеристики товараPRODUCT_PROPS_VARIABLEЗадается имя переменной, в которой будет передаваться характеристики товара.
Разрешить добавлять в корзину товары, у которых заполнены не все характеристикиPARTIAL_PRODUCT_PROPERTIES[Y|N] При отмеченной опции в корзину будут добавляться и те товары, у которых заполнены не все характеристики. Если же опция не отмечена, то товар будет добавлен в корзину только при условии, что все характеристики, добавляемые в корзину, заполнены. На торговые предложения этот параметр не влияет.
Название переменной, в которой передаются характеристики товара и Разрешить добавлять в корзину товары, у которых заполнены не все характеристики.
Показывать кнопку добавления в корзину или покупкиADD_TO_BASKET_ACTIONВыберите какая кнопка должна отображаться: кнопка покупки (BUY) или кнопка добавления в корзину (ADD).
Сравнение товаров
Разрешить сравнение товаровDISPLAY_COMPARE[Y|N] Включение функционала сравнения. После включения появляются дополнительные три поля.
Путь к странице сравненияCOMPARE_PATHПуть к странице с компонентом сравнения товаров. Если значение параметра пустое, будет использована текущая страница
Текст кнопки "Сравнить"MESS_BTN_COMPAREЗамена текста по умолчанию для кнопки сравнения.
Уникальное имя для списка сравненияCOMPARE_NAMEЗадается код для списка сравнения.
Параметры вывода товаров из каталога <название_каталога>
Показывать товары каталогаSHOW_PRODUCTS_<ID_каталога>[Y|N] При отмеченной опции товары из данного каталога будут отображаться среди рекомендованных товаров. Если опция не отмечена, то товары из данного каталога не будут отображаться среди рекомендованных, даже если они указаны в карточке товара.

Если данная опция отмечена, то становятся доступными для настройки параметры отображения товаров каталога и соответствующих торговых предложений (при наличии).
Свойства для отображенияPROPERTY_CODE_<ID_каталога>Указываются свойства инфоблока, которые будут отображены в списке рекомендованных товаров. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Свойства для добавления в корзинуCART_PROPERTIES_<ID_каталога>Из списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использовать клавишу Ctrl.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Дополнительная картинкаADDITIONAL_PICT_PROP_<ID_каталога>Задается свойство, в котором хранится дополнительная картинка для товара.
Свойство меток товараLABEL_PROP_<ID_каталога>Указываются свойство, в котором хранится метка товара (например, новинка).
Параметры вывода торговых предложений <название_каталога_предложений>
Секция доступна, если отмечена опция Показывать товары каталога
Свойства для отображенияPROPERTY_CODE_<ID_каталога_предложений>Указываются свойства торговых предложений, которые должны быть отображены в списке.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Свойства для добавления в корзинуCART_PROPERTIES_<ID_каталога_предложений>Из списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использовать клавишу Ctrl.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Дополнительная картинкаADDITIONAL_PICT_PROP_<ID_каталога_предложений>Задается свойство, в котором хранится дополнительная картинка торгового предложения.
Свойства для отбора предложенийOFFER_TREE_PROPS_<ID_каталога_предложений>Указываются свойства, по значениям которых будут группироваться торговые предложения.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Настройки аналитики
Отправлять данные электронной торговли в Google и Яндекс USE_ENHANCED_ECOMMERCE [Y|N] При отмеченной опции доступны для использования инструменты сервисов Google Analytics Enhanced Ecommerce и Яндекс.Метрики, следует заполнить Имя контейнера данных
Имя контейнера данных DATA_LAYER_NAME Указывается название для контейнера данных.
.

Важно! Требуются дополнительные настройки для использования сервисов.


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

<?$APPLICATION->IncludeComponent(
	"bitrix:catalog.products.viewed",
	"",
	Array(
		"ACTION_VARIABLE" => "action_cpv",
		"ADDITIONAL_PICT_PROP_2" => "MORE_PHOTO",
		"ADDITIONAL_PICT_PROP_3" => "-",
		"ADD_PROPERTIES_TO_BASKET" => "Y",
		"ADD_TO_BASKET_ACTION" => "BUY",
		"BASKET_URL" => "/personal/basket.php",
		"CACHE_GROUPS" => "Y",
		"CACHE_TIME" => "3600",
		"CACHE_TYPE" => "A",
		"CART_PROPERTIES_2" => array("NEWPRODUCT","NEWPRODUCT,SALELEADER",""),
		"CART_PROPERTIES_3" => array("COLOR_REF","SIZES_SHOES",""),
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
		"DATA_LAYER_NAME" => "dataLayer",
		"DEPTH" => "",
		"DISCOUNT_PERCENT_POSITION" => "top-right",
		"ENLARGE_PRODUCT" => "STRICT",
		"ENLARGE_PROP_2" => "NEWPRODUCT",
		"HIDE_NOT_AVAILABLE" => "N",
		"HIDE_NOT_AVAILABLE_OFFERS" => "L",
		"IBLOCK_ID" => "2",
		"IBLOCK_MODE" => "single",
		"IBLOCK_TYPE" => "catalog",
		"LABEL_PROP_2" => array("NEWPRODUCT"),
		"LABEL_PROP_MOBILE_2" => array(),
		"LABEL_PROP_POSITION" => "top-left",
		"MESS_BTN_ADD_TO_BASKET" => "В корзину",
		"MESS_BTN_BUY" => "Купить",
		"MESS_BTN_DETAIL" => "Подробнее",
		"MESS_BTN_SUBSCRIBE" => "Подписаться",
		"MESS_NOT_AVAILABLE" => "Нет в наличии",
		"MESS_RELATIVE_QUANTITY_FEW" => "мало",
		"MESS_RELATIVE_QUANTITY_MANY" => "много",
		"MESS_SHOW_MAX_QUANTITY" => "Наличие",
		"OFFER_TREE_PROPS_3" => array("COLOR_REF","SIZES_SHOES","SIZES_CLOTHES"),
		"PAGE_ELEMENT_COUNT" => "8",
		"PARTIAL_PRODUCT_PROPERTIES" => "N",
		"PRICE_CODE" => array("BASE"),
		"PRICE_VAT_INCLUDE" => "Y",
		"PRODUCT_BLOCKS_ORDER" => "price,props,quantityLimit,sku,quantity,buttons,compare",
		"PRODUCT_ID_VARIABLE" => "id",
		"PRODUCT_PROPS_VARIABLE" => "prop",
		"PRODUCT_QUANTITY_VARIABLE" => "",
		"PRODUCT_ROW_VARIANTS" => "[{'VARIANT':'3','BIG_DATA':false},{'VARIANT':'3','BIG_DATA':false}]",
		"PRODUCT_SUBSCRIPTION" => "Y",
		"PROPERTY_CODE_2" => array("NEWPRODUCT","SALELEADER","SPECIALOFFER","MANUFACTURER","MATERIAL","COLOR","SALELEADER,SPECIALOFFER,MATERIAL,COLOR,KEYWORDS,BRAND_REF",""),
		"PROPERTY_CODE_3" => array("ARTNUMBER","COLOR_REF","SIZES_SHOES","SIZES_CLOTHES",""),
		"PROPERTY_CODE_MOBILE_2" => array(),
		"RELATIVE_QUANTITY_FACTOR" => "5",
		"SECTION_CODE" => "",
		"SECTION_ELEMENT_CODE" => "",
		"SECTION_ELEMENT_ID" => "",
		"SECTION_ID" => "",
		"SHOW_CLOSE_POPUP" => "N",
		"SHOW_DISCOUNT_PERCENT" => "Y",
		"SHOW_FROM_SECTION" => "N",
		"SHOW_MAX_QUANTITY" => "M",
		"SHOW_OLD_PRICE" => "Y",
		"SHOW_PRICE_COUNT" => "1",
		"SHOW_PRODUCTS_2" => "N",
		"SHOW_SLIDER" => "Y",
		"SLIDER_INTERVAL" => "3000",
		"SLIDER_PROGRESS" => "Y",
		"TEMPLATE_THEME" => "blue",
		"USE_ENHANCED_ECOMMERCE" => "N",
		"USE_PRICE_COUNT" => "N",
		"USE_PRODUCT_QUANTITY" => "Y"
	)
);?>


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

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

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

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

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