Фотографии раздела

Описание photo.section

Одностраничный компонент выводит все фотографии из выбранного раздела. Компонент стандартный и входит в дистрибутив модуля.

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

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

Параметры

Поле

Параметр

Описание

Основные параметры

Тип инфоблока

IBLOCK_TYPE

Указывается один из созданных в системе типов информационного блока.

Инфоблок

IBLOCK_ID

Для выбранного типа инфоблока указывается идентификатор информационного блока, фотографии из которого будут выводиться.

ID раздела

SECTION_ID

Указывается числовой код, в котором передается идентификатор раздела. Поле может быть оставлено пустым, если указан Код раздела.

Код раздела

SECTION_CODE

Указывается символьный код раздела, из которого будут выбраны фотографии. Поле может быть оставлено пустым, если указан ID раздела.

Источник данных

Свойства раздела

SECTION_USER_FIELDS

Указываются свойства раздела, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, свойства не будут выведены.

По какому полю сортируем фотографии

ELEMENT_SORT_FIELD

Указывается поле, по которому будет происходить сортировка фотографий внутри каждого раздела:

SHOWS – по количеству просмотров в среднем;
SORT – по индексу сортировки;
TIMESTAMP_X – по дате последнего изменения;
NAME – по названию;
ID – по идентификатору;
ACTIVE_FROM – по дате активности с;
ACTIVE_TO – по дате активности по.

Порядок сортировки фотографий в разделе

ELEMENT_SORT_ORDER

Задается порядок сортировки фотографий в разделе:

ASC – По возрастанию;
DESC – По убыванию.

Имя массива со значениями фильтра для фильтрации элементов

FILTER_NAME

Задается имя переменной, в которой передается массив параметров из фильтра для фильтрации элементов. Служит для определения выходящих из фильтра элементов. Поле может быть оставлено пустым, тогда используется значение по умолчанию.

Поля

FIELD_CODE

Указываются поля, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:

Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),

При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив), на странице списка будут выведены поля по умолчанию.

Свойства

PROPERTY_CODE

Указываются свойства, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, на странице детального просмотра свойства не будут выведены.

Внешний вид

Количество элементов на странице

PAGE_ELEMENT_COUNT

Указывается количество элементов, выводимых на одной странице. Остальные элементы будут выведены с помощью постраничной навигации.

Количество фотографий, выводимых в одной строке таблицы

LINE_ELEMENT_COUNT

Указывается количество фотографий, выводимых в одной строке таблицы.

Шаблоны ссылок

URL, ведущий на страницу с содержимым раздела

SECTION_URL

Указывается адрес страницы с содержимым раздела.

URL, ведущий на страницу с содержимым элемента раздела

DETAIL_URL

Указывается адрес страницы с содержимым элемента раздела.

Управление режимом 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_FILTER

[Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.

Учитывать права доступа

CACHE_GROUPS

[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.

Дополнительные настройки

Установить ключевые слова страницы из свойства

META_KEYWORDS

Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержатся ключевые слова.

Установить описание страницы из свойства

META_DESCRIPTION

Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится описание.

Установить заголовок окна браузера из свойства

BROWSER_TITLE

Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится заголовок окна браузера.

Устанавливать заголовок страницы

SET_TITLE

[Y|N] При отмеченной опции в качестве заголовка страницы будет установлено имя раздела.

Устанавливать в заголовках ответа время модификации страницы

SET_LAST_MODIFIED

[Y|N] При отмеченной опции http-ответ сервера будет содержать время последнего изменения страницы (заголовок Last-Modified).

Включать раздел в цепочку навигации

ADD_SECTIONS_CHAIN

[Y|N] При отмеченной опции при переходе по разделам ифоблока в цепочку навигации будут добавлены названия разделов.

Настройки постраничной навигации

Выводить над списком

DISPLAY_TOP_PAGER

[Y|N] При отмеченной опции постраничная навигация будет выведена вверху страницы, над списком.

Выводить под списком

DISPLAY_BOTTOM_PAGER

[Y|N] При отмеченной опции постраничная навигация будет выведена внизу страницы, под списком.

Название категорий

PAGER_TITLE

Задается название категорий, по которым происходит перемещение при детальном просмотре (например, страница, глава и др.).

Выводить всегда

PAGER_SHOW_ALWAYS

[Y|N] При отмеченной опции постраничная навигация будет выводиться всегда, даже если все элементы помещаются на одной странице.

Название шаблона

PAGER_TEMPLATE

Указывается название шаблона постраничной навигации.

Использовать обратную навигацию

PAGER_DESC_NUMBERING

[Y|N] При отмеченной опции будет использоваться обратная навигация. Для обратной навигации в системе происходит обратный отсчет страниц (последняя страница считается первой). Таким образом, постоянно меняется лишь последняя страница при добавлении нового элемента. Это верно, если новые элементы попадают всегда вверх списка (отсортированы по дате начала активности по убыванию).

Время кеширования страниц для обратной навигации

PAGER_DESC_NUMBERING_CACHE_TIME

Задается время кеширования страниц для обратной навигации в сегундах.

Показывать ссылку "Все"

PAGER_SHOW_ALL

[Y|N] При отмеченной опции в постраничную навигацию будет добавлена ссылка Все, с помощью которой можно отобразить все фотографии раздела.

Включить обработку ссылок

PAGER_BASE_LINK_ENABLE

[Y|N] При отмеченной опции доступна обработка ссылок для постраничной навигации.Становятся активными дополнительные поля. Дополнительные поля:

Url для построения ссылок (по умолчанию - автоматически)	PAGER_BASE_LINK	Задается адрес для построения ссылок. Если в параметре ничего не указывать, то адрес будет построен автоматически.
Имя массива с переменными для построения ссылок в постраничной навигации	PAGER_PARAMS_NAME	Задается имя переменной, в которой передается массив с переменными для построения ссылок компонентом постраничной навигации.

Настройки 404 ошибки

Устанавливать статус 404

SET_STATUS_404

[Y|N] Опция служит для включения обработки ошибки 404 в компоненте.

Показ специальной страницы

SHOW_404

[Y|N] При отмеченной опции будет показана специальная страница Станет активным поле:

Страница для показа (по умолчанию /404.php)

FILE_404

Задается адрес страницы, которая будет отображаться при возникновении ошибки 404.

в случае возникновения ошибки 404, в противном случае - будет отображено специальное сообщение. Станет активным поле:

Сообщение для показа (по умолчанию из компонента)

MESSAGE_404

Задается сообщение, которое будет показано в случае возникновения ошибки 404. Если ничего не указывать, то будет использоваться стандартное сообщение из компонента.

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

<?$APPLICATION->IncludeComponent("bitrix:photo.section","",Array(
		"AJAX_MODE" => "Y",
		"IBLOCK_TYPE" => "photos",
		"IBLOCK_ID" => "22",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"SECTION_CODE" => "",
		"SECTION_USER_FIELDS" => "",
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"FILTER_NAME" => "arrFilter",
		"FIELD_CODE" => Array(),
		"PROPERTY_CODE" => Array(),
		"SECTION_URL" => "",
		"DETAIL_URL" => "",
		"PAGE_ELEMENT_COUNT" => "20",
		"LINE_ELEMENT_COUNT" => "3",
		"META_KEYWORDS" => "-",
		"META_DESCRIPTION" => "-",
		"BROWSER_TITLE" => "-",
		"SET_TITLE" => "Y",
		"PAGER_BASE_LINK_ENABLE" => "Y",
		"SET_STATUS_404" => "Y",
		"SHOW_404" => "Y",
		"MESSAGE_404" => "",
		"PAGER_BASE_LINK" => "",
		"PAGER_PARAMS_NAME" => "arrPager",
		"SET_LAST_MODIFIED" => "Y",
		"ADD_SECTIONS_CHAIN" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_FILTER" => "Y",
		"CACHE_GROUPS" => "Y",
		"DISPLAY_TOP_PAGER" => "Y",
		"DISPLAY_BOTTOM_PAGER" => "Y",
		"PAGER_TITLE" => "Фотографии",
		"PAGER_SHOW_ALWAYS" => "Y",
		"PAGER_TEMPLATE" => "",
		"PAGER_DESC_NUMBERING" => "Y",
		"PAGER_DESC_NUMBERING_CACHE_TIME" => "36000",
		"PAGER_SHOW_ALL" => "Y",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N"
	)
);?>