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

Фото


Описание photogallery.detail

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

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

Компонент относится к модулю Фотогалерея.



Параметры

Поле Параметр Описание
Основные параметры
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
ID раздела SECTION_ID Указывается числовой код, в котором передается идентификатор раздела (альбома).
ID элемента ELEMENT_ID Указывается числовой код, в котором передается идентификатор элемента (фотографии).
Режим работы фотогалереи BEHAVIOUR Указывается режим работы фотогалереи:
  • SIMPLE - простой режим, т.е. один пользователь;
  • USER - многопользовательский режим.
Если параметр принимает значение USER, то необходимо настроить параметр USER_ALIAS
Код галереи USER_ALIAS Указывается имя переменной, в которой передается код галереи.
и GALLERY_URL. Данный параметр заполняется в поле Шаблоны ссылок.
Содержимое галереи GALLERY_URL Указывается адрес страницы просмотра содержимого галереи пользователя.
Первое поле сортировки фото ELEMENT_SORT_FIELD Указывается первое поле, по которому будут сортироваться фотографии:
  • SHOW_COUNTER – по количеству просмотров в среднем;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате последнего изменения;
  • NAME – по названию;
  • ID – по идентификатору;
  • PROPERTY_RATING – по популярности;
  • PROPERTY_FORUM_MESSAGE_CNT – по количеству комментариев на форуме;
  • PROPERTY_BLOG_COMMENTS_CNT – по количеству комментариев в блоге.
Порядок сортировки фото ELEMENT_SORT_ORDER Задается первый порядок сортировки фотографий в разделе:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Второе поле сортировки фото ELEMENT_SORT_FIELD1 Указывается второе поле, по которому будут сортироваться фотографии:
  • SHOW_COUNTER – по количеству просмотров в среднем;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате последнего изменения;
  • NAME – по названию;
  • ID – по идентификатору;
  • PROPERTY_RATING – по популярности;
  • PROPERTY_FORUM_MESSAGE_CNT – по количеству комментариев на форуме;
  • PROPERTY_BLOG_COMMENTS_CNT – по количеству комментариев в блоге.
Порядок сортировки фото ELEMENT_SORT_ORDER1 Задается второй порядок сортировки фотографий в разделе:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Свойства PROPERTY_CODE Указываются свойства фотографий, которые должны быть отображены.
Шаблоны ссылок
Содержимое галереи GALLERY_URL Указывается адрес страницы просмотра содержимого галереи пользователя (параметр указывается при многопользовательском режиме работы).
Фото DETAIL_URL Указывается адрес страницы детального просмотра фотографии.
Фото (редактирование) DETAIL_EDIT_URL Указывается адрес страницы редактирования параметров фотографии.
Страница слайд-шоу DETAIL_SLIDE_SHOW_URL Указывается адрес страницы слайд-шоу содержимого галереи.
Страница поиска SEARCH_URL Указывается адрес страницы поиска.
Альбом SECTION_URL Указывается адрес страницы просмотра альбома.
Загрузка фото UPLOAD_URL Указывается адрес страницы загрузки фотографии.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено <название_альбома>.
Использовать дополнительное ограничение доступа USE_PERMISSIONS [Y|N] При отмеченной опции будет ограничен доступ к детальной информации элементов инфоблока. Группы пользователей, имеющие доступ к детальной информации, указываются в парметре GROUP_PERMISSIONS.
Группы пользователей, имеющие доступ к детальной информации GROUP_PERMISSIONS Указываются группы пользователей, имеющие доступ к детальной информации.
Формат вывода даты DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Показывать теги SHOW_TAGS [Y|N] При отмеченной опции будет показано облако тегов.
Устанавливать статус 404, если не найдены элемент или раздел SET_STATUS_404 [Y|N] При отмеченной опции будет установлен статус 404, если не будут найдены элементы или раздел фотогалереи.
Размер детальной фотографии (px) THUMBS_SIZE Указывается размер детальной фотографии в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.


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

<?$APPLICATION->IncludeComponent("bitrix:photogallery.detail","",Array(
		"THUMBS_SIZE" => "300",
		"IBLOCK_TYPE" => "gallery",
		"IBLOCK_ID" => "10",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"ELEMENT_ID" => $_REQUEST["ELEMENT_ID"],
		"BEHAVIOUR" => "USER",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"USER_ALIAS" => $_REQUEST["USER_ALIAS"],
		"ELEMENT_SORT_FIELD" => "SORT",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD1" => "NAME",
		"ELEMENT_SORT_ORDER1" => "desc",
		"PROPERTY_CODE" => array(),
		"GALLERY_URL" => "gallery.php?USER_ALIAS=#USER_ALIAS#",
		"DETAIL_URL" => "detail.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
		"DETAIL_EDIT_URL" => "detail_edit.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
		"DETAIL_SLIDE_SHOW_URL" => "slide_show.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
		"SEARCH_URL" => "search.php",
		"SECTION_URL" => "section.php?SECTION_ID=#SECTION_ID#",
		"UPLOAD_URL" => "upload.php?SECTION_ID=#SECTION_ID#&ACTION=upload",
		"USE_PERMISSIONS" => "N",
		"GROUP_PERMISSIONS" => array(),
		"DATE_TIME_FORMAT" => "d.m.Y",
		"SHOW_TAGS" => "Y",
		"SET_STATUS_404" => "Y"
	)
);?>


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