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

Фотогалерея 2.0 (многопользовательская) (комплексный компонент)

Комплексный компонент Фотогалерея 2.0 (многопользовательская) позволяет получить полнофункциональную многопользовательскую фотогалерею, создавая физически только одну страницу. Параметры компонента позволяют произвести следующие настройки внешнего вида фотогалереи:

  • отображение облака тегов;
  • размеры картинок анонса (эскизов), детального просмотра фотографии, а также размеры картинки-анонса и картинки фотоальбома;
  • настройки голосования и отзывов;
  • и другие.

Внимание! Компонент поддерживает два режима настройки: простой и расширенный. Расширенный предоставляет более обширные средства настройки.

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

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

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

Пример вызова компонента photogallery_user

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

Простой режим Расширенный режим
  • Настройки постраничной навигации
  • Основные параметры
  • Основные параметры
  • Настройки фотогалереи
  • Настройки фотогалереи
  • Управление адресами страниц
  • Управление адресами страниц
  • Настройки кеширования
  • Настройки кеширования
  • Дополнительные настройки
  • Дополнительные настройки
  • Настройки голосования
  • Настройки голосования
  • Настройки тегов
  • Настройки тегов
  • Загрузка фото
  • Загрузка фото
  • Настройки отзывов
  • Настройки отзывов

  • Описание параметров

    Простой режим:

    Поле Параметр Описание
    Основные параметры
    Использовать простой режим настройки USE_LIGHT_VIEW [Y|N] При отмеченной опции будет использоваться простой режим настройки фотогалереи (значения остальных параметров будут по умолчанию).
    Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
    Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
    Группы пользователей, которым разрешено создавать галерею GALLERY_GROUPS Указываются группы пользователей, которым разрешено создавать галерею.
    Включить премодерацию фото MODERATION [Y|N] При отмеченной опции будет использоваться механизм премодерации фото.
    Путь к профилю пользователя PATH_TO_USER Указывается шаблон пути к профилю пользователя.
    Отображать навигационную цепочку 'хлебные крошки' в рамках комплексного компонента SHOW_NAVIGATION [Y|N] При отмеченной опции на странице фотогалереи будет отображаться навигационная цепочка ('хлебные крошки')..
    Анализировать параметры соц.сети ANALIZE_SOCNET_PERMISSION [Y|N] При отмеченной опции будет производится проверка прав доступа пользователя к модулю Социальная сеть.
    Настройки фотогалереи
    Размер картинки галереи (px) GALLERY_AVATAR_SIZE Указывается размер аватара владельца галереи в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер картинки-анонса фотоальбома (px) ALBUM_PHOTO_THUMBS_SIZE Указывается размер картинки-анонса фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер фотографии-анонса (px) THUMBNAIL_SIZE Указывается размер картинки-анонса альбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер картинки в предпросмотре в списке альбомов (px) SECTION_LIST_THUMBS_SIZE Указывается размер картинки в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Обязательно ограничивать размер оригинала (px) (при значении 0 ограничение не происходит) ORIGINAL_SIZE Задается размер оригинала фотографии в пикселях. Фотография будет уменьшена до указанной величины. Если указано значение 0, то изменение размера не происходит. Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Управление адресами страниц
    Включить поддержку ЧПУ SEF_MODE [Y|N] При отмеченной опции будет включена поддержка ЧПУ.

    Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры: Настраиваемые параметры при включенном режиме поддержки ЧПУ:
    Каталог ЧПУ (относительно корня сайта) SEF_FOLDER Каталог ЧПУ: путь до папки, с которой работает компонент. Этот путь может как совпадать с физическим путём, так и не совпадать.
    Адреса страниц SEF_URL_TEMPLATES Указываются адреса следующих страниц:
    • index - страница со списком альбомов;
    • galleries - страница со списком галерей;
    • gallery - страница с содержимым галереи;
    • gallery_edit - страница редактирования параметров галереи;
    • section - страница просмотра альбомов;
    • section_edit - страница редактирования параметров альбома;
    • section_edit_icon - страница выбора обложки альбома;
    • upload - страница загрузки фотографий;
    • detail - страница просмотра фотографий;
    • detail_edit - страница редактирования параметров фотографии;
    • detail_slide_show - страница слайд-шоу;
    • detail_list - страница со списком фотографий;
    • search - страница поиска;
    • tags - страница тегов.
    SEF_FOLDER и SEF_URL_TEMPLATES.

    Если режим поддержки ЧПУ выключен, то необходимо настроить массив переменных Настраиваемые параметры при выключенном режиме поддержки ЧПУ:
    ID пользователя USER_ID Задается переменная, в которой будет передаваться идентификатор пользователя.
    Код галереи USER_ALIAS Задается переменная, в которой будет передаваться символьный код галереи.
    Идентификатор раздела SECTION_ID Задается переменная, в которой будет передаваться идентификатор раздела (альбома).
    Идентификатор элемента ELEMENT_ID Задается переменная, в которой будет передаваться идентификатор элемента (фотографии).
    Идентификатор страницы PAGE_NAME Задается переменная, в которой будет передаваться идентификатор страницы.
    Идентификатор действия ACTION Задается переменная, в которой будет передаваться идентификатор действия.
    VARIABLE_ALIASES, который включает в себя: USER_ID, USER_ALIAS, SECTION_ID, ELEMENT_ID, PAGE_NAME, ACTION.
    Настройки кеширования
    Тип кеширования CACHE_TYPE Тип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
    Дополнительные настройки
    Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Фотографии.
    [Главная страница] Количество фото на главной странице INDEX_PAGE_TOP_ELEMENTS_COUNT Указывается количество фотографий, выводимых на главной странице фотогалереи.
    [Главная страница] Показывать только опубликованные фото SHOW_ONLY_PUBLIC [Y|N] При отмеченной опции только на главной странице будут выводится только опубликованные фотографии.

    Если опция отмечена, то необходимо настроить следущие параметры: PUBLIC_BY_DEFAULT и MODERATE.
    Показывать секцию кнопок управления SHOW_CONTROLS_BUTTONS [Y|N] При отмеченной опции на Главной странице пользовательской галереи будут показываться кнопки управления (например Мои фото, Мои галереи, Загрузить фото). Параметр доступен только при использовании шаблона default.
    Настройки голосования
    Разрешить голосование USE_RATING [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 Указывается одно из значений, которое должно быть показано в качестве рейтинга:
    • по умолчанию;
    • Плюс / минус (standart);
    • Мне нравится (like).

    Параметр доступен только если выбран Рейтинг (главного модуля) (rating_main).
    Настройки тегов
    Показывать теги SHOW_TAGS [Y|N] При отмеченной опции будет показано облако тегов фотогалереи. Станут активными дополнительные поля
    Максимальный размер шрифта (px) TAGS_FONT_MAX Указывается максимальный размер шрифта отображения тегов (в пикселах).
    Минимальный размер шрифта (px) TAGS_FONT_MIN Указывается минимальный размер шрифта отображения тегов (в пикселах).
    Цвет более позднего тега (пример: "C0C0C0") TAGS_COLOR_NEW Указывается код цвета тегов, дата создания которых наиболее поздняя (пример: "C0C0C0").
    Цвет более раннего тега (пример: "FEFEFE") TAGS_COLOR_OLD Указывается код цвета тегов, дата создания которых наиболее ранняя (пример: "FEFEFE").
    Загрузка фото
    Тип загрузчика PHOTO_UPLOADER_TYPE Указывается тип загрузчика фотографий в фотогалерею:
    • Одиночная загрузка через форму (form);
    • Множественный загрузчик (Java/ActiveX) (applet);
    • Множественный Flash-загрузчик (flash).
    Параметр устарел с версии 15.0.0.
    Схема множественного загрузчикаAPPLET_LAYOUTПараметр определяет тип загрузчика в фотогалерии по умолчанию:
    • Стандартный шаблон (extended);
    • Упрощенный шаблон загрузчика (simple).
    Выбор параметра доступен только при выборе параметра "Тип загрузчика" (PHOTO_UPLOADER_TYPE) равным "Множественный загрузчик (Java/ActiveX)" (applet).

    Параметр устарел с версии 15.0.0.
    Максимальный размер загружаемого файла (не должен превышать 1024Mб) (Мб) UPLOAD_MAX_FILE_SIZE Указывается максимальный размер загружаемого файла в Мб (не должен превышать 1024Mб).
    Наносить авторский знак USE_WATERMARK [Y|N] При отмеченной опции при загрузке фотографий можно будет наносить авторский знак. Станут доступны поля настройки авторского знака. Поля настройки авторского знака:
    Правила нанесения авторского знака WATERMARK_RULES Указывается правило нанесения авторского знака:
    • На усмотрение пользователя (USER);
    • Обязательно наносить авторский знак (ALL).
    Если выбрано значение ALL, то необходимо настроить дополнительные параметры (приведены в таблице ниже).
    Файл со шрифтом для авторского знака PATH_TO_FONT Указывается файл со шрифтом для создания авторского знака (будет использоваться также и при множественной загрузке). Шрифты предварительно загружаются в директорию \bitrix\modules\photogallery\fonts\. Поддерживаются TTF-, OTF- и PS-шрифты.
    Минимальный размер фото для авторского знака (px) WATERMARK_MIN_PICTURE_SIZE Указывается минимальный размер фото, на которых будет нанесен авторский знак в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально. На фотографии меньшего размера знак добавлен не будет.

    Дополнительные параметры, заполняемые при выборе правила Обязательно наносить авторский знак
    (обратите внимание, что список параметров меняется в зависимости от типа авторского знака) :
    Тип авторского знака WATERMARK_TYPE Указывается тип авторского знака:
    • Надпись (текст) (TEXT);
    • Картинка (PICTURE).
    Если выбрано значение TEXT, то дополнительно необходимо настроить параметры: WATERMARK_TEXT, WATERMARK_COLOR и WATERMARK_SIZE.

    Если выбрано значение PICTURE, то дополнительно необходимо настроить параметры: WATERMARK_FILE и WATERMARK_FILE_ORDER.
    Текст надписи WATERMARK_TEXT Задается текст авторского знака.
    Цвет надписи (без #, например, FF00EE) WATERMARK_COLOR Указывается шестнадцатеричный код цвета надписи без использования #.
    Размер надписи (% от размера картинки) WATERMARK_SIZE Задается размер надписи авторского знака в процентном соотношении от размера фото.
    Размещение авторского знака WATERMARK_POSITION Указывается область размещения авторского знака на фото:
    • Сверху слева (tl);
    • Сверху по центру (tc);
    • Сверху справа (tr);
    • Cлева (ml);
    • По центру (mc);
    • Cправа (mr);
    • Снизу cлева (bl);
    • Снизу по центру (bc);
    • Снизу cправа (br).
    Физический полный путь к картинке WATERMARK_FILE Указывается полный путь к картинке для авторского знака относительно корня сайта.
    Расположение картинки на фото WATERMARK_FILE_ORDER Указывается тип расположения картинки авторского знака на фото:
    • Без изменений (usual);
    • Растянуть (resize);
    • Замостить (repeat).
    Прозрачность авторского знака WATERMARK_TRANSPARENCY Задается величина прозрачности авторского знака (в %).
    Настройки отзывов
    Разрешить отзывы USE_COMMENTS [Y|N] При отмеченной опции будет доступен функционал отзывов, станут активны дополнительные поля. Дополнительные поля:
    Компонент комментариев COMMENTS_TYPE Указывается компонент, с помощью которого будут добавляться комментарии:
    • Блоги (blog);
    • Форум (forum).
    Если указать Блоги, то необходимо настроить параметр BLOG_URL.

    Если указать Форум, то необходимо настроить параметр FORUM_ID.
    Блог для комментариев BLOG_URL Указывается блог, в котором будут храниться комментарии.
    ID форума для отзывов FORUM_ID Указывается один из созданных в системе форумов, который будет использован для комментариев.


    Расширенный режим:

    Поле Параметр Описание
    Настройки постраничной навигации
    Количество альбомов на странице SECTION_PAGE_ELEMENTS Указывается количество альбомов, отображаемых на одной странице. Остальные альбомы будут выведены с помощью постраничной навигации.
    Количество фото на странице ELEMENTS_PAGE_ELEMENTS Указывается количество фотографий, отображаемых на одной странице. Остальные фотографии будут выведены с помощью постраничной навигации.
    Шаблон для постраничной навигации PAGE_NAVIGATION_TEMPLATE Указываются название шаблона для постраничной навигации.
    Основные параметры
    Использовать простой режим настройки USE_LIGHT_VIEW [Y|N] При отмеченной опции будет использоваться простой режим настройки фотогалереи (значения остальных параметров будут по умолчанию).
    Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
    Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
    Группы пользователей, которым разрешено создавать галерею GALLERY_GROUPS Указываются группы пользователей, которым разрешено создавать галерею.
    Разрешать создавать пользователям только одну галерею (группы пользователей, имеющие доступ на запись к инфоблоку, могут создавать неограниченное количество галерей) ONLY_ONE_GALLERY [Y|N] При отмеченной опции пользователям будет разрешено создать только одну галерею. Группы пользователей, имеющие доступ на запись к инфоблоку, могут создавать неограниченное количество галерей.
    Включить премодерацию фото MODERATION [Y|N] При отмеченной опции будет использоваться механизм премодерации фото.
    По какому полю сортируем альбомы SECTION_SORT_BY Указывается поле, по которому будет происходить сортировка альбомов:
    • ID - по идентификатору;
    • NAME - по названию;
    • SORT - по индексу сортировки;
    • ELEMENTS_CNT - по количесву фото в альбоме;
    • UF_DATE - по дате.
    Порядок сортировки альбомов SECTION_SORT_ORD Задается порядок сортировки альбомов:
    • ASCпо возрастанию;
    • DESCпо убыванию.
    По какому полю сортируем фото ELEMENT_SORT_FIELD Указывается поле, по которому будет происходить сортировка фотографий:
    • SHOWS – по количеству просмотров в среднем;
    • SORT – по индексу сортировки;
    • TIMESTAMP_X – по дате последнего изменения;
    • NAME – по названию;
    • ID – по идентификатору;
    • RATING – по популярности;
    • COMMENTS – по комментариям.
    Порядок сортировки фото в альбомах ELEMENT_SORT_ORDER Задается порядок сортировки фотографий в альбомах:
    • ASCпо возрастанию;
    • DESCпо убыванию.
    Путь к профилю пользователя PATH_TO_USER Указывается шаблон пути к профилю пользователя.
    Отображать навигационную цепочку 'хлебные крошки' в рамках комплексного компонента SHOW_NAVIGATION [Y|N] При отмеченной опции на странице фотогалереи будет отображаться навигационная цепочка ('хлебные крошки')..
    Анализировать параметры соц.сети ANALIZE_SOCNET_PERMISSION [Y|N] При отмеченной опции будет производится проверка прав доступа пользователя к модулю Социальная сеть.
    Настройки фотогалереи
    Размер картинки галереи (px) GALLERY_AVATAR_SIZE Указывается размер аватара владельца галереи в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер картинки-анонса фотоальбома (px) ALBUM_PHOTO_THUMBS_SIZE Указывается размер картинки-анонса фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер фотографии-анонса (px) THUMBS_SIZE Указывается размер картинки-анонса альбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Размер картинки в предпросмотре в списке альбомов (px) SECTION_LIST_THUMBS_SIZE Указывается размер картинки в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Обязательно ограничивать размер оригинала (px) (при значении 0 ограничение не происходит) ORIGINAL_SIZE Задается размер оригинала фотографии в пикселях. Фотография будет уменьшена до указанной величины. Если указано значение 0, то изменение размера не происходит. Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
    Качество фотографии-анонса (%) JPEG_QUALITY1 Указывается качество фотографии-анонса в процентах (100% - самое высокое качество).
    Качество загружаемой фотографии (%) JPEG_QUALITY Указывается качество загружаемой фотографии в процентах (100% - самое высокое качество).
    Дополнительные эскизы ADDITIONAL_SIGHTS Указываются типы для эскизов фотографий, которые должны быть показаны.
    Управление адресами страниц
    Включить поддержку ЧПУ SEF_MODE [Y|N] При отмеченной опции будет включена поддержка ЧПУ.

    Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры: Настраиваемые параметры при включенном режиме поддержки ЧПУ:
    Каталог ЧПУ (относительно корня сайта) SEF_FOLDER Каталог ЧПУ: путь до папки, с которой работает компонент. Этот путь может как совпадать с физическим путём, так и не совпадать.
    Адреса страниц SEF_URL_TEMPLATES Указываются адреса следующих страниц:
    • index - страница со списком альбомов;
    • galleries - страница со списком галерей;
    • gallery - страница с содержимым галереи;
    • gallery_edit - страница редактирования параметров галереи;
    • section - страница просмотра альбомов;
    • section_edit - страница редактирования параметров альбома;
    • section_edit_icon - страница выбора обложки альбома;
    • upload - страница загрузки фотографий;
    • detail - страница просмотра фотографий;
    • detail_edit - страница редактирования параметров фотографии;
    • detail_slide_show - страница слайд-шоу;
    • detail_list - страница со списком фотографий;
    • search - страница поиска;
    • tags - страница тегов.
    SEF_FOLDER и SEF_URL_TEMPLATES.

    Если режим поддержки ЧПУ выключен, то необходимо настроить массив переменных Настраиваемые параметры при выключенном режиме поддержки ЧПУ:
    ID пользователя USER_ID Задается переменная, в которой будет передаваться идентификатор пользователя.
    Код галереи USER_ALIAS Задается переменная, в которой будет передаваться символьный код галереи.
    Идентификатор раздела SECTION_ID Задается переменная, в которой будет передаваться идентификатор раздела (альбома).
    Идентификатор элемента ELEMENT_ID Задается переменная, в которой будет передаваться идентификатор элемента (фотографии).
    Идентификатор страницы PAGE_NAME Задается переменная, в которой будет передаваться идентификатор страницы.
    Идентификатор действия ACTION Задается переменная, в которой будет передаваться идентификатор действия.
    VARIABLE_ALIASES, который включает в себя: USER_ID, USER_ALIAS, SECTION_ID, ELEMENT_ID, PAGE_NAME, ACTION.
    Настройки кеширования
    Тип кеширования CACHE_TYPE Тип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
    Дополнительные настройки
    Формат вывода даты альбома DATE_TIME_FORMAT_SECTION Указывается формат показа даты и времени альбома. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
    Формат вывода даты фото DATE_TIME_FORMAT_DETAIL Указывается формат показа даты и времени фотографии. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
    Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Галерея.
    [Главная страница] Количество фото на главной странице INDEX_PAGE_TOP_ELEMENTS_COUNT Указывается количество фотографий, выводимых на главной странице фотогалереи.
    [Главная страница] Показывать только опубликованные фото SHOW_ONLY_PUBLIC [Y|N] При отмеченной опции только на главной странице будут выводится только опубликованные фотографии.

    Если опция отмечена, то необходимо настроить следущие параметры: PUBLIC_BY_DEFAULT и MODERATE.
    Показывать секцию кнопок управления SHOW_CONTROLS_BUTTONS [Y|N] При отмеченной опции на Главной странице пользовательской галереи будут показываться кнопки управления (например Мои фото, Мои галереи, Загрузить фото).
    Настройки голосования
    Разрешить голосование USE_RATING [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 Указывается одно из значений, которое должно быть показано в качестве рейтинга:
    • по умолчанию;
    • Плюс / минус (standart);
    • Мне нравится (like).

    Параметр доступен только если выбран Рейтинг (главного модуля) (rating_main).
    Настройки тегов
    Показывать теги SHOW_TAGS [Y|N] При отмеченной опции будет показано облако тегов фотогалереи. Облако тегов:
    Количество тегов TAGS_PAGE_ELEMENTS Указывается количество тегов, отображаемых в облаке.
    Период выборки тегов (дней) TAGS_PERIOD Указывается количество дней, за которые происходит выборка тегов.
    Сужать область поиска TAGS_INHERIT [Y|N] При отмеченной опции выбранные теги добавляются в фильтр поиска.
    Максимальный размер шрифта (px) TAGS_FONT_MAX Указывается максимальный размер шрифта отображения тегов (в пикселах).
    Минимальный размер шрифта (px) TAGS_FONT_MIN Указывается минимальный размер шрифта отображения тегов (в пикселах).
    Цвет более позднего тега (пример: "C0C0C0") TAGS_COLOR_NEW Указывается код цвета тегов, дата создания которых наиболее поздняя (пример: "C0C0C0").
    Цвет более раннего тега (пример: "FEFEFE") TAGS_COLOR_OLD Указывается код цвета тегов, дата создания которых наиболее ранняя (пример: "FEFEFE").
    Показывать цепочку навигации TAGS_SHOW_CHAIN [Y|N] При отмеченной опции будет показана цепочка навигации. Параметр работает, если параметр TAGS_INHERIT принимает значение Y.
    Загрузка фото
    Тип загрузчика PHOTO_UPLOADER_TYPE Указывается тип загрузчика фотографий в фотогалерею:
    • Одиночная загрузка через форму (form);
    • Множественный загрузчик (Java/ActiveX) (applet);
    • Множественный Flash-загрузчик (flash).
    Параметр устарел с версии 15.0.0.
    Схема множественного загрузчикаAPPLET_LAYOUTПараметр определяет тип загрузчика в фотогалерии по умолчанию:
    • Стандартный шаблон (extended);
    • Упрощенный шаблон загрузчика (simple).
    Выбор параметра доступен только при выборе параметра "Тип загрузчика" (PHOTO_UPLOADER_TYPE) равным "Множественный загрузчик (Java/ActiveX)" (applet).

    Параметр устарел с версии 15.0.0.
    Максимальный размер загружаемого файла (не должен превышать 1024Mб) (Мб) UPLOAD_MAX_FILE_SIZE Указывается максимальный размер загружаемого файла в Мб (не должен превышать 1024Mб).
    Наносить авторский знак USE_WATERMARK [Y|N] При отмеченной опции при загрузке фотографий можно будет наносить авторский знак.Станут доступны поля настройки авторского знака. Поля настройки авторского знака:
    Правила нанесения авторского знака WATERMARK_RULES Указывается правило нанесения авторского знака:
    • На усмотрение пользователя (USER);
    • Обязательно наносить авторский знак (ALL).
    Если выбрано значение Обязательно наносить авторский знак, то необходимо настроить дополнительные параметры (приведены в таблице ниже).
    Файл со шрифтом для авторского знака PATH_TO_FONT Указывается файл со шрифтом для создания авторского знака (будет использоваться также и при множественной загрузке). Шрифты предварительно загружаются в директорию \bitrix\modules\photogallery\fonts\. Поддерживаются TTF-, OTF- и PS-шрифты.
    Минимальный размер фото для авторского знака (px) WATERMARK_MIN_PICTURE_SIZE Указывается минимальный размер фото, на которых будет нанесен авторский знак в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально. На фотографии меньшего размера знак добавлен не будет.

    Дополнительные параметры, заполняемые при выборе правила Обязательно наносить авторский знак
    (обратите внимание, что список параметров меняется в зависимости от типа авторского знака) :
    Тип авторского знака WATERMARK_TYPE Указывается тип авторского знака:
    • Надпись (текст) (TEXT);
    • Картинка (PICTURE).
    Если выбрано значение TEXT, то дополнительно необходимо настроить параметры: WATERMARK_TEXT, WATERMARK_COLOR и WATERMARK_SIZE.

    Если выбрано значение PICTURE, то дополнительно необходимо настроить параметры: WATERMARK_FILE и WATERMARK_FILE_ORDER.
    Текст надписи WATERMARK_TEXT Задается текст авторского знака.
    Цвет надписи (без #, например, FF00EE) WATERMARK_COLOR Указывается шестнадцатеричный код цвета надписи без использования #.
    Размер надписи (% от размера картинки) WATERMARK_SIZE Задается размер надписи авторского знака в процентном соотношении от размера фото.
    Размещение авторского знака WATERMARK_POSITION Указывается область размещения авторского знака на фото:
    • Сверху слева (tl);
    • Сверху по центру (tc);
    • Сверху справа (tr);
    • Cлева (ml);
    • По центру (mc);
    • Cправа (mr);
    • Снизу cлева (bl);
    • Снизу по центру (bc);
    • Снизу cправа (br).
    Физический полный путь к картинке WATERMARK_FILE Указывается полный путь к картинке для авторского знака относительно корня сайта.
    Расположение картинки на фото WATERMARK_FILE_ORDER Указывается тип расположения картинки авторского знака на фото:
    • Без изменений (usual);
    • Растянуть (resize);
    • Замостить (repeat).
    Прозрачность авторского знака WATERMARK_TRANSPARENCY Задается величина прозрачности авторского знака (в %).
    Настройки отзывов
    Разрешить отзывы USE_COMMENTS [Y|N] При отмеченной опции будет доступен функционал отзывов.При расширенном режиме станут доступны дополнительные поля. Дополнительные поля:
    Компонент комментариев COMMENTS_TYPE Указывается компонент, с помощью которого будут добавляться комментарии:
    • Блоги (blog);
    • Форум (forum).
    Если указать Блоги, то необходимо настроить следущие параметры: BLOG_URL, COMMENTS_COUNT, PATH_TO_USER, PATH_TO_BLOG.

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


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

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

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

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

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