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

Подарки к выбранному товару


Описание sale.products.gift

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

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

С версии модуля sale 17.0.9 заменяет компонент sale.gift.product.

Компонент наследуются от класса компонентов списка \Bitrix\Iblock\Component\ElementList.

Компонент относится к модулю Интернет-магазин.



Параметры

ПолеПараметрОписание
Основные параметры
Тип инфоблока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Как отображать недоступные товары:
  • Отображать в общем списке
  • Отображать в конце
  • Не отображать
Недоступны товары, для которых количество меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Товар с торговыми предложениями считается доступным, если хоть одно предложение доступно.
Доступность товара не означает, что его можно купить. Для покупки должны быть цены тех типов, по которым клиент может покупать.
Недоступные торговые предложенияHIDE_NOT_AVAILABLE_OFFERSКак отображать недоступные торговые предложения
  • Отображать только с возможностью подписки
  • Отображать все
  • Не отображать
Недоступны предложения, для которых количество меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Доступность предложения не означает, что его можно купить. Для покупки должны быть цены тех типов, по которым клиент может покупать.
Настройки сортировки
По какому полю сортируем элементыELEMENT_SORT_FIELDУказывается поле, по которому будет происходить сортировка элементов текущего раздела.
Порядок сортировки элементовELEMENT_SORT_ORDERВ каком направлении будут отсортированы элементы, по возрастанию или по убыванию.
Поле для второй сортировки элементовELEMENT_SORT_FIELD2Указывается поле, по которому будет происходить вторичная сортировка элементов текущего раздела.
Порядок второй сортировки элементовELEMENT_SORT_ORDER2В каком направлении будут отсортированы элементы, по возрастанию или по убыванию во вторичной сортировке.
Внешний вид
Количество элементов на странице:PAGE_ELEMENT_COUNTЗначение поля определяет количество элементов на одной странице. Остальные элементы будут выведены с помощью постраничной навигации. Если заполнены поля секции Основные параметры, то выбор значений производится визуально с помощью drag&drop
СвойстваPROPERTY_CODEВыбор свойств инфоблока для отображения при показе элементов. При выборе пункта (не выбрано) и без указания кодов свойств в строках ниже, свойства выведены не будут.

Обратите внимание, что данный параметр недоступен при отмеченной опции Использовать параметры свойств в компонентах и формах . Подробнее читайте в уроке.
Свойства товаров, отображаемые на мобильных устройствахPROPERTY_CODE_MOBILEВыбор свойств инфоблока для отображения при показе элементов в мобильной версии сайта.
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения списка элементов. По умолчанию используется синяя схема (blue).
Выделять товары в спискеENLARGE_PRODUCTПо какому признаку выделяются товары: строго по шаблону, либо по признаку. Если выбрано По признаку, то необходимо указать признак в поле Выделять по выбранному свойству. Оба поля отображаются только если заданы параметры в секции Основные параметры
Порядок отображения блоков товараPRODUCT_BLOCKS_ORDER Визуальный выбор порядка отображения блоков товара.
Для некоторых блоков порядок может не соблюдаться в связи с особенностями шаблона. Блок товара может не отображаться если его функционал выключен или недоступен. Поле отображается только если заданы параметры в секции Основные параметры.
Показывать слайдер для товаровSHOW_SLIDER[Y|N] Товар будет отображён в слайдере. Поле отображается только если заданы параметры в секции Основные параметры.
Показывать полосу прогрессаSLIDER_PROGRESSСкорость смены слайдов. Поле отображается только если заданы параметры в секции Основные параметры.
Дополнительная картинка основного товараADD_PICT_PROPСвойство, откуда будут отображаться дополнительные картинки товара. Поле отображается только если заданы параметры в секции Основные параметры.
Свойства меток товараLABEL_PROPВыбрать метки, которые будут отображаться в товаре. После выбора укажите место расположения метки на фотографии. Поле отображается только если заданы параметры в секции Основные параметры.
Разрешить оповещения для отсутствующих товаровPRODUCT_SUBSCRIPTION[Y|N] При отмеченной опции клиент будет оповещаться, что интересующий его товар стал доступным для покупки.
Показывать процент скидкиSHOW_DISCOUNT_PERCENT[Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана. Можно указать место расположения
Расположение процента скидки DISCOUNT_PERCENT_POSITION Задается место расположения стикера на изображении: по центру, справа, слева или внизу.
скидки.
Показывать старую ценуSHOW_OLD_PRICEОпция отобразит старую, доскидочную цену.
Показывать остаток товараSHOW_MAX_QUANTITYУказывается количество товара доступных для продажи. Доступны значения:
  • Не показывать [N] - остаток не будет отображаться;
  • С отображением реального остатка
    Текст для остаткаMESS_SHOW_MAX_QUANTITYВозможность замены стандартного уведомления об остатке на свой текст.
    [Y] остаток будет выведен в виде числа;
  • С подменой остатка текстом
    Текст для остаткаMESS_SHOW_MAX_QUANTITYВозможность замены стандартного уведомления об остатке на свой текст.
    Значение, от которого происходит подменаRELATIVE_QUANTITY_FACTORКоличество товара с которого происходит замена текста о количестве. Сравнение происходит со значением, рассчитанным по формуле "Доступное количество"/"Коэффициент единицы измерения"
    Текст для значения большеMESS_RELATIVE_QUANTITY_MANYТекст выводится, если количество товара больше чем в поле Значение, от которого происходит подмена.
    Текст для значения меньшеMESS_RELATIVE_QUANTITY_FEWТекст выводится, если количество товара меньше чем в поле Значение, от которого происходит подмена.
    [M] - остаток будет выведен текстом
В зависимости от выбранного значения появляются или скрываются дополнительные поля.
Показывать кнопку продолжения покупок во всплывающих окнахSHOW_CLOSE_POPUPЕсли опция отмечена, во всплывающих окнах будет показана кнопка "Продолжить покупки".
Текст кнопки "Купить"MESS_BTN_BUYЗадается текст, который должен быть отображен на кнопке "Купить".
Текст кнопки "Добавить в корзину"MESS_BTN_ADD_TO_BASKETЗадается текст, который должен быть отображен на кнопке "Купить".
Текст кнопки "Подробнее"MESS_BTN_DETAILЗадается текст, который должен быть отображен на кнопке "Подробнее".
Текст кнопки "Уведомить о поступлении"MESS_BTN_SUBSCRIBEЗадается текст, который должен быть отображен на кнопке "Уведомить о поступлении".
Сообщение об отсутствии товараMESS_NOT_AVAILABLEТекст, который будет выведен при отсутствии товара.
Шаблоны ссылок
URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
Настройки кеширования
Тип кешированияCACHE_TYPEТип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
Учитывать права доступаCACHE_GROUPS[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Композитный сайт
Голосование шаблона компонента по умолчаниюCOMPOSITE_FRAME_MODEЗначения: Авто (актокомпозит), За, Против
Содержимое компонентаCOMPOSITE_FRAME_TYPEЧто должен выводить компонент при включённом композитном режиме. Подробнее
Настройки действий
Название переменной, в которой передается действие:ACTION_VARIABLEУказывается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action.
Название переменной, в которой передается код товара для покупкиPRODUCT_ID_VARIABLEИмя переменной, в которой будет передаваться ID товара.
Цены
Тип ценыPRICE_CODEУказывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара, кнопки В корзину и Купить показаны не будут.
Использовать вывод цен с диапазонамиSHOW_OLD_PRICEПри установленной опции для каждого товара выбираются все диапазоны цен, существующие у товара.
Выводить цены для количества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] При отмеченной опции в корзину будут добавляться и те товары, у которых заполнены не все характеристики. Если же опция не отмечена, то товар будет добавлен в корзину только при условии, что все характеристики, добавляемые в корзину, заполнены. На торговые предложения этот параметр не влияет.
Характеристики товараPRODUCT_PROPERTIESВыводимые харакетристики товара.
Название переменной, в которой передаются характеристики товара и Разрешить добавлять в корзину товары, у которых заполнены не все характеристики.
Показывать кнопку добавления в корзину или покупкиBLOCK_TITLEВыбор какую кнопку выводить.
Сравнение товаров
Разрешить сравнение товаровDISPLAY_COMPARE[Y|N] Включение функционала сравнения. После включения появляются дополнительные три поля.
Путь к странице сравненияCOMPARE_PATHПуть к странице с компонентом сравнения товаров. Если значение параметра пустое, будет использована текущая страница
Текст кнопки "Сравнить"MESS_BTN_COMPAREЗамена текста по умолчанию для кнопки сравнения.
Уникальное имя для списка сравненияCOMPARE_NAMEЗадается код для списка сравнения.
Настройки аналитики
Отправлять данные электронной торговли в Google и ЯндексUSE_ENHANCED_ECOMMERCE[Y|N] Включение опции. После включения станут доступны ещё два поля.
Имя контейнера данныхDATA_LAYER_NAMEУказываются свойства инфоблока, которые будут отображены в списке просмотренных товаров. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
Свойство брендовBRAND_PROPERTYИз списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использовать клавишу Ctrl.
Требуется дополнительная настройка в Google Analytics Enhanced Ecommerce и/или Яндекс.Метрике.


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

<?$APPLICATION->IncludeComponent(
	"bitrix:sale.products.gift",
	"",
	Array(
		"ACTION_VARIABLE" => "action",
		"ADD_PROPERTIES_TO_BASKET" => "Y",
		"ADD_TO_BASKET_ACTION" => "ADD",
		"BASKET_URL" => "/personal/basket.php",
		"CACHE_GROUPS" => "Y",
		"CACHE_TIME" => "36000000",
		"CACHE_TYPE" => "A",
		"COMPOSITE_FRAME_MODE" => "A",
		"COMPOSITE_FRAME_TYPE" => "AUTO",
		"CONVERT_CURRENCY" => "N",
		"DEPTH" => "2",
		"DETAIL_URL" => "",
		"DISPLAY_COMPARE" => "N",
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_FIELD2" => "id",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_ORDER2" => "desc",
		"HIDE_NOT_AVAILABLE" => "N",
		"HIDE_NOT_AVAILABLE_OFFERS" => "N",
		"IBLOCK_ID" => "",
		"IBLOCK_TYPE" => "news",
		"MESS_BTN_ADD_TO_BASKET" => "В корзину",
		"MESS_BTN_BUY" => "Купить",
		"MESS_BTN_DETAIL" => "Подробнее",
		"MESS_BTN_SUBSCRIBE" => "Подписаться",
		"MESS_NOT_AVAILABLE" => "Нет в наличии",
		"PAGE_ELEMENT_COUNT" => "4",
		"PARTIAL_PRODUCT_PROPERTIES" => "N",
		"PRICE_CODE" => array(),
		"PRICE_VAT_INCLUDE" => "Y",
		"PRODUCT_ID_VARIABLE" => "id",
		"PRODUCT_PROPERTIES" => array(),
		"PRODUCT_PROPS_VARIABLE" => "prop",
		"PRODUCT_QUANTITY_VARIABLE" => "quantity",
		"PRODUCT_SUBSCRIPTION" => "Y",
		"PROPERTY_CODE" => array("",""),
		"SECTION_CODE" => "",
		"SECTION_ELEMENT_CODE" => "",
		"SECTION_ELEMENT_ID" => $GLOBALS["CATALOG_CURRENT_ELEMENT_ID"],
		"SECTION_ID" => $GLOBALS["CATALOG_CURRENT_SECTION_ID"],
		"SHOW_CLOSE_POPUP" => "N",
		"SHOW_DISCOUNT_PERCENT" => "N",
		"SHOW_FROM_SECTION" => "N",
		"SHOW_MAX_QUANTITY" => "N",
		"SHOW_OLD_PRICE" => "N",
		"SHOW_PRICE_COUNT" => "1",
		"TEMPLATE_THEME" => "blue",
		"USE_ENHANCED_ECOMMERCE" => "N",
		"USE_PRICE_COUNT" => "N",
		"USE_PRODUCT_QUANTITY" => "N"
	)
);?>


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

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

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

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

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