Одностраничный компонент. Выводит все фотографии из выбранного раздела.
Пример вызова
<?$APPLICATION->IncludeComponent(
"bitrix:photo.section",
"",
Array(
"IBLOCK_TYPE" => "photo",
"IBLOCK_ID" => "8",
"SECTION_ID" => $_REQUEST["SECTION_ID"],
"SECTION_CODE" => "",
"ELEMENT_SORT_FIELD" => "sort",
"ELEMENT_SORT_ORDER" => "asc",
"FILTER_NAME" => "arrFilter",
"FIELD_CODE" => Array("NAME","SORT","",""),
"PROPERTY_CODE" => Array("",""),
"SECTION_URL" => "section.php?SECTION_ID=#SECTION_ID#",
"DETAIL_URL" => "detail.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
"PAGE_ELEMENT_COUNT" => "20",
"LINE_ELEMENT_COUNT" => "3",
"META_KEYWORDS" => "-",
"META_DESCRIPTION" => "-",
"DISPLAY_PANEL" => "N",
"SET_TITLE" => "Y",
"ADD_SECTIONS_CHAIN" => "Y",
"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"]}. Поле может быть оставлено пустым, если указан код раздела.
- SECTION_CODE
- Код раздела. Поле может быть оставлено пустым, если указан ID раздела.
Источник данных
- ELEMENT_SORT_FIELD
- Поле, по которому будет происходить сортировка фотографий:
- shows - по количеству просмотров в среднем;
- sort - по индексу сортировки;
- timestamp_x - по дате изменения;
- name - по названию;
- ID - по ID;
- active_from - по дате начала активности;
- active_to - по дате окончания активности.
Можно указать код любого другого поля. - ELEMENT_SORT_ORDER
- Порядок сортировки фотографий в разделе.
- asc – по возрастанию;
- desc – по убыванию.
- FILTER_NAME
- Задается имя переменной, в которой передается массив параметров из фильтра. Служит для определения выходящих из фильтра элементов. Значение по умолчанию arrFilter.
- FIELD_CODE
- Выбор полей, которые будут отображены на странице. Задается в виде массива с символьными именами полей в коде или в публичной части редактора, удерживая клавишу Ctrl. Если ничего не выбрано, то будут выведены поля по умолчанию.
- PROPERTY_CODE
- Свойства, которые будут отображены на странице. Задается в виде массива с символьными именами свойств в коде либо в публичной части редактора, удерживая клавишу Ctrl. Если ничего не выбрано, то свойства отображены не будут.
Внешний вид
- PAGE_ELEMENT_COUNT
- Количество элементов на одной странице. Остальные элементы будут выведены с помощью постраничной навигации.
- LINE_ELEMENT_COUNT
- Количество фотографий, выводимых в одной строке таблицы.
Шаблоны ссылок
- SECTION_URL
- URL, ведущий на страницу с содержимым раздела. По умолчанию поле содержит
section.php?SECTION_ID=#SECTION_ID#. - DETAIL_URL
- URL, ведущий на страницу с содержимым элемента раздела. По умолчанию поле содержит
detail.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#.
Настройки кэширования
- CACHE_TYPE
- Тип кеширования:
- А - Авто: действует при включенном автокешировании на странице Настройки кеширования (Настройки > Настройки продукта > Автокеширование) и при установленном времени кэширования в поле CACHE_TIME.
- Y - Кешировать: должно быть установлено время кеширования (CACHE_TIME). Настройки автокеширования не влияют на данный тип кеширования.
- N - Не кешировать: кеширование не происходит.
- CACHE_TIME
- Время кеширования в секундах.
- CACHE_FILTER
- Кешировать при установленном фильтре. При установленной опции каждый результат, полученный из фильтра будет кешироваться. Имеет смысл отмечать, если многие пользователи используют одну и туже выборку из фильтра.
Дополнительные настройки
- META_KEYWORDS
- Установить ключевые слова страницы из свойств инфоблока.
- META_DESCRIPTION
- Установить описание страницы из свойств инфоблока.
- DISPLAY_PANEL
- Добавлять кнопку в режиме редактирования сайта на Административной панели и в наборе кнопок области редактирования данного компонента
- SET_TITLE
- Устанавливать в качестве заголовка страницы будет установлено имя раздела.
- ADD_SECTIONS_CHAIN
- Включать раздел в цепочку навигации.
Настройки постраничной навигации
- DISPLAY_TOP_PAGER
- Навигация по страницам будет выведена вверху страницы, над списком.
- DISPLAY_BOTTOM_PAGER
- Навигация по страницам будет выведена внизу страницы, под списком.
- PAGER_TITLE
- Название категорий, по которым происходит перемещение при детальном просмотре (например, страница, глава и др.)
- PAGER_SHOW_ALWAYS
- Постраничная навигация не будет выводиться, если все элементы помещаются на одной странице. Если чекбокс отмечен, то всегда будет выводиться.
- PAGER_TEMPLATE
- Указывается имя шаблона постраничной навигации. Если поле пусто, то выбирается шаблон по умолчанию (.default). Также в системе задан шаблон orange.
- PAGER_DESC_NUMBERING
- Использовать обратную навигацию: при добавлении нового элемента постоянно меняется только последняя страница. Остальные страницы можно закэшировать на длительный срок. Это верно, если новые элементы попадают всегда вверх списка (отсортированы по дате начала активности по убыванию)..
- PAGER_DESC_NUMBERING_CACHE_TIME
- Время кеширования страниц для обратной навигации.