Каталог::Элементы раздела
Компонент выводит список элементов раздела с указанным набором свойств. Компонент стандартный и входит в дистрибутив модуля.
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:catalog.section","",Array(
"IBLOCK_TYPE" => "books",
"IBLOCK_ID" => "30",
"SECTION_ID" => $_REQUEST["SECTION_ID"],
"ELEMENT_SORT_FIELD" => "sort",
"ELEMENT_SORT_ORDER" => "asc",
"FILTER_NAME" => "arrFilter",
"SECTION_URL" => "section.php?IBLOCK_ID=#IBLOCK_ID#&SECTION_ID=#SECTION_ID#",
"DETAIL_URL" => "element.php?IBLOCK_ID=#IBLOCK_ID#&SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
"BASKET_URL" => "/personal/basket.php",
"ACTION_VARIABLE" => "action",
"PRODUCT_ID_VARIABLE" => "id",
"SECTION_ID_VARIABLE" => "SECTION_ID",
"META_KEYWORDS" => "-",
"META_DESCRIPTION" => "-",
"DISPLAY_PANEL" => "N",
"DISPLAY_COMPARE" => "Y",
"SET_TITLE" => "Y",
"PAGE_ELEMENT_COUNT" => "30",
"LINE_ELEMENT_COUNT" => "3",
"PROPERTY_CODE" => Array("YEAR","PUBLISHER","PAGES","",""),
"PRICE_CODE" => Array("WHOLESALE","RETAIL"),
"USE_PRICE_COUNT" => "Y",
"SHOW_PRICE_COUNT" => "1",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600",
"CACHE_FILTER" => "N",
"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"
)
);?>
Описание параметров
Основные параметры
- IBLOCK_TYPE
- Идентификатор типа информационного блока.
- IBLOCK_ID
- Идентификатор информационного блока выбранного типа.
- SECTION_ID
- Код, в котором передается ID раздела. Значение параметра по умолчанию: ={$_REQUEST[" SECTION _ID"]}.
Источник данных
- ELEMENT_SORT_FIELD
- Поле, по которому будет происходить сортировка элементов. Например, sort - индекс сортировки.
- ELEMENT_SORT_ORDER
- Направление сортировки:
- asc - по возрастанию;
- desc - по убыванию.
- FILTER_NAME
- Имя массива со значениями фильтра для фильтрации элементов. Если имя не указано, то будет использоваться значение по умолчанию.
Внешний вид
- PAGE_ELEMENT_COUNT
- Количество элементов на одной странице. Все элементы будут выведены с помощью постраничной навигации.
- LINE_ELEMENT_COUNT
- Количество элементов, выводимых в одной строке таблицы.
- PROPERTY_CODE
- Отображаемые свойства инфоблока.
Шаблоны ссылок
- SECTION_URL
- Путь к странице с детальным описанием раздела инфоблока.
- DETAIL_URL
- Путь к странице с детальным описанием элемента инфоблока.
- BASKET_URL
- Путь к странице с корзиной покупателя.
- ACTION_VARIABLE
- Имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию action.
- PRODUCT_ID_VARIABLE
- Имя переменной, в которой будет передаваться ID товара.
- SECTION_ID_VARIABLE
- Имя переменной, в которой будет передаваться ID раздела инфоблока.
Настройки кеширования
- CACHE_TYPE
- Тип кеширования:
- A - Авто: действует при включенном кешировании в течение заданного времени;
- Y - Кешировать: необходимо определить время кеширования;
- N - Не кешировать: кеширования нет в любом случае.
- CACHE_TIME
- Время кеширования, указанное в секундах.
Дополнительные настройки
- META_KEYWORDS
- Свойства ключевых слов страницы.
- META_DESCRIPTION
- Свойства описание страницы.
- DISPLAY_PANEL
- [Y/N] При выборе значения "Y" в Административную панель добавятся кнопки управления инфоблоками указанного типа.
- DISPLAY_COMPARE
- [Y/N] При выборе значения "Y" будет выведена кнопка Сравнить, с помощью которой элемент добавляется в список сравнения.
- SET_TITLE
- [Y/N] При выборе значения "Y" в качестве заголовка страницы установится название раздела.
- CACHE_FILTER
- [Y/N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.
Настройки постраничной навигации
- DISPLAY_TOP_PAGER
- [Y/N] При выборе значения "Y" навигация по страницам будет выведена наверху страницы.
- DISPLAY_BOTTOM_PAGER
- [Y/N] При выборе значения "Y" навигация по страницам будет выведена внизу страницы.
- PAGER_TITLE
- Название категорий, по которым происходит перемещение по элементам.
- PAGER_SHOW_ALWAYS
- [Y/N] При выборе значения "Y" постраничная навигация выводится, даже если все элементы помещаются на одной странице.
- PAGER_TEMPLATE
- Имя шаблона постраничной навигации. Если поле пусто, то выбирается шаблон по умолчанию (.default). Также в системе задан шаблон orange.
- PAGER_DESC_NUMBERING
- [Y/N] Механизм используют, если при добавлении элемента инфоблока, он всегда попадает наверх списка. Таким образом, меняется лишь последняя страница. Все предыдущие можно надолго закешировать.
- PAGER_DESC_NUMBERING_CACHE_TIME
- Время кеширования первых страниц в секундах при использовании обратной навигации.
Цены
- PRICE_CODE
- Указываются выводимые типы цен для элементов. Если не задан ни один из типов, то цена товара и кнопки Купить и В корзину показаны не будут.
- USE_PRICE_COUNT
- [Y/N] При выборе значения "Y" отображаются цены всех типов на товары .
- SHOW_PRICE_COUNT
- Количество единиц товара, для которого выводить стоимость.