Недоступно в редакциях: Стандарт, Старт
Подарки к выбранному товару
Описание 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-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.