Список фото (со слайдером)

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

Компонент выводит список фотографий в всплывающем окне со слайдером и комментариями. Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент находится в Компоненты > Контент > Фотогалерея 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

Указывается адрес страницы поиска.

Путь к профилю пользователя

PATH_TO_USER

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

Настройки отзывов

Разрешить отзывы

USE_COMMENTS

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

Компонент комментариев	COMMENTS_TYPE	Указывается компонент, с помощью которого будут добавляться комментарии: Блоги (blog); Форум (forum). Если указать Блоги, то необходимо настроить следущие параметры: BLOG_URL, PATH_TO_BLOG. Если указать Форум, то необходимо настроить следущие параметры: FORUM_ID, URL_TEMPLATES_READ, URL_TEMPLATES_PROFILE_VIEW, USE_CAPTCHA, SHOW_LINK_TO_FORUM, PREORDER.
Количество комментариев на странице	COMMENTS_COUNT	Указывается количество комментариев на странице.
Путь относительно корня сайта к папке со смайлами	PATH_TO_SMILE	Указывается путь к папке со смайликами относительно корня сайта.
Блог для комментариев	BLOG_URL	Указывается один из созданных в системе блогов, который будет использован для комментариев.
Путь к блогу	PATH_TO_BLOG	Указывается путь к месту расположения блога.
ID форума для отзывов	FORUM_ID	Указывается один из созданных в системе форумов, который будет использован для комментариев.
Страница чтения темы	URL_TEMPLATES_READ	Указывается адрес страницы чтения темы форума.
Страница пользователя	URL_TEMPLATES_PROFILE_VIEW	Указывается адрес страницы профиля пользователя относительно корня сайта.
Использовать CAPTCHA	USE_CAPTCHA	[Y\|N] При отмеченной опции будет выводиться изображение и поле ввода CAPTCHA в форме добавления комментария в публичной части.
Выводить сообщения в прямом порядке	PREORDER	[Y\|N] При отмеченной опции собщения будут отсортированы по дате создания по возрастанию.
Начинать тему текстом элемента	POST_FIRST_MESSAGE	[Y\|N] При отмеченной опции в обсуждении на форуме будет выведено первое сообщение отзыва.

Настройки кеширования

Тип кеширования

CACHE_TYPE

Тип кеширования:

A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
Y - Кешировать: для кеширования необходимо определить время кеширования;
N - Не кешировать: кеширования нет в любом случае.

Время кеширования (сек.)

CACHE_TIME

Время кеширования, указанное в секундах.

Дополнительные настройки

Устанавливать заголовок страницы

SET_TITLE

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

Отображение имени

NAME_TEMPLATE

Указывается шаблон для отображения ФИО пользователя социальной сети. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.

Использовать дополнительное ограничение доступа

USE_PERMISSIONS

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

Группы пользователей, имеющие доступ к детальной информации

GROUP_PERMISSIONS

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

Формат вывода даты

DATE_TIME_FORMAT

Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.

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

SET_STATUS_404

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

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

ADDITIONAL_SIGHTS

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

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

PICTURES_SIGHT

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

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

GALLERY_SIZE

Показывать логин, если не задано имя

SHOW_LOGIN

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

Размер фотографии-анонса (px)

THUMBNAIL_SIZE

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

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

SHOW_PAGE_NAVIGATION

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

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

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

SHOW_RATING

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

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

SHOW_SHOWS

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

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

SHOW_COMMENTS

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

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

MAX_VOTE

Указывается максимально возможный балл, т.е. число возможных оценок.

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

VOTE_NAMES

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

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

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

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

DISPLAY_AS_RATING

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

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

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

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

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

Вид кнопок рейтинга (главного модуля)

RATING_MAIN_TYPE

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

по умолчанию;
like - Мне нравится (текстовый);
like_graphic - Мне нравится (графический);
standart_text - Нравится / Не нравится (текстовый);
standart - Нравится / Не нравится (графический).

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

<?$APPLICATION->IncludeComponent("bitrix:photogallery.detail.list.ex","",Array(
		"THUMBNAIL_SIZE" => "120",
		"SHOW_PAGE_NAVIGATION" => "none",
		"SHOW_RATING" => "Y",
		"SHOW_SHOWS" => "Y",
		"SHOW_COMMENTS" => "Y",
		"MAX_VOTE" => "5",
		"VOTE_NAMES" => array("1","2","3","4","5"),
		"DISPLAY_AS_RATING" => "rating",
		"RATING_MAIN_TYPE" => "",
		"IBLOCK_TYPE" => "gallery",
		"IBLOCK_ID" => "10",
		"BEHAVIOUR" => "USER",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_NOTES" => "",
		"USER_ALIAS" => $_REQUEST["USER_ALIAS"],
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"ELEMENT_LAST_TYPE" => "period",
		"ELEMENTS_LAST_TIME_FROM" => "",
		"ELEMENTS_LAST_TIME_TO" => "",
		"ELEMENT_SORT_FIELD" => "SORT",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD1" => "SHOW_COUNTER",
		"ELEMENT_SORT_ORDER1" => "asc",
		"PROPERTY_CODE" => array(),
		"GALLERY_URL" => "gallery.php?USER_ALIAS=#USER_ALIAS#",
		"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(),
		"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" => "real",
		"GALLERY_SIZE" => "",
		"PATH_TO_USER" => "/company/personal/user/#USER_ID#",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"SHOW_LOGIN" => "Y"
	),
false
);?>

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

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

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

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

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

Наверх