Фото (список)

Описание photogallery.detail.list

Компонент выводит список фотографий. Компонент содержит шесть шаблонов: .default, simple, slider, slider_big, slider_fixed и slide_show. Компонент стандартный и входит в дистрибутив модуля.

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

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

Примечание: Компонент устарел и не рекомендуется к использованию. Используйте компонент Список фото (со слайдером).

Параметры

Поле

Параметр

Описание

Основные параметры

Тип инфоблока

IBLOCK_TYPE

Указывается один из созданных в системе типов информационных блоков.

Инфоблок

IBLOCK_ID

Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.

Режим работы галереи

BEHAVIOUR

Указывается режим работы фотогалереи:

SIMPLE - обычный режим, т.е. один пользователь;
USER - многопользовательский режим.

Если параметр принимает значение USER, то необходимо настроить параметры USER_ALIAS

Код галереи

USER_ALIAS

Указывается имя переменной, в которой передается код галереи. Например ={$_REQUEST["USER_ALIAS"]}.

, GALLERY_SIZE Данный параметр заполняется в пункте Дополнительные настройки.

Размер галереи

GALLERY_SIZE

Задается размер галереи одного пользователя в Мб.

и GALLERY_URL. Данный параметр заполняется в пункте Шаблоны ссылок.

Содержимое галереи

GALLERY_URL

Указывается адрес страницы просмотра содержимого галереи пользователя.

ID раздела

SECTION_ID

В поле указывается код, в котором передается идентификатор раздела (альбома).

Дополнительные параметры выбора фото

ELEMENT_LAST_TYPE

Указываются дополнительные параметры выбора фото:

none - нет;
count - выбирать несколько последних фото (ID);
time - выбирать фото за последние несколько дней;
period - выбирать фото за период.

Если параметр принимает значение выбирать несколько последних фото (ID), то необходимо настроить параметр ELEMENTS_LAST_COUNT

Количество последних фото для выбора

ELEMENTS_LAST_COUNT

Указывается количество последних фото для выбора.

.

Если параметр принимает значение выбирать фото за последние несколько дней, то необходимо настроить параметр ELEMENTS_LAST_TIME.

Количество дней для выбора фото

ELEMENTS_LAST_TIME

Указывается количество дней для выбора фото.

Если параметр принимает значение выбирать фото за период, то необходимо настроить параметры

Начало периода (ввести дату в формате "DD.MM.YYYY HH:MI:SS")	ELEMENTS_LAST_TIME_FROM	Указывается дата начала периода для выбора фото в формате DD.MM.YYYY HH:MI:SS.
Конец периода (ввести дату в формате "DD.MM.YYYY HH:MI:SS")	ELEMENTS_LAST_TIME_TO	Указывается дата окончания периода для выбора фото в формате DD.MM.YYYY HH:MI:SS.

ELEMENTS_LAST_TIME_FROM и ELEMENTS_LAST_TIME_TO.

Первое поле сортировки фото

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

Выберите свойства фотографий, которые должны быть отображены.

Использовать обратную навигацию

USE_DESC_PAGE

[Y|N] При отмеченной опции будет использоваться обратная постраничная навигацию для списка фотографий.

Количество фото на странице

PAGE_ELEMENTS

Указывается количество фотографий, выводимых на одной странице. Остальные фотографий будут выведены с помощью постраничной навигации.

Название шаблона для постраничной навигации

PAGE_NAVIGATION_TEMPLATE

Указывается название шаблона для постраничной навигации.

Шаблоны ссылок

Содержимое галереи

GALLERY_URL

Указывается адрес страницы просмотра содержимого галереи пользователя (параметр указывается при многопользовательском режиме работы).

Страница детального просмотра

DETAIL_URL

Указывается адрес страницы детального просмотра альбома.

Страница слайд-шоу

DETAIL_SLIDE_SHOW_URL

Указывается адрес страницы слайд-шоу.

Страница поиска

SEARCH_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.

Устанавливать статус 404, если не найдены элемент или раздел

SET_STATUS_404

[Y|N] При отмеченной опции будет установлен статус 404, если не будут найдены элементы или раздел фотогалереи.

Размер галереи

GALLERY_SIZE

Задается размер галереи одного пользователя в Мб (параметр указывается при многопользовательском режиме работы).

Дополнительные эскизы

ADDITIONAL_SIGHTS

Выбираются типы эскизов для просмотра фотографий.

Активный эскиз (один из множества дополнительных и основных эскизов)

PICTURES_SIGHT

Указывается тип эскиза, с которого начинается просмотр фотографий альбома.

Размер детальной фотографии (px)

THUMBS_SIZE

Указывается размер детальной фотографии в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Данное поле доступно только для шаблона default и simple.

Показывать навигацию

SHOW_PAGE_NAVIGATION

Задается способ показа навигации:

none - не показывать;
top - сверху;
bottom - снизу;
both - сверху и снизу.

Данное поле доступно только для шаблонов default, simple, slider и slider_fixed.

Показывать элементы управления

SHOW_CONTROLS

[Y|N] При отмеченной опции на странице будут отображены кнопки по управлению фотографиями.
Данное поле доступно только для шаблона default.

Показывать голосования

SHOW_RATING

[Y|N] При отмеченной опции будут показаны голосования.
Данное поле доступно только для шаблона default и simple.

Показывать количество показов

SHOW_SHOWS

[Y|N] При отмеченной опции будет отображено количество показов.
Данное поле доступно только для шаблона default и simple.

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

SHOW_COMMENTS

[Y|N] При отмеченной опции будет отображено количество комментариев.
Данное поле доступно только для шаблона default и simple.

Максимальный балл

MAX_VOTE

Указывается максимально возможный балл, т.е. число возможных оценок.
Данное поле доступно только для шаблона default и simple.

Подписи к баллам

VOTE_NAMES

Указываются подписи к каждому баллу. В коде вводится массив, в котором задаются подписи к баллам в таком виде:

"VOTE_NAMES" => Array("0","1","2","3","4","5"),

Если подписи заданы, то они будут выведены вместо оценок-цифр. Если массив не задан, то будут использованы значения по умолчанию.
Данное поле доступно только для шаблонов default и simple.

В качестве рейтинга показывать

DISPLAY_AS_RATING

Указывается одно из значений, которое должно быть показано в качестве рейтинга:

Рейтинг (rating) - высчитывается на основе формулы:
Rating = (SUM(vote)+3.125*10) / (COUNT(*)+10), где:

3.125 - это стартовый рейтинг. То есть изначально (при отсутствии голосов) рейтинг фотографии равен 3.125.

10 - это константа, определяющая количество голосов, "утяжеляющих" первоначальное значение рейтинга (3.125). Это исключает случай, когда, например, трое проголосовавших человека могут вознести или опустить фотографию всего тремя голосами.

При такой формуле расчета значение рейтинга получается более "плавное" и не так скачет при небольшом количестве голосующих. Чем больше голосов, тем больше рейтинг приближается к среднему арифметическому.
Среднее значение (vote_avg) - высчитывается как среднее арифметическое всех баллов к фотографии;
Рейтинг (главного модуля) (rating_main) - использование рейтинга главного модуля.
Подробнее:
- см. главу Рейтинги;
- в блоге Рейтинги: создание собственного критерия рейтингования;
- в блоге Саморегулируемое сообщество, построенное на двухфакторном рейтинге.

Данное поле доступно только для шаблона default и simple.

Размер аватара галереи (используется при работе компонента в многопользовательском режиме, px)

GALLERY_AVATAR_SIZE

Указывается размер аватара галереи в пикселях (px)
Данное поле доступно только для шаблона simple.

Размер слайдера (количество фотографий)

SLIDER_COUNT_CELL

Указывается количество фотографий, отображаемых в слайдере.
Данное поле доступно только для шаблонов slider и slider_fixed.

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

<?$APPLICATION->IncludeComponent("bitrix:photogallery.detail.list","",Array(
		"THUMBS_SIZE" => "120",
		"SHOW_PAGE_NAVIGATION" => "bottom",
		"SHOW_CONTROLS" => "Y",
		"SHOW_RATING" => "Y",
		"SHOW_SHOWS" => "Y",
		"SHOW_COMMENTS" => "Y",
		"MAX_VOTE" => "5",
		"VOTE_NAMES" => array("1", "2", "3", "4", "5"),
		"DISPLAY_AS_RATING" => "rating",
		"IBLOCK_TYPE" => "gallery",
		"IBLOCK_ID" => "10",
		"BEHAVIOUR" => "USER",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"USER_ALIAS" => $_REQUEST["USER_ALIAS"],
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"ELEMENT_LAST_TYPE" => "count",
		"ELEMENTS_LAST_COUNT" => "30",
		"ELEMENT_SORT_FIELD" => "NAME",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD1" => "PROPERTY_RATING",
		"ELEMENT_SORT_ORDER1" => "desc",
		"PROPERTY_CODE" => array("vote_count", "rating", "vote_sum", "APPROVE_ELEMENT", "PUBLIC_ELEMENT"),
		"DETAIL_URL" => "detail.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",
		"USE_PERMISSIONS" => "Y",
		"GROUP_PERMISSIONS" => array("1"),
		"USE_DESC_PAGE" => "Y",
		"PAGE_ELEMENTS" => "50",
		"PAGE_NAVIGATION_TEMPLATE" => "",
		"DATE_TIME_FORMAT" => "d.m.Y",
		"SET_STATUS_404" => "Y",
		"ADDITIONAL_SIGHTS" => array(),
		"PICTURES_SIGHT" => array()
	),
);?>

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх