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

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


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

Компонент выводит список фотографий. Компонент доступен при использовании решения Сайт конференции и содержит следующие шаблоны: .default, simple, slider, slider_big, slider_fixed, slide_show, table_clear, table_clear_classic, table_clear_dark, table_clear_modern. Компонент стандартный и входит в дистрибутив модуля.

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



Параметры

Поле Параметр Описание
Дополнительно
Размер детальной фотографии (px) THUMBS_SIZE Указывается размер детальной фотографии в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения.
Данное поле доступно только для шаблонов default, table_clear, table_clear_classic, table_clear_dark, table_clear_modern и simple.
Показывать навигацию SHOW_PAGE_NAVIGATION Задается способ показа навигации:
  • none - не показывать;
  • top - сверху;
  • bottom - снизу;
  • both - сверху и снизу.

Данное поле доступно только для шаблонов default, simple, slider, slider_fixed, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Показывать элементы управления SHOW_CONTROLS [Y|N] При отмеченной опции на странице будут отображены кнопки по управлению фотографиями.
Данное поле доступно только для шаблонов default, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Показывать голосования SHOW_RATING [Y|N] При отмеченной опции будут показаны голосования.
Данное поле доступно только для шаблонов default, simple, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Показывать количество показов SHOW_SHOWS [Y|N] При отмеченной опции будет отображено количество показов.
Данное поле доступно только для шаблона default, simple, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Показывать количество комментариев SHOW_COMMENTS [Y|N] При отмеченной опции будет отображено количество комментариев.
Данное поле доступно только для шаблона default, simple, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Размер аватара галереи (используется при работе компонента в многопользовательском режиме, px) GALLERY_AVATAR_SIZE Указывается размер аватара галереи в пикселях (px)
Данное поле доступно только для шаблона simple.
Показывать тегиSHOW_TAGS [Y|N] При отмеченной опции будут показаны теги.
Данное поле доступно только для шаблона table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Максимальный балл MAX_VOTE Указывается максимально возможный балл, т.е. число возможных оценок.
Данное поле доступно только для шаблона default, simple, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
Подписи к баллам VOTE_NAMES Указываются подписи к каждому баллу. В коде вводится массив, в котором задаются подписи к баллам в таком виде:
"VOTE_NAMES" => Array("0","1","2","3","4","5"),
Если подписи заданы, то они будут выведены вместо оценок-цифр. Если массив не задан, то будут использованы значения по умолчанию.
Данное поле доступно только для шаблонов default, simple, table_clear, table_clear_classic, table_clear_dark, table_clear_modern.
В качестве рейтинга показывать 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.
Вид кнопок рейтинга (главного модуля) RATING_MAIN_TYPE Указывается одно из значений, которое должно быть показано, если выбран Рейтинг (главного модуля) (rating_main):
  • по умолчанию;
  • like - Мне нравится (текстовый);
  • like_graphic - Мне нравится (графический);
  • standart_text - Нравится / Не нравится (текстовый);
  • standart - Нравится / Не нравится (графический).

Данное поле доступно только для шаблонов .default, simple.
ID активного элемента ELEMENT_ID Указывается идентификатор активного элемента.
Данное поле доступно только для шаблонов slider, slider_fixed и slide_show.
Размер слайдера (количество фотографий) SLIDER_COUNT_CELL Указывается количество фотографий, отображаемых в слайдере.
Данное поле доступно только для шаблонов slider и slider_fixed.
Дополнительные эскизы ADDITIONAL_SIGHTS Выбираются типы для эскизов, в которых фотографии будут доступны для просмотра.
Активный эскиз (один из множества дополнительных и основных эскизов) PICTURES_SIGHT Указывается тип эскиза, с которого начинается просмотр фотографий альбома.
Основные параметры
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
Режим работы галереи BEHAVIOUR Указывается режим работы фотогалереи:
  • SIMPLE - обычный режим, т.е. один пользователь;
  • USER - многопользовательский режим.
Если параметр принимает значение USER, то необходимо настроить параметры USER_ALIAS, GALLERY_SIZE и GALLERY_URL.
Код галереи USER_ALIAS Указывается имя переменной, в которой передается код галереи. Например ={$_REQUEST["USER_ALIAS"]}.
ID раздела SECTION_ID В поле указывается код, в котором передается идентификатор раздела (альбома).
Дополнительные параметры выбора фото ELEMENT_LAST_TYPE Указываются дополнительные параметры выбора фото:
  • none - нет;
  • count - выбирать несколько последних фото (ID);
  • time - выбирать фото за последние несколько дней;
  • period - выбирать фото за период.
Если параметр принмает значение count, то необходимо настроить параметр ELEMENTS_LAST_COUNT.

Если параметр принмает значение time, то необходимо настроить параметр ELEMENTS_LAST_TIME.

Если параметр принмает значение period, то необходимо настроить параметры ELEMENTS_LAST_TIME_FROM и ELEMENTS_LAST_TIME_TO.
Количество последних фото для выбора ELEMENTS_LAST_COUNT Указывается количество последних фото для выбора.
Количество дней для выбора фото 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.
Первое поле сортировки фото 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 Указывается название шаблона для постраничной навигации.
Дополнительные настройки
Устанавливать заголовок страницы 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 Задается размер галереи одного пользователя в Мб.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Шаблоны ссылок
Содержимое галереи GALLERY_URL Указывается адрес страницы просмотра содержимого галереи пользователя.
Страница детального просмотра DETAIL_URL Указывается адрес страницы детального просмотра альбома.
Страница слайд-шоу DETAIL_SLIDE_SHOW_URL Указывается адрес страницы слайд-шоу.
Страница поиска SEARCH_URL Указывается адрес страницы поиска.


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

<?$APPLICATION->IncludeComponent(
"bitrix:conf.photogallery.detail.list",
	"",
	Array(
		"THUMBNAIL_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" => "s1_conference",
		"IBLOCK_ID" => "8",
		"BEHAVIOUR" => "SIMPLE",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"SECTION_ID" => $_REQUEST["SECTION_ID"],
		"ELEMENT_LAST_TYPE" => "none",
		"ELEMENT_SORT_FIELD" => "SORT",
		"ELEMENT_SORT_ORDER" => "asc",
		"ELEMENT_SORT_FIELD1" => "SHOW_COUNTER",
		"ELEMENT_SORT_ORDER1" => "asc",
		"PROPERTY_CODE" => array("PUBLIC_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("3"),
		"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"
	)
);?> 


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

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

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

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

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