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

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

Описание 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

Включить режим AJAX

AJAX_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 ошибки

Устанавливать статус 404

SET_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"
	)
);?>

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх