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

Список связанных элементов


Описание catalog.link.list

Компонент выводит список элементов, связанных с заданным. Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути Контент > Каталог > Список связанных элементов.

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



Параметры

Поле Параметр Описание
Основные параметры
Тип инфо-блока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, из которого будут выводиться список элементов.
Свойство, в котором хранится связь LINK_PROPERTY_SID Свойство, по которому связаны элементы, выбирается из списка или указывается в виде кода в поле рядом.
ID элемента ELEMENT_ID Поле содержит код, в котором передается идентификатор элемента, для которого выводится список связанных элементов.
Источник данных
По какому полю сортируем элементы ELEMENT_SORT_FIELD Указывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок сортировки элементов ELEMENT_SORT_ORDER Задается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Поле для второй сортировки элементов ELEMENT_SORT_FIELD2 Указывается поле, по которому будет происходить вторая сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок второй сортировки элементов ELEMENT_SORT_ORDER2 Задается порядок второй сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Имя массива со значениями фильтра для фильтрации элементов FILTER_NAME Задается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию.
Недоступные товары HIDE_NOT_AVAILABLE Указывается способ отборажения недоступных для покупки товаров:
  • не отображать;
  • отображать в конце;
  • отображать в общем списке.
Примечание: недоступные для покупки товары - это товары, для которых количество меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Недоступные торговые предложения HIDE_NOT_AVAILABLE_OFFERS Указывается способ отборажения недоступных для покупки торговых предложений:
  • не отображать;
  • отображать только с возможностью подписки;
  • отображать все.
Внешний вид
Количество элементов на странице PAGE_ELEMENT_COUNT Указывается количество элементов, отображаемых на одной странице. Все элементы будут выведены с помощью постраничной навигации.
Свойства PROPERTY_CODE Указываются свойства инфоблока, которые будут отображены при показе элементов в таблице. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения списка связанных элементов. По умолчанию используется синяя схема (blue).
Схема отображенияPRODUCT_DISPLAY_MODEЗадается режим отображения товаров: простой (N) или расширенный (Y).
Дополнительная картинка основного товараADD_PICT_PROPЗадается свойство, в котором хранится дополнительная картинка для основного товара.
Свойство меток товараLABEL_PROPУказываются свойство, в котором хранится метка товара (например, новинка).
Показывать процент скидкиSHOW_DISCOUNT_PERCENT[Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана.
Показывать старую ценуSHOW_OLD_PRICE[Y|N] Если задана скидка на товар, то при отмеченной опции будет отображаться старая цена.
Показывать кнопку продолжения покупок во всплывающих окнахSHOW_CLOSE_POPUP[Y|N] При отмеченной опции будет отображаться кнопка Продолжить покупки во всплывающем окне, появляющемся после добавления товара в корзину.
Текст кнопки "Купить"MESS_BTN_BUYЗадается текст, который должен быть отображен на кнопке "Купить".
Текст кнопки "Добавить в корзину"MESS_BTN_ADD_TO_BASKETЗадается текст, который должен быть отображен на кнопке добавления в корзину.
Текст кнопки "Подробнее"MESS_BTN_DETAILЗадается текст, который должен быть отображен на кнопке "Подробнее".
Сообщение об отсутствии товараMESS_NOT_AVAILABLEУказывается текст, который будет отображаться при отсутствии товара и невозможности его купить.
Шаблоны ссылок
URL, ведущий на страницу с содержимым раздела SECTION_URL Указывается путь к странице с детальным содержимым раздела.
URL, ведущий на страницу с содержимым элемента раздела DETAIL_URL Указывается путь к странице с детальным описанием элемента раздела.
URL, ведущий на страницу с корзиной покупателя BASKET_URL Указывается путь к странице с корзиной покупателя.
Название переменной, в которой передается код группы SECTION_ID_VARIABLE Задается имя переменной, в которой будет передаваться идентификатор раздела.
Управление режимом 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] При отмеченной опции будут учитываться права доступа при кешировании.
Кешировать при установленном фильтре CACHE_FILTER [Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.
Дополнительные настройки
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено название раздела связанного инфоблока.
Устанавливать в заголовках ответа время модификации страницыSET_LAST_MODIFIED[Y|N] При отмеченной опции http-ответ сервера будет содержать время последнего изменения страницы (заголовок Last-Modified).
Показывать кнопку добавления в корзину или покупкиADD_TO_BASKET_ACTIONВыберите какая кнопка должна отображаться: кнопка покупки (BUY) или кнопка добавления в корзину (ADD).
Настройки действий
Название переменной, в которой передается действие 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 [Y|N] При установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах; станет активным дополнительное окно
Валюта, в которую будут сконвертированы цены CURRENCY_ID Выбор валюты, в которой будут отображаться цены..
. При выборе этой опции кэш компонента будет автоматически сбрасываться при изменении курсов валют тех товаров, которые показываются компонентом. К примеру, если выбрана конвертация в рубли, а цены в информационном блоке сохранены в евро, то кэш сбросится при изменении курса евро или рубля. Изменения остальных валют на кэш не окажут влияния.
Сравнение товаров
Разрешить сравнение товаровDISPLAY_COMPARE[Y|N] Если опция отмечена, то будет отображаться кнопка для сравнения товаров, станет доступно дополнительное поле
Путь к странице сравненияCOMPARE_PATHПуть к странице с компонентом сравнения товаров.
.
Настройки постраничной навигации
Шаблон постраничной навигации 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] При отмеченной опции в постраничную навигацию будет добавлена ссылка Все, с помощью которой можно отобразить все элементы списка.


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

<?$APPLICATION->IncludeComponent("bitrix:catalog.link.list","",
Array(
		"AJAX_MODE" => "Y",
		"IBLOCK_TYPE" => "catalog_tovar",
		"IBLOCK_ID" => "1",
		"LINK_PROPERTY_SID" => "",
		"ELEMENT_ID" => $_REQUEST["PARENT_ELEMENT_ID"],
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD2" => "id",
		"ELEMENT_SORT_ORDER2" => "desc",
		"FILTER_NAME" => "arrFilter",
		"SECTION_URL" => "",
		"DETAIL_URL" => "",
		"BASKET_URL" => "/personal/basket.php",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
		"SECTION_ID_VARIABLE" => "SECTION_ID",
		"SET_TITLE" => "Y",
		"PAGE_ELEMENT_COUNT" => "30",
		"PROPERTY_CODE" => array(),
		"PRICE_CODE" => array(),
		"USE_PRICE_COUNT" => "N",
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "300",
		"CACHE_FILTER" => "Y",
		"CACHE_GROUPS" => "Y",
		"DISPLAY_TOP_PAGER" => "N",
		"DISPLAY_BOTTOM_PAGER" => "Y",
		"PAGER_TITLE" => "Товары",
		"PAGER_SHOW_ALWAYS" => "Y",
		"PAGER_TEMPLATE" => "",
		"PAGER_DESC_NUMBERING" => "N",
		"PAGER_DESC_NUMBERING_CACHE_TIME" => "36000",
		"PAGER_SHOW_ALL" => "Y",
		"HIDE_NOT_AVAILABLE" => "N",
		"CONVERT_CURRENCY" => "N",
		"AJAX_OPTION_JUMP" => "Y",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N",
		"PRODUCT_DISPLAY_MODE" => "Y",
		"TEMPLATE_THEME" => "blue",
		"SHOW_DISCOUNT_PERCENT" => "N",
		"SHOW_OLD_PRICE" => "N",
		"SHOW_CLOSE_POPUP" => "N",
		"MESS_BTN_BUY" => "Купить",
		"MESS_BTN_ADD_TO_BASKET" => "В корзину",
		"MESS_BTN_DETAIL" => "Подробнее",
		"MESS_NOT_AVAILABLE" => "Нет в наличии",
		"DISPLAY_COMPARE" => "N",
		"ADD_PICT_PROP" => "-",
		"LABEL_PROP" => "-",
		"PRODUCT_DISPLAY_MODE" => "N",
		"SET_LAST_MODIFIED" => "Y",
		"ADD_TO_BASKET_ACTION" => "ADD"
	)
);?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Иван Дюдиков
Сообщение не промодерировано, возможны ошибки и неточности.
Добрый день.
Вопрос как можно решить обратную задачу.
Т.е. получить список элементов которые имею привязку к данному элементу.
Т.е. задание связи задается не текущему элементу а другому. А ищем связь в обратную сторону.
Например, создали документ. Затем публикуем документ, который является корректирующим (изменяющим) этот документ. и для него указывает ссылку на старый документ. Эта связь понятна.
Но нужна и обратная связь тоже.
Желательно не добавлять еще одно свойство с обратной связью.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх