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

Альбом


Описание photogallery.section

Компонент выводит информацию об одном альбоме:

  • обложку альбома;
  • ссылку на редактирование свойств альбома;
  • ссылку на страницу редактирования обложки альбома;
  • ссылку на удаление альбома;
  • ссылки на список альбомов, на добавление альбома, на загрузку фотографий.
Вместе с данным компонентом на странице обычно используется компонент Фото (список), который выводит список фотографий данного альбома. Компонент стандартный и входит в дистрибутив модуля.

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

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



Параметры

Поле Параметр Описание
Основные параметры
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
ID раздела SECTION_ID Указывается числовой код, в котором передается идентификатор раздела. Поле может быть оставлено пустым, если указан Код раздела.
Код раздела SECTION_CODE Указывается символьный код раздела, из которого будут выбраны фотографии. Поле может быть оставлено пустым, если указан ID раздела.
Код фотогалереи USER_ALIAS Задается переменная, в которой будет передаваться символьный код галереи.
Режим работы фотогалереи BEHAVIOUR Указывается режим работы фотогалереи:
  • пустое поле - простой режим, т.е. один пользователь;
  • USER - многопользовательский режим.
Если параметр принимает значение USER, то необходимо настроить параметр GALLERY_URL и GALLERY_SIZE.
Шаблоны ссылок
Список разделов SECTIONS_TOP_URL Указывается адрес страницы со списком разделов (альбомов).
URL страницы с содержимым раздела SECTION_URL Указывается адрес страницы с содержимым раздела (альбома).
Альбом (редактирование) SECTION_EDIT_URL Указывается адрес страницы редактирования параметров альбома. Страница может быть создана с помощью компонента Альбом (редактирование).
Альбом (редактирование обложки) SECTION_EDIT_ICON_URL Указывается адрес страницы выбора обложки альбома. Страница может быть создана с помощью компонента Альбом (редактирование обложки).
Страница слайд-шоу DETAIL_SLIDE_SHOW_URL Указывается адрес страницы просмотра слайд-шоу.
Загрузка фото UPLOAD_URL Указывается адрес страницы загрузки фотографий. Страница может быть создана с помощью компонента Фото (загрузка).
Содержимое галереи GALLERY_URL Указывается адрес страницы просмотра содержимого галереи.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Формат вывода даты DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Размер альбома (px) ALBUM_PHOTO_SIZE Указывается размер картинки обложки фотоальбома в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Размер картинки-анонса альбома (px) ALBUM_PHOTO_THUMBS_SIZE Указывается размер картинки-анонса фотоальбома в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Возвращать массив данных альбома RETURN_SECTION_INFO [Y|N] При отмеченной опции компонент будет возвращать массив данных альбома.
Устанавливать статус 404, если не найдены элемент или раздел SET_STATUS_404 [Y|N] При отмеченной опции будет установлен статус 404, если не будут найдены элементы или раздел фотогалереи.
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено <название_альбома>.
Размер фотогалереи GALLERY_SIZE Указывается размер галереи пользователя в Мб.


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

<?$APPLICATION->IncludeComponent("bitrix:photogallery.section","",Array(
		"IBLOCK_TYPE" => "gallery",
		"IBLOCK_ID" => "9",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"SECTION_CODE" => "",
		"USER_ALIAS" => "",
		"BEHAVIOUR" => "USER",
		"INDEX_URL" => "index.php",
		"SECTION_URL" => "section.php?SECTION_ID=#SECTION_ID#",
		"SECTION_EDIT_URL" => "section_edit.php?SECTION_ID=#SECTION_ID#",
		"SECTION_EDIT_ICON_URL" => "section_edit_icon.php?SECTION_ID=#SECTION_ID#",
		"DETAIL_SLIDE_SHOW_URL" => "slide_show.php?SECTION_ID=#SECTION_ID#&ELEMENT_ID=#ELEMENT_ID#",
		"UPLOAD_URL" => "upload.php?SECTION_ID=#SECTION_ID#",
		"DATE_TIME_FORMAT" => "d.m.Y",
		"ALBUM_PHOTO_SIZE" => "150",
		"ALBUM_PHOTO_THUMBS_SIZE" => "70",
		"RETURN_SECTION_INFO" => "Y",
		"SET_STATUS_404" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"SET_TITLE" => "Y"
	),
);?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх