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

Описание 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 Иван Дюдиков 15.08.2024 10:41:42 Сообщение не промодерировано, возможны ошибки и неточности.
Добрый день. Вопрос как можно решить обратную задачу. Т.е. получить список элементов которые имею привязку к данному элементу. Т.е. задание связи задается не текущему элементу а другому. А ищем связь в обратную сторону. Например, создали документ. Затем публикуем документ, который является корректирующим (изменяющим) этот документ. и для него указывает ссылку на старый документ. Эта связь понятна. Но нужна и обратная связь тоже. Желательно не добавлять еще одно свойство с обратной связью.

Наверх