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

Альбом


Описание 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-2021, «1С-Битрикс», 2021
Наверх