Документация для разработчиков
Темная тема

Персональные рекомендации (устаревший)

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

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

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

Внимание! Компонент устарел с версии 17.0.5, не отображается в визуальном редакторе для добавления. Для показа персональных рекомендаций используйте комплексный компонент Каталог Комплексный компонент осуществляет вывод полного каталога товаров из определенного инфоблока.

Описание компонента «Каталог (комплексный компонент)» в пользовательской документации.
или простой компонент Элементы раздела Компонент выводит список элементов раздела с указанным набором свойств.

Описание компонента «Элементы раздела» в пользовательской документации.
.

Подробнее о включении сервиса Персонализации читайте в уроке.

Параметры

ПолеПараметрОписание
Основные параметры
Тип рекомендацииRCM_TYPEВыбирается один из типов рекомендаций:
  • bestsell - Самые продаваемые;
  • personal - Персональные рекомендации;
  • similar_sell - Продаваемые с этим товаром;
  • similar_view - Просматриваемые с этим товаром;
  • similar - Похожие товары;
  • any_similar - Продаваемые/Просматриваемые/Похожие товары;
  • any_personal - Самые продаваемые/Персональные;
  • any - Любая рекомендация.
Параметр ID продукта (для товарных рекомендаций)IDДля товарных рекомендаций (Продаваемые с этим товаром, Просматриваемые с этим товаром, Похожие товары, Продаваемые/Просматриваемые/Похожие товары, Самые продаваемые/Персональные и Любая рекомендация) необходимо обязательно передавать идентификатор товара.
Тип инфоблокаIBLOCK_TYPEВыбирается один из созданных в системе типов инфоблоков.
ИнфоблокIBLOCK_IDЗадается инфоблок, товары из которого должны быть показаны.
Источник данных
Показывать товары из разделаSHOW_FROM_SECTION[Y|N] При отмеченной опции товары по персональной рекомендации будут показываться из того раздела, который указан в нижеследующих настройках: ID раздела, Код раздела, ID элемента, для которого будет выбран раздел и Символьный код элемента, для которого будет выбран раздел. Если опция не отмечена, то данные настройки скрыты.
ID разделаSECTION_IDУказывается идентификатор раздела, товары из которого должны быть показаны. Можно не указывать, если задан Код раздела.
Код разделаSECTION_CODEУказывается код раздела, товары из которого должны быть показаны. Можно не указывать, если задан ID раздела.
ID элемента, для которого будет выбран разделSECTION_ELEMENT_IDУказывается идентификатор элемента, по которому будет выбран раздел для показа товаров. Можно не указывать, если задан Символьный код элемента, для которого будет выбран раздел.
Символьный код элемента, для которого будет выбран разделSECTION_ELEMENT_CODEУказывается код элемента, по которому будет выбран раздел для показа товаров. Можно не указывать, если задан ID элемента, для которого будет выбран раздел.
Максимальная отображаемая глубина разделовDEPTHПараметр определяет максимальную глубину вложенности разделов, из которых будут показаны товары.
Не отображать товары, которых нет на складахHIDE_NOT_AVAILABLE[Y|N] При отмеченной опции будут скрыты товары, для которых общее количество на складах меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Внешний вид
Показывать процент скидкиSHOW_DISCOUNT_PERCENT[Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана.
Разрешить оповещения для отсутствующих товаровPRODUCT_SUBSCRIPTION[Y|N] При отмеченной опции клиент будет оповещаться, что интересующий его товар стал доступным для покупки.
Показывать названиеSHOW_NAME[Y|N] При отмеченной опции будет отображено название товара.
Показывать изображениеSHOW_IMAGE[Y|N] При отмеченной опции будет показано изображение товара.
Текст кнопки "Купить"MESS_BTN_BUYЗадается текст, который должен быть отображен на кнопке "Купить".
Текст кнопки "Подробнее"MESS_BTN_DETAILЗадается текст, который должен быть отображен на кнопке "Подробнее".
Текст кнопки "Уведомить о поступлении"MESS_BTN_SUBSCRIBEЗадается текст, который должен быть отображен на кнопке "Уведомить о поступлении".
Количество элементов на страницеPAGE_ELEMENT_COUNTУказывается количество товаров, отображаемых на одной странице.
Количество элементов, выводимых в одной строкеLINE_ELEMENT_COUNTУказывается количество элементов, выводимых в одной строке таблицы.
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения товаров. По умолчанию используется синяя схема (blue).
Шаблоны ссылок
URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
Настройки кеширования
Тип кешированияCACHE_TYPEТип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
Учитывать права доступаCACHE_GROUPS[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Цены
Показывать старую ценуSHOW_OLD_PRICE[Y|N] Если задана скидка на товар, то при отмеченной опции будет отображаться старая цена.
Тип ценыPRICE_CODEУказывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара и кнопка Купить показаны не будут.
Выводить цены для количестваSHOW_PRICE_COUNTПараметр определяет количество единиц товара, для которых выводить стоимость.
Включать НДС в ценуPRICE_VAT_INCLUDE[Y|N] При отмеченной опции цены будут показаны с учетом НДС.
Показывать цены в одной валютеCONVERT_CURRENCYПри установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах.
Валюта, в которую будут сконвертированы ценыCURRENCY_IDВыбор валюты, в которой будут отображаться цены.
Добавление в корзину
URL, ведущий на страницу с корзиной покупателяBASKET_URLУказывается путь к странице с корзиной покупателя.
Название переменной, в которой передается действиеACTION_VARIABLEЗадается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.
Название переменной, в которой передается код товара для покупкиPRODUCT_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор товара.
Название переменной, в которой передается количество товараPRODUCT_QUANTITY_VARIABLEЗадается имя переменной, в которой будет передаваться количество товара.
Добавлять в корзину свойства товаров и предложенийADD_PROPERTIES_TO_BASKET[Y|N] При отмеченной опции свойства товаров и предложений будут передаваться в корзину. Кроме того, становятся доступными для настройки параметры Название переменной, в которой передаются характеристики товара и Разрешить частично заполненные свойства.
Название переменной, в которой передаются характеристики товараPRODUCT_PROPS_VARIABLEЗадается имя переменной, в которой будет передаваться характеристики товара.
Разрешить частично заполненные свойстваPARTIAL_PRODUCT_PROPERTIES[Y|N] При отмеченной опции в корзину будут добавляться и те товары, у которых заполнены не все характеристики. Если же опция не отмечена, то товар будет добавлен в корзину только при условии, что все характеристики, добавляемые в корзину, заполнены. На торговые предложения этот параметр не влияет.
Разрешить указание количества товараUSE_PRODUCT_QUANTITY[Y|N] При отмеченной опции будет разрешено указывать количества товара.
Параметры вывода товаров из каталога "<название_каталога>"
Показывать товары каталога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_каталога_предложений>Указываются свойства, по значениям которых будут группироваться торговые предложения.

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

<?$APPLICATION->IncludeComponent(
"bitrix:catalog.bigdata.products",
	"",
	Array(
		"RCM_TYPE" => "any",
		"ID" => $_REQUEST["PRODUCT_ID"],
		"IBLOCK_TYPE" => "catalog",
		"IBLOCK_ID" => "2",
		"HIDE_NOT_AVAILABLE" => "N",
		"SHOW_DISCOUNT_PERCENT" => "Y",
		"PRODUCT_SUBSCRIPTION" => "N",
		"SHOW_NAME" => "Y",
		"SHOW_IMAGE" => "Y",
		"MESS_BTN_BUY" => "Купить",
		"MESS_BTN_DETAIL" => "Подробнее",
		"MESS_BTN_SUBSCRIBE" => "Подписаться",
		"PAGE_ELEMENT_COUNT" => "30",
		"LINE_ELEMENT_COUNT" => "3",
		"TEMPLATE_THEME" => "blue",
		"DETAIL_URL" => "/catalog/#SECTION_CODE#/#ELEMENT_CODE#/",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "36000000",
		"CACHE_GROUPS" => "Y",
		"SHOW_OLD_PRICE" => "N",
		"PRICE_CODE" => array("BASE"),
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"CONVERT_CURRENCY" => "Y",
		"BASKET_URL" => "/personal/cart/",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
		"ADD_PROPERTIES_TO_BASKET" => "Y",
		"PRODUCT_PROPS_VARIABLE" => "prop",
		"PARTIAL_PRODUCT_PROPERTIES" => "N",
		"USE_PRODUCT_QUANTITY" => "N",
		"SHOW_PRODUCTS_2" => "Y",
		"CURRENCY_ID" => "RUB",
		"PROPERTY_CODE_2" => array("NEWPRODUCT", "MANUFACTURER", "MATERIAL", "COLOR", ""),
		"CART_PROPERTIES_2" => array("NEWPRODUCT", ""),
		"ADDITIONAL_PICT_PROP_2" => "MORE_PHOTO",
		"LABEL_PROP_2" => "NEWPRODUCT",
		"PROPERTY_CODE_3" => array("COLOR_REF", "SIZES_SHOES", "SIZES_CLOTHES", ""),
		"CART_PROPERTIES_3" => array("COLOR_REF", "SIZES_SHOES", "SIZES_CLOTHES", ""),
		"ADDITIONAL_PICT_PROP_3" => "MORE_PHOTO",
		"OFFER_TREE_PROPS_3" => array("COLOR_REF", "SIZES_SHOES", "SIZES_CLOTHES"),
		"PRODUCT_QUANTITY_VARIABLE" => "quantity"
	)
);?>


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

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

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

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

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