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

Альбом (список)


Описание conf.photogallery.section.lis

Одностраничный компонент выводит список альбомов. Компонент доступен при использовании решения Сайт конференции и содержит следующие шаблоны: .default, .big, media_classic, media_dark, media_modern. Компонент стандартный и входит в дистрибутив модуля.

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



Параметры

Поле Параметр Описание
Основные параметры
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационного блока.
Инфоблок IBLOCK_ID Для выбранного типа инфоблока указывается идентификатор информационного блока, в котором хранятся фотографии.
Этап конференции PARENT_SECTION Выбирается этап конференции.
ID раздела SECTION_ID Указывается числовой код, в котором передается идентификатор раздела. Поле может быть оставлено пустым, если указан Код раздела.
Код раздела SECTION_CODE Указывается символьный код раздела, из которого будут выбраны фотографии. Поле может быть оставлено пустым, если указан ID раздела.
Режим работы галереи BEHAVIOUR Указывается режим работы фотогалереи:
  • SIMPLE - простой, т.е. один пользователь;
  • USER - многопользовательский.
Если параметр принимает значение USER (многопользовательский), то необходимо настроить параметры USER_ALIAS, GALLERY_URL и GALLERY_SIZE.
Выводить список нескольких фотографий альбома вместо отображения обложки PHOTO_LIST_MODE [Y|N] При отмеченной опции вместо обложки будет выводиться список нескольких фотографий альбома.
Количество выводимых фотографий в списке альбомов SHOWN_ITEMS_COUNT Задается количество фотографий, которое будет показано на странице списка альбомов.
Первое поле сортировки фото 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).
По какому полю сортируем разделы SORT_BY Указывается поле, по которому будет происходить сортировка альбомов:
  • ID – по идентификатору;
  • NAME – по названию;
  • SORT – по индексу сортировки;
  • ELEMENTS_CNT – по количеству элементов в альбоме;
  • UF_DATE – по дате.
Порядок сортировки разделов SORT_ORD Задается порядок сортировки фотографий в разделе:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Количество элементов на странице PAGE_ELEMENTS Указывается количество альбомов, выводимых на одной странице. Весь список альбомов будет выведен с помощью постраничной навигации.
Шаблоны ссылок
Главная страница INDEX_URL Указывается адрес страницы со списком разделов (альбомов).
URL страницы с содержимым раздела SECTION_URL Указывается адрес страницы с содержимым раздела (альбома).
Альбом (редактирование) SECTION_EDIT_URL Указывается адрес страницы редактирования параметров альбома.
Альбом (редактирование обложки) SECTION_EDIT_ICON_URL Указывается адрес страницы выбора обложки альбома.
Страница загрузки фото UPLOAD_URL Указывается адрес страницы загрузки фотографий.
Дополнительные настройки
Размер альбома (px) ALBUM_PHOTO_SIZE Указывается размер картинки обложки фотоальбома в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Размер картинки-анонса альбома (px) ALBUM_PHOTO_THUMBS_SIZE Указывается размер картинки-анонса фотоальбома в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Шаблон для постраничной навигации PAGE_NAVIGATION_TEMPLATE Указываются название шаблона для постраничной навигации.
Формат вывода даты DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Устанавливать статус 404, если не найдены элемент или раздел SET_STATUS_404 [Y|N] Если система не находит в каталоге элемент или раздел, то при отмеченной опции вместо HTTP статуса 200 будет сообщаться HTTP статус 404.
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Альбомы.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.


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

<$APPLICATION->IncludeComponent(
"bitrix:conf.photogallery.section.list",
	"",
	Array(
		"IBLOCK_TYPE" => "s1_conference",
		"IBLOCK_ID" => "8",
		"PARENT_SECTION" => "0",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"SECTION_CODE" => "",
		"BEHAVIOUR" => "SIMPLE",
		"PHOTO_LIST_MODE" => "Y",
		"SHOWN_ITEMS_COUNT" => "6",
		"ELEMENT_SORT_FIELD" => "SORT",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD1" => "TIMESTAMP_X",
		"ELEMENT_SORT_ORDER1" => "asc",
		"SORT_BY" => "UF_DATE",
		"SORT_ORD" => "ASC",
		"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#",
		"UPLOAD_URL" => "upload.php?SECTION_ID=#SECTION_ID#",
		"ALBUM_PHOTO_SIZE" => "200",
		"ALBUM_PHOTO_THUMBS_SIZE" => "120",
		"PAGE_ELEMENTS" => "0",
		"PAGE_NAVIGATION_TEMPLATE" => "",
		"DATE_TIME_FORMAT" => "d.m.Y",
		"SET_STATUS_404" => "Y",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600"
	)
);?>


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

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

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

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

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