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

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


Описание 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
Наверх