Недоступно в редакциях: Стандарт, Старт
Подарки к выбранному товару
Описание 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] При отмеченной опции будет отображаться процентное значение скидки, если она задана. Можно указать
место расположения
| |||||||||||||||
Показывать старую цену | SHOW_OLD_PRICE | Опция отобразит старую, доскидочную цену. | |||||||||||||||
Показывать остаток товара | SHOW_MAX_QUANTITY | Указывается количество товара доступных для продажи. Доступны значения:
| |||||||||||||||
Показывать кнопку продолжения покупок во всплывающих окнах | 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 | Тип кеширования:
| |||||||||||||||
Время кеширования (сек.) | 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 | При установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах. При выборе данной опции станет активным
дополнительное поле.
| |||||||||||||||
Добавление в корзину | |||||||||||||||||
URL, ведущий на страницу с корзиной покупателя | BASKET_URL | Указывается путь к странице с корзиной покупателя. | |||||||||||||||
Разрешить указание количества товара | USE_PRODUCT_QUANTITY | [Y|N] При отмеченной опции будет разрешено указывать количества товара; нужно заполнить
дополнительное поле
| |||||||||||||||
Добавлять в корзину свойства товаров и предложений | ADD_PROPERTIES_TO_BASKET | [Y|N] При отмеченной опции свойства товаров и предложений будут передаваться в корзину и заказ. Свойства должны быть перечислены, если они влияют на выбор товара или включена возможность управлять свойствами в корзине (для торговых предложений), либо несут дополнительную информацию о товаре, которая необходима в заказе (например: клиент может сменить цвет в корзине, или цвет это другое торговое предложение и данное свойство показывает на этот выбор). Кроме того, становятся доступными для настройки параметры
| |||||||||||||||
Показывать кнопку добавления в корзину или покупки | BLOCK_TITLE | Выбор какую кнопку выводить. | |||||||||||||||
Сравнение товаров | |||||||||||||||||
Разрешить сравнение товаров | DISPLAY_COMPARE | [Y|N] Включение функционала сравнения. После включения появляются дополнительные
три поля.
| |||||||||||||||
Настройки аналитики | |||||||||||||||||
Отправлять данные электронной торговли в Google и Яндекс | USE_ENHANCED_ECOMMERCE | [Y|N] Включение опции. После включения станут доступны ещё
два поля.
|
Пример вызова
<?$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-2025, «1С-Битрикс», 2025