Документация для разработчиков
Документация для разработчиков Документация по D7 Документация по REST Пользовательская документация
Темная тема

Фото


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