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

Выбор товара для получения подарка


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

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

Примечание. Товары в этом блоке отображаются только в том случае, если в настройках правила предоставления подарка в Дополнительных условиях указано только одно условие (Товар = или Раздел =).

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



Параметры

ПолеПараметрОписание
Основные параметры
Тип инфоблокаIBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
ИнфоблокIBLOCK_IDДля выбранного типа инфоблоков указывается инфоблок, из которого будет выводиться список товаров.
ID торгового предложения, по которому выводить товары, к которым торговое предложение является подаркомOFFER_IDУказывается идентификатор торгового предложения, по которому выводить товары, к которым торговое предложение является подарком.
ID элемента, по которому выводить товары, к которым торговое предложение является подаркомELEMENT_IDУказывается идентификатор элемента, по которому выводить товары, к которым торговое предложение является подарком.
Источник данных
Свойства разделаSECTION_USER_FIELDSУказываются свойства раздела, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, свойства не будут выведены.
По какому полю сортируем элементы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По убыванию.
Имя массива со значениями фильтра для фильтрации элементовFILTER_NAMEЗадается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию.
Показывать элементы подразделов разделаINCLUDE_SUBSECTIONS[Y|N] При отмеченной опции будут отображены элементы подразделов раздела.
Показывать все элементы, если не указан разделSHOW_ALL_WO_SECTION[Y|N] При отмеченной будут отображены все элементы, если не указан раздел.
Не отображать товары, которых нет на складахHIDE_NOT_AVAILABLE[Y|N] При отмеченной опции будут скрыты товары, для которых общее доступное количество меньше либо равно нулю (не остатки по складам), включен количественный учет и не разрешена покупка при отсутствии товара.
Внешний вид
Количество элементов на страницеPAGE_ELEMENT_COUNTУказывается количество элементов, отображаемых на одной странице. Все элементы будут выведены с помощью постраничной навигации.
Количество элементов выводимых в одной строке таблицыLINE_ELEMENT_COUNTУказывается количество элементов выводимых в одной строке таблицы.
СвойстваPROPERTY_CODEУказываются свойства инфоблока, которые будут отображены при показе элементов в таблице. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
Поля предложенийOFFERS_FIELD_CODEВыбираются поля предложений. С помощью клавиши Ctrl можно выбрать несколько значений. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Свойства предложенийOFFERS_PROPERTY_CODEУказываются свойства предложений. Можно добавлять свои. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
По какому полю сортируем предложения товараOFFERS_SORT_FIELDУказывается поле, по которому сортируется весь список предложений товара. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Порядок сортировки предложений товараOFFERS_SORT_ORDERВыбирается как сортировать предложения товара: по возрастанию, или по убыванию. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Поле для второй сортировки предложений товараOFFERS_SORT_FIELD2Указывается поле, по которому выполняется вторая сортировка списка предложений товара. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Порядок второй сортировки предложений товараOFFERS_SORT_ORDER2Выбирается порядок второй сортировки предложения товара: по возрастанию, или по убыванию. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Максимальное количество предложений для показаOFFERS_LIMITВыставляется максимальное для вывода на страницу число предложений (0 - все).
Установить фоновую картинку для шаблона из свойстваBACKGROUND_IMAGEУказывается свойство, в котором хранится картинка для фона.

Свойство должно быть немножественным типа Файл.

Важно! В шаблоне сайта должна быть реализована поддержка этого функционала: в необходимом вам теге должно быть прописано:
<?=$APPLICATION->ShowProperty("backgroundImage")?>
Шаблоны ссылок
URL, ведущий на страницу с содержимым разделаSECTION_URLУказывается путь к странице с детальным содержимым раздела.
URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
Название переменной, в которой передается код группыSECTION_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор раздела.
Управление адресами страниц
Включить поддержку ЧПУSEF_MODE[Y|N] При отмеченной опции включается поддержка ЧПУ и становятся доступными поля настройки ЧПУ; станут доступны дополнительные поля.
Правило для обработкиSEF_RULEУказывается правило обработки вызова страницы. Для создания правила следует использовать шаблоны, доступные по кнопке [...].
Путь из символьных кодов разделаSECTION_CODE_PATHЗадается путь из символьных кодов раздела инфоблока.
Управление режимом AJAX
Включить режим AJAXAJAX_MODE[Y|N] При установленной опции для компонента будет включен режим AJAX.
Включить прокрутку к началу компонентаAJAX_OPTION_JUMP[Y|N] Если пользователь совершит AJAX-переход, то при установленой опции по окончании загрузки произойдет прокрутка к началу компонента.
Включить подгрузку стилейAJAX_OPTION_STYLE[Y|N] Если параметр принимает значение "Y", то при совершении AJAX-переходов будет происходить подгрузка и обработка списка стилей, вызванных компонентом.
Включить эмуляцию навигации браузераAJAX_OPTION_HISTORY[Y|N] Когда пользователь выполняет AJAX-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Настройки кеширования
Тип кешированияCACHE_TYPEТип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
Учитывать права доступаCACHE_GROUPS[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Дополнительные настройки
Устанавливать заголовок страницыSET_TITLE[Y|N] При отмеченной опции в качестве заголовка страницы будет установлен заголовок раздела.
Устанавливать заголовок окна браузераSET_BROWSER_TITLE[Y|N] При отмеченной опции будет установлен заголовок окна браузера по заданному SEO-шаблону META TITLE (см. закладку "SEO" в инфоблоке) или из свойства (см. параметр "Установить заголовок окна браузера из свойства"
Установить заголовок окна браузера из свойстваBROWSER_TITLEСреди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится заголовок окна браузера.
).
Устанавливать ключевые слова страницыSET_META_KEYWORDS[Y|N] При отмеченной опции будут установлены ключевые слова страницы по заданному SEO-шаблону META KEYWORDS (см. закладку "SEO" в инфоблоке) или из свойства (см. параметр "Установить ключевые слова страницы из свойства"
Установить ключевые слова страницы из свойстваMETA_KEYWORDSСреди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержатся ключевые слова.
).
Устанавливать описание страницыSET_META_DESCRIPTION[Y|N] При отмеченной опции будет установлено описание страницы по заданному SEO-шаблону META DESCRIPTION (см. закладку "SEO" в инфоблоке) или из свойства (см. параметр "Установить описание страницы из свойства"
Установить описание страницы из свойстваMETA_DESCRIPTIONСреди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится описание.
).
Устанавливать в заголовках ответа время модификации страницыSET_LAST_MODIFIED[Y|N] При отмеченной опции http-ответ сервера будет содержать время последнего изменения страницы (заголовок Last-Modified).
Использовать основной раздел для показа элементаUSE_MAIN_ELEMENT_SECTION[Y|N] Если опция отмечена, то при переходе на детальную страницу элемента в адресную строку браузера будет подставляться тот путь, который формируется при просмотре элемента через основной раздел, даже если элемент открыт через другой родительский его раздел.

Если опция не отмечена, про ссылка на детальную страницу элемента формируется с учетом того раздела, через который элемент открыт на просмотр.

Рассмотрим пример, когда опция в настройках отмечена. Допустим, что элемент с символьным кодом marketing привязан к двум разделам с кодами bisness и science соответственно, причем раздел с кодом bisness является основным. В результате, если пользователь пришел в раздел science и кликнул на элемент marketing, то в строке браузера вместо http://mysite.ru/catalog/science/marketing/ будет отображено http://mysite.ru/catalog/bisness/marketing/.
Включать раздел в цепочку навигацииADD_SECTIONS_CHAIN[Y|N] При отмеченной опции название или заголовок (если задан в настройках SEO) раздела будет включен в строку навигации.
Кешировать при установленном фильтреCACHE_FILTER[Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.
Настройки действий
Название переменной, в которой передается действиеACTION_VARIABLEЗадается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.
Название переменной, в которой передается код товара для покупкиPRODUCT_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор товара.
Цены
Тип ценыPRICE_CODEУказывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара и кнопки Купить и В корзину показаны не будут.
Использовать вывод цен с диапазонамиUSE_PRICE_COUNT[Y/N] При отмеченной опции будут отображаться цены всех типов на товары.
Выводить цены для количества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Указываются характеристики товара.
Свойства предложений, добавляемые в корзинуOFFERS_CART_PROPERTIESИз списка выбираются свойства, которые можно добавить в корзину. Для выбора нескольких свойств нужно использоать клавишу Ctrl. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
.
Настройки постраничной навигации
Шаблон постраничной навигацииPAGER_TEMPLATEУказывается название шаблона постраничной навигации. Если поле пусто, то выбирается шаблон по умолчанию (.default).
Выводить над спискомDISPLAY_TOP_PAGER[Y|N] При отмеченной опции постраничная навигация будет выведена вверху страницы.
Выводить под спискомDISPLAY_BOTTOM_PAGER[Y|N] При отмеченной опции постраничная навигация будет выведена внизу страницы.
Название категорийPAGER_TITLEЗадается название категорий, по которым происходит перемещение по элементам.
Выводить всегдаPAGER_SHOW_ALWAYS[Y|N] При отмеченной опции постраничная навигация будет выводиться, даже если все элементы помещаются на одной странице.
Использовать обратную навигациюPAGER_DESC_NUMBERING[Y|N] При отмеченной опции будет использоваться обратная навигация. Для обратной навигации в системе происходит обратный отсчет страниц (последняя страница считается первой). Таким образом, постоянно меняется лишь последняя страница при добавлении нового элемента. Это верно, если новые элементы попадают всегда вверх списка (отсортированы по дате начала активности по убыванию).
Время кеширования страниц для обратной навигацииPAGER_DESC_NUMBERING_CACHE_TIMEЗадается время кеширования страниц в секундах для обратной навигации.
Показывать ссылку "Все"PAGER_SHOW_ALL[Y|N] При отмеченной опции в постраничную навигацию будет добавлена ссылка Все, с помощью которой можно отобразить все элементы раздела.
Включить обработку ссылокPAGER_BASE_LINK_ENABLE[Y|N] При отмеченной опции доступна обработка ссылок для постраничной навигации; станут доступны дополнительные поля
Url для построения ссылок (по умолчанию - автоматически)PAGER_BASE_LINKЗадается адрес для построения ссылок. Если в параметре ничего не указывать, то адрес будет построен автоматически.
Имя массива с переменными для построения ссылок в постраничной навигацииPAGER_PARAMS_NAMEЗадается имя переменной, в которой передается массив с переменными для построения ссылок компонентом постраничной навигации.
.
Настройки 404 ошибки
Устанавливать статус 404SET_STATUS_404[Y|N] Опция служит для включения обработки ошибки 404 в компоненте.
Показ специальной страницыSHOW_404[Y|N] При отмеченной опции будет показана специальная страница
Страница для показа (по умолчанию /404.php)FILE_404Задается адрес страницы, которая будет отображаться при возникновении ошибки 404.
в случае возникновения ошибки 404, в противном случае - будет отображено специальное сообщение
Сообщение для показа (по умолчанию из компонента)MESSAGE_404Задается сообщение, которое будет показано в случае возникновения ошибки 404. Если ничего не указывать, то будет использоваться стандартное сообщение из компонента.
.
Специальные настройки
Не подключать js-библиотеки в компонентеDISABLE_INIT_JS_IN_COMPONENT[Y|N] При отмеченной опции js-библиотека popup не будет подключаться в самом компоненте. Если шаблон компонента основан на шаблоне решения "Интернет-магазин" версии 12.5, то использование этой опции приведет к ограничению функционала.


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

<?$APPLICATION->IncludeComponent(
	"bitrix:sale.gift.main.products",
	"",
	Array(
		"ACTION_VARIABLE" => "action",
		"ADD_PROPERTIES_TO_BASKET" => "Y",
		"ADD_SECTIONS_CHAIN" => "N",
		"AJAX_MODE" => "N",
		"AJAX_OPTION_ADDITIONAL" => "",
		"AJAX_OPTION_HISTORY" => "N",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"BACKGROUND_IMAGE" => "-",
		"BASKET_URL" => "/personal/basket.php",
		"BROWSER_TITLE" => "-",
		"CACHE_FILTER" => "N",
		"CACHE_GROUPS" => "Y",
		"CACHE_TIME" => "36000000",
		"CACHE_TYPE" => "A",
		"COMPONENT_TEMPLATE" => ".default",
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
		"DETAIL_URL" => "/example/#SECTION_ID#/#ELEMENT_ID#",
		"DISABLE_INIT_JS_IN_COMPONENT" => "N",
		"DISPLAY_BOTTOM_PAGER" => "Y",
		"DISPLAY_TOP_PAGER" => "N",
		"ELEMENT_ID" => $_REQUEST["ELEMENT_ID"],
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_FIELD2" => "id",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_ORDER2" => "desc",
		"FILTER_NAME" => "arrFilter",
		"HIDE_NOT_AVAILABLE" => "N",
		"IBLOCK_ID" => "2",
		"IBLOCK_TYPE" => "catalog",
		"INCLUDE_SUBSECTIONS" => "Y",
		"LINE_ELEMENT_COUNT" => "3",
		"MESSAGE_404" => "",
		"META_DESCRIPTION" => "-",
		"META_KEYWORDS" => "-",
		"OFFERS_CART_PROPERTIES" => array("ARTNUMBER","COLOR_REF","SIZES_SHOES","SIZES_CLOTHES"),
		"OFFERS_FIELD_CODE" => array("",""),
		"OFFERS_LIMIT" => "5",
		"OFFERS_PROPERTY_CODE" => array("COLOR_REF","SIZES_SHOES","SIZES_CLOTHES",""),
		"OFFERS_SORT_FIELD" => "sort",
		"OFFERS_SORT_FIELD2" => "id",
		"OFFERS_SORT_ORDER" => "asc",
		"OFFERS_SORT_ORDER2" => "desc",
		"OFFER_ID" => $_REQUEST["OFFER_ID"],
		"PAGER_BASE_LINK_ENABLE" => "N",
		"PAGER_DESC_NUMBERING" => "N",
		"PAGER_DESC_NUMBERING_CACHE_TIME" => "36000",
		"PAGER_SHOW_ALL" => "N",
		"PAGER_SHOW_ALWAYS" => "N",
		"PAGER_TEMPLATE" => ".default",
		"PAGER_TITLE" => "Товары",
		"PAGE_ELEMENT_COUNT" => "30",
		"PARTIAL_PRODUCT_PROPERTIES" => "N",
		"PRICE_CODE" => array("BASE"),
		"PRICE_VAT_INCLUDE" => "Y",
		"PRODUCT_ID_VARIABLE" => "id",
		"PRODUCT_PROPERTIES" => array("MATERIAL"),
		"PRODUCT_PROPS_VARIABLE" => "prop",
		"PRODUCT_QUANTITY_VARIABLE" => "",
		"PROPERTY_CODE" => array("BRAND_REF","ARTNUMBER","MANUFACTURER","MATERIAL","COLOR",""),
		"SECTION_CODE_PATH" => "",
		"SECTION_ID_VARIABLE" => "SECTION_ID",
		"SECTION_URL" => "/example/#SECTION_ID#/",
		"SECTION_USER_FIELDS" => array("",""),
		"SEF_MODE" => "Y",
		"SEF_RULE" => "/example/#SECTION_ID#/",
		"SET_BROWSER_TITLE" => "Y",
		"SET_LAST_MODIFIED" => "N",
		"SET_META_DESCRIPTION" => "Y",
		"SET_META_KEYWORDS" => "Y",
		"SET_STATUS_404" => "N",
		"SET_TITLE" => "Y",
		"SHOW_404" => "N",
		"SHOW_ALL_WO_SECTION" => "N",
		"SHOW_PRICE_COUNT" => "1",
		"USE_MAIN_ELEMENT_SECTION" => "N",
		"USE_PRICE_COUNT" => "N",
		"USE_PRODUCT_QUANTITY" => "N"
	)
);?>


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

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

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

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

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