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

Фотография детально


Описание photo.detail

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

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

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



Параметры

Поле Параметр Описание
Основные параметры
Тип инфо-блока IBLOCK_TYPE Указывается один из созданных в системе типов информационного блока.
Инфо-блок IBLOCK_ID Для выбранного типа инфоблока указывается идентификатор информационного блока, фотографии из которого будут выводиться.
ID раздела SECTION_ID Указывается числовой код, в котором передается идентификатор раздела. Поле может быть оставлено пустым, если указан Код раздела.
ID элемента ELEMENT_ID Указывается числовой код, в котором передается идентификатор элемента. Поле может быть оставлено пустым, если указан Код элемента.
Код раздела SECTION_CODE Указывается символьный код раздела, из которого будут выбраны фотографии. Поле может быть оставлено пустым, если указан ID раздела.
Код элемента ELEMENT_CODE Указывается символьный код элемента, из которого будут выбраны фотографии. Поле может быть оставлено пустым, если указан ID элемента.
Источник данных
По какому полю отсортировать фотографии для ссылок "след." и "пред." ELEMENT_SORT_FIELD Указывается поле, по которому будут отсортированы фотографии для ссылок "следующая" и "предыдущая":
  • SHOWS – по количеству просмотров в среднем;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате последнего изменения;
  • NAME – по названию;
  • ID – по идентификатору;
  • ACTIVE_FROM – по дате активности с;
  • ACTIVE_TO – по дате активности по.
В каком порядке отсортировать фотографии для ссылок "след." и "пред." ELEMENT_SORT_ORDER Задается порядок сортировки фотографий для ссылок "следующая" и "предыдущая":
  • ASCПо возрастанию;
  • DESCПо убыванию.
Поля FIELD_CODE Указываются поля, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),
При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив), на странице списка будут выведены поля по умолчанию.
Свойства PROPERTY_CODE Указываются свойства, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, на странице детального просмотра свойства не будут выведены.
Шаблоны ссылок
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_GROUPS [Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Дополнительные настройки
Установить ключевые слова страницы из свойства META_KEYWORDS Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержатся ключевые слова.
Установить описание страницы из свойства META_DESCRIPTION Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится описание.
Установить заголовок окна браузера из свойства BROWSER_TITLE Среди всех свойств, определенных для данного инфоблока, выбирается то, в котором содержится заголовок окна браузера.
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено название фотографии.
Устанавливать в заголовках ответа время модификации страницыSET_LAST_MODIFIED[Y|N] При отмеченной опции http-ответ сервера будет содержать время последнего изменения страницы (заголовок Last-Modified).
Настройки 404 ошибки
Устанавливать статус 404SET_STATUS_404[Y|N] Опция служит для включения обработки ошибки 404 в компоненте.
Показ специальной страницыSHOW_404[Y|N] При отмеченной опции будет показана специальная страница Станет активным поле:
Страница для показа (по умолчанию /404.php)FILE_404Задается адрес страницы, которая будет отображаться при возникновении ошибки 404.
в случае возникновения ошибки 404, в противном случае - будет отображено специальное сообщение. Станет активным поле:
Сообщение для показа (по умолчанию из компонента)MESSAGE_404Задается сообщение, которое будет показано в случае возникновения ошибки 404. Если ничего не указывать, то будет использоваться стандартное сообщение из компонента.


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

<?$APPLICATION->IncludeComponent("bitrix:photo.detail","",Array(
		"AJAX_MODE" => "N",
		"IBLOCK_TYPE" => "photos",
		"IBLOCK_ID" => "22",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"ELEMENT_ID" => $_REQUEST["ELEMENT_ID"],
		"SECTION_CODE" => "",
		"ELEMENT_CODE" => "",
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"FIELD_CODE" => Array(),
		"PROPERTY_CODE" => Array(),
		"SECTION_URL" => "",
		"DETAIL_URL" => "",
		"META_KEYWORDS" => "-",
		"META_DESCRIPTION" => "-",
		"BROWSER_TITLE" => "-",
		"SET_TITLE" => "Y",
		"SET_STATUS_404" => "Y",
		"SHOW_404" => "Y",
		"MESSAGE_404" => "",
		"SET_LAST_MODIFIED" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_GROUPS" => "Y",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N"
	),
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024