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

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

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

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

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

Пример вызова компонента photogallery.detail.list.ex

Секции настроек компонента:

  • Основные параметры
  • Шаблоны ссылок
  • Настройки отзывов
  • Настройки кеширования
  • Дополнительные настройки
  • Описание параметров

    Поле Параметр Описание
    Основные параметры
    Тип инфоблока 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 - Нравится / Не нравится (графический).


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

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

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

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

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