Документация для разработчиков
Темная тема

Таблица сравнения


Описание catalog.compare.result

Компонент выводит таблицу сравниваемых элементов. Компонент стандартный, входит в дистрибутив модуля и содержит два шаблона: .default и bootstrap_v4.

В визуальном редакторе компонент расположен по пути Контент > Каталог > Таблица сравнения.

Компонент относится к модулю Информационные блоки.



Параметры

ПолеПараметрОписание
Источник данных
Уникальное имя для списка сравненияNAMEЗадается имя переменной, в которой передается список сравниваемых элементов. По умолчанию CATALOG_COMPARE_LIST.
Тип инфо-блокаIBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
Инфо-блокIBLOCK_IDДля выбранного типа инфоблоков указывается идентификатор информационного блока, элементы которого будут отфильтрованы.
ПоляFIELD_CODEУказываются поля элементов (товаров), по которым будет происходить сравнение в таблице сравнения. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),
При выборе пункта (не выбрано)-> и без указания полей в строках (т.е. если задан пустой массив), будут выведены поля по умолчанию.
СвойстваPROPERTY_CODEУказываются свойства инфоблока, которые будут отображены при показе в качестве полей фильтра. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках, свойства выведены не будут.
Поля предложенийOFFERS_FIELD_CODEВыбираются поля предложений. С помощью клавиши Ctrl можно выбрать несколько значений. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Свойства предложенийOFFERS_PROPERTY_CODEУказываются свойства предложений. Можно добавлять свои. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
По какому полю сортируем элементыELEMENT_SORT_FIELDУказывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок сортировки элементовELEMENT_SORT_ORDERЗадается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Внешний вид
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения таблицы сравнения. По умолчанию используется синяя схема (blue).
Управление режимом 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-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Дополнительные настройки
URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
Название переменной, в которой передается код группыSECTION_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор раздела.
Выводить список элементов инфоблокаDISPLAY_ELEMENT_SELECT_BOX[Y|N] При отмеченной опции после таблицы будет добавлен список элементов текущего инфоблока, которые можно добавить в таблицу.
По какому полю сортируем список элементовELEMENT_SORT_FIELD_BOXУказывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок сортировки списка элементовELEMENT_SORT_ORDER_BOXЗадается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Поле для второй сортировки списка элементовELEMENT_SORT_FIELD_BOX2Указывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок второй сортировки списка элементовELEMENT_SORT_ORDER_BOX2Задается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Не отображать недоступные товарыHIDE_NOT_AVAILABLE[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Указывается путь к странице с корзиной покупателя.


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

<?$APPLICATION->IncludeComponent (
"bitrix:catalog.compare.result",
	"",
	Array(
		"AJAX_MODE" => "Y",
		"NAME" => "CATALOG_COMPARE_LIST",
		"IBLOCK_TYPE" => "news",
		"IBLOCK_ID" => "2",
		"FIELD_CODE" => array(),
		"PROPERTY_CODE" => array(),
		"OFFERS_FIELD_CODE" => array(),
		"OFFERS_PROPERTY_CODE" => array(),
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"DETAIL_URL" => "",
		"BASKET_URL" => "/personal/basket.php",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
		"SECTION_ID_VARIABLE" => "SECTION_ID",
		"PRICE_CODE" => array(),
		"USE_PRICE_COUNT" => "Y",
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"DISPLAY_ELEMENT_SELECT_BOX" => "Y",
		"ELEMENT_SORT_FIELD_BOX" => "name",
		"ELEMENT_SORT_ORDER_BOX" => "asc",
		"ELEMENT_SORT_FIELD_BOX2" => "id",
		"ELEMENT_SORT_ORDER_BOX2" => "desc",
		"HIDE_NOT_AVAILABLE" => "N",
		"AJAX_OPTION_SHADOW" => "Y",
		"AJAX_OPTION_JUMP" => "Y",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "Y",
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
		"TEMPLATE_THEME" => "blue",
	)
);?>


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

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

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

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

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