Недоступно в редакциях: Стандарт, Старт

Рекомендуемые товары

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

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

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

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

Параметры

Поле

Параметр

Описание

Основные параметры

Тип инфоблока

IBLOCK_TYPE

Выбирается один из созданных в системе типов инфоблоков.

Идентификатор инфоблока товара

IBLOCK_ID

Для выбранного типа инфоблоков задается необходимый инфоблок.

Идентификатор товара

Задается числовой идентификатор товара. Можно не задавать, если указан Код товара.

Код товара

CODE

Указывается код товара. Можно не задавать, если указан Идентификатор товара.

Свойство привязки

PROPERTY_LINK

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

Свойство привязки для торговых предложений

OFFERS_PROPERTY_LINK

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

По какому полю сортируем элементы

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 – По убыванию.

Источник данных

Скрыть недоступные товары

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_NOT_AVAILABLE

Указывается текст, который будет отображаться при отсутствии товара и невозможности его купить.

Текст кнопки "Уведомить о поступлении"

MESS_BTN_SUBSCRIBE

Задается текст, который должен быть отображен на кнопке "Уведомить о поступлении".

Количество элементов на странице

PAGE_ELEMENT_COUNT

Указывается количество элементов, отображаемых на одной странице.

Количество элементов, выводимых в одной строке

LINE_ELEMENT_COUNT

Указывается количество элементов, выводимых в одной строке таблицы.

Данный параметр недоступен для шаблона vertical.

Цветовая тема

TEMPLATE_THEME

Задается цветовая схема для отображения списка элементов. По умолчанию используется синяя схема (blue).

Схема отображения

PRODUCT_DISPLAY_MODE

Задается режим отображения товаров: простой (N) или расширенный (Y). Параметр доступен для инфоблока с торговыми предложениями.

Шаблоны ссылок

URL, ведущий на страницу с содержимым элемента раздела

DETAIL_URL

Указывается путь к странице с детальным описанием элемента раздела.

Настройки кеширования

Тип кеширования

CACHE_TYPE

Тип кеширования:

A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
Y - Кешировать: для кеширования необходимо определить время кеширования;
N - Не кешировать: кеширования нет в любом случае.

Время кеширования (сек.)

CACHE_TIME

Время кеширования, указанное в секундах.

Цены

Показывать старую цену

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_каталога_предложений>

. Подробнее читайте в уроке.

Дополнительная картинка

ADDITIONAL_PICT_PROP_<ID_каталога_предложений>

Задается свойство, в котором хранится дополнительная картинка торгового предложения.

Свойства для отбора предложений

OFFER_TREE_PROPS_<ID_каталога_предложений>

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

. Подробнее читайте в уроке.

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

<?$APPLICATION->IncludeComponent(
"bitrix:catalog.recommended.products",
	"",
	Array(
		"IBLOCK_TYPE" => "books",
		"IBLOCK_ID" => "6",
		"ID" => "55",
		"CODE" => $_REQUEST["PRODUCT_CODE"],
		"PROPERTY_LINK" => "RECOMMEND",
		"OFFERS_PROPERTY_LINK" => "RECOMMEND",
		"HIDE_NOT_AVAILABLE" => "N",
		"SHOW_DISCOUNT_PERCENT" => "N",
		"PRODUCT_SUBSCRIPTION" => "N",
		"SHOW_NAME" => "Y",
		"SHOW_IMAGE" => "Y",
		"MESS_BTN_BUY" => "Купить",
		"MESS_BTN_DETAIL" => "Подробнее",
		"MESS_NOT_AVAILABLE" => "Нет в наличии",
		"MESS_BTN_SUBSCRIBE" => "Подписаться",
		"PAGE_ELEMENT_COUNT" => "30",
		"LINE_ELEMENT_COUNT" => "3",
		"TEMPLATE_THEME" => "blue",
		"DETAIL_URL" => "",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "86400",
		"SHOW_OLD_PRICE" => "N",
		"PRICE_CODE" => array(0=>"BASE",),
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
		"BASKET_URL" => "/personal/basket.php",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
		"PRODUCT_QUANTITY_VARIABLE" => "quantity",
		"ADD_PROPERTIES_TO_BASKET" => "Y",
		"PRODUCT_PROPS_VARIABLE" => "prop",
		"PARTIAL_PRODUCT_PROPERTIES" => "N",
		"USE_PRODUCT_QUANTITY" => "Y",
		"SHOW_PRODUCTS_28" => "Y",
		"PROPERTY_CODE_28" => array("WIDTH", "LENGHT"),
		"CART_PROPERTIES_28" => array("SIZE"),
		"ADDITIONAL_PICT_PROP_28" => "MORE_PHOTO",
		"LABEL_PROP_28" => "SPECIALOFFER",
		"PROPERTY_CODE_29" => array("SIZE", "COLOR"),
		"CART_PROPERTIES_29" => array("SIZE"),
		"OFFER_TREE_PROPS_29" => array("SIZE")
	)
);?>