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

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

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

Описание photogallery

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

Настройки компонента дают возможность гибко управлять параметрами фотогалереи:

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

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

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

Компонент содержит два шаблона: .default и old.

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

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



Параметры. Простой режим

Поле Параметр Описание
Основные параметры
Использовать простой режим настройки USE_LIGHT_VIEW [Y|N] При отмеченной опции будет использоваться простой режим настройки фотогалереи (значения остальных параметров будут по умолчанию).
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
Путь к профилю пользователя PATH_TO_USER Указывается шаблон пути к профилю пользователя.
Сортировать фотографии в альбоме перетаскиванием DRAG_SORT [Y|N] При отмеченной опции можно сортировать фотографии в альбоме перетаскиванием с помощью мыши.
Настройки отзывов
Разрешить отзывы USE_COMMENTS [Y|N] При отмеченной опции будет доступен функционал отзывов, станут активны дополнительные поля Дополнительные поля:
Компонент комментариевCOMMENTS_TYPE Указывается компонент, с помощью которого будут добавляться комментарии:
  • Блоги (blog);
  • Форум (forum).
Если указать Блоги, то необходимо настроить следующие параметры: BLOG_URL, PATH_TO_BLOG.

Если указать Форум, то необходимо настроить параметр FORUM_ID.
Блог для комментариевBLOG_URL Указывается блог, в котором будут храниться комментарии.
Путь к блогуPATH_TO_BLOG Указывается путь к главной странице блога.
ID форума для отзывовFORUM_IDУказывается один из созданных в системе форумов, который будет использован для комментариев.
Отображение имениNAME_TEMPLATEУказывается шаблон для отображения ФИО комментирующего пользователя. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.
Управление адресами страниц
Включить поддержку ЧПУ SEF_MODE [Y|N] При отмеченной опции будет включена поддержка ЧПУ.

Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры: Настраиваемые параметры при включенном режиме поддержки ЧПУ:
Каталог ЧПУ (относительно корня сайта) SEF_FOLDER Каталог ЧПУ: путь до папки, с которой работает компонент. Этот путь может как совпадать с физическим путём, так и не совпадать.
Адреса страниц SEF_URL_TEMPLATES Указываются адреса следующих страниц:
  • Главная страница - главная страница фотогалереи;
  • Альбом - страница просмотра альбома;
  • Альбом (редактирование) - страница редактирования параметров альбома;
  • Альбом (редактирование обложки) - страница выбора обложки альбома;
  • Загрузка фото - страница загрузки фотографий;
  • Фото - страница просмотра фотографий;
  • Фото (редактирование) - страница редактирования параметров фотографии;
  • Фото (список) - страница со списком фотографий альбома;
  • Поиск - страница поиска.
SEF_FOLDER и SEF_URL_TEMPLATES.

Если режим поддержки ЧПУ выключен, то необходимо настроить следующие параметры: Настраиваемые параметры при выключенном режиме поддержки ЧПУ:
Идентификатор раздела SECTION_ID Указывается имя переменной, которой передается идентификатор раздела (альбома) фотогалереи.
Идентификатор элемента ELEMENT_ID Указывается имя переменной, которой передается идентификатор элемента (фотографии) фотогалереи.
Идентификатор страницы PAGE_NAME Указывается имя переменной, которой передается идентификатор страницы фотогалереи.
Идентификатор действия ACTION Указывается имя переменной, которой передается идентификатор действия фотогалереи.
SECTION_ID, ELEMENT_ID, PAGE_NAME и ACTION.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции будут установлены заголовки всех страниц в соответствии с их содержимым.
Показывать ссылки на главной странице SHOW_LINK_ON_MAIN_PAGE Указываются категории ссылок, которые будут отображены на главной старнице:
  • Новые (по дате добавления) (id);
  • Посещаемые (по количеству показов) (shows);
  • Лучшие (по количеству голосов) (rating);
  • Обсуждаемые (по количеству комментариев) (comments).
Настройки фотогалереи
Размер картинки фотоальбома (px) ALBUM_PHOTO_SIZE Указывается размер картинки фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер фотографии-анонса (px) THUMBS_SIZE Указывается размер картинки-анонса альбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер картинки в предпросмотре в списке альбомов (px) SECTION_LIST_THUMBS_SIZE Указывается размер картинки в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Обязательно ограничивать размер оригинала (px) (при значении 0 ограничение не происходит) ORIGINAL_SIZE Задается размер оригинала фотографии в пикселях. Фотография будет уменьшена до указанной величины. Если указано значение 0, то изменение размера не происходит. Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Отображать список альбомов в качестве рубрик со списком последних добавленых фотографий PHOTO_LIST_MODE [Y|N] При отмеченной опции в списке альбомов-рубрик будут отображаться последние добавленные фотографии.
Количество выводимых фотографий в списке альбомов SHOWN_ITEMS_COUNT Задается количество отображаемых последних фотографий в альбомах в режиме, включенном параметром PHOTO_LIST_MODE.
Настройки голосования
Разрешить голосование 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).
MAX_VOTE и VOTE_NAMES.
Настройки тегов
Показывать теги SHOW_TAGS [Y|N] При отмеченной опции будет показано облако тегов фотогалереи. Станут активными дополнительные поля
Количество тегов TAGS_PAGE_ELEMENTS Указывается количество тегов, отображаемых в облаке.
Максимальный размер шрифта (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

Внимание! Функционал авторского знака устарел и не поддерживается с версии 14.5.0 Главного модуля (main).


[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_LIGHT_VIEW [Y|N] При отсутствии отметки на данной опции будет использоваться расширенный режим настройки фотогалереи.
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться.
По какому полю сортируем альбомы 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 Указывается шаблон пути к профилю пользователя.
Сортировать фотографии в альбоме перетаскиванием DRAG_SORT [Y|N] При отмеченной опции можно сортировать фотографии в альбоме перетаскиванием с помощью мыши.
Настройки отзывов
Разрешить отзывы 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.
ID форума для отзывов FORUM_ID Указывается один из созданных в системе форумов, который будет использован для комментариев.
Количество комментариев на странице COMMENTS_COUNT Указывается количество комментариев на странице.
Страница чтения темы URL_TEMPLATES_READ Указывается адрес страницы чтения темы форума.
Страница пользователя URL_TEMPLATES_PROFILE_VIEW Указывается адрес страницы профиля пользователя относительно корня сайта.
Путь относительно корня сайта к папке со смайлами PATH_TO_SMILE Указывается путь к папке со смайликами относительно корня сайта.
Использовать CAPTCHA USE_CAPTCHA [Y|N] При отмеченной опции будет выводиться изображение и поле ввода CAPTCHA в форме добавления комментария в публичной части.
Выводить сообщения в прямом порядке PREORDER [Y|N] При отмеченной опции собщения будут отсортированы по дате создания по возрастанию.
Начинать тему текстом элемента POST_FIRST_MESSAGE [Y|N] При отмеченной опции в обсуждении на форуме будет выведено первое сообщение отзыва.
Отображение имени NAME_TEMPLATE Указывается шаблон для отображения ФИО комментирующего пользователя. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.
Управление адресами страниц
Включить поддержку ЧПУ SEF_MODE [Y|N] При отмеченной опции будет включена поддержка ЧПУ.

Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры: Настраиваемые параметры при включенном режиме поддержки ЧПУ:
Каталог ЧПУ (относительно корня сайта) SEF_FOLDER Каталог ЧПУ: путь до папки, с которой работает компонент. Этот путь может как совпадать с физическим путём, так и не совпадать.
Адреса страниц SEF_URL_TEMPLATES Указываются адреса следующих страниц:
  • Главная страница - главная страница фотогалереи;
  • Альбом - страница просмотра альбома;
  • Альбом (редактирование) - страница редактирования параметров альбома;
  • Альбом (редактирование обложки) - страница выбора обложки альбома;
  • Загрузка фото - страница загрузки фотографий;
  • Фото - страница просмотра фотографий;
  • Фото (редактирование) - страница редактирования параметров фотографии;
  • Фото (список) - страница со списком фотографий альбома;
  • Поиск - страница поиска.
SEF_FOLDER и SEF_URL_TEMPLATES.

Если режим поддержки ЧПУ выключен, то необходимо настроить следующие параметры: Настраиваемые параметры при выключенном режиме поддержки ЧПУ:
Идентификатор раздела SECTION_ID Указывается имя переменной, которой передается идентификатор раздела (альбома) фотогалереи.
Идентификатор элемента ELEMENT_ID Указывается имя переменной, которой передается идентификатор элемента (фотографии) фотогалереи.
Идентификатор страницы PAGE_NAME Указывается имя переменной, которой передается идентификатор страницы фотогалереи.
Идентификатор действия ACTION Указывается имя переменной, которой передается идентификатор действия фотогалереи.
SECTION_ID, ELEMENT_ID, PAGE_NAME и ACTION.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции будут установлены заголовки всех страниц в соответствии с их содержимым.
Показывать ссылки на главной странице SHOW_LINK_ON_MAIN_PAGE Указываются категории ссылок, которые будут отображены на главной старнице:
  • Новые (по дате добавления) (id);
  • Посещаемые (по количеству показов) (shows);
  • Лучшие (по количеству голосов) (rating);
  • Обсуждаемые (по количеству комментариев) (comments).
Формат вывода даты альбома DATE_TIME_FORMAT_SECTION Указывается формат показа даты и времени альбома. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат вывода даты фото DATE_TIME_FORMAT_DETAIL Указывается формат показа даты и времени фотографии. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Настройки постраничной навигации
Количество альбомов на странице SECTION_PAGE_ELEMENTS Указывается количество альбомов, отображаемых на одной странице. Остальные альбомы будут выведены с помощью постраничной навигации.
Количество фото на странице ELEMENTS_PAGE_ELEMENTS Указывается количество фотографий, отображаемых на одной странице. Остальные фотографии будут выведены с помощью постраничной навигации.
Шаблон для постраничной навигации PAGE_NAVIGATION_TEMPLATE Указываются название шаблона для постраничной навигации.
Настройки фотогалереи
Размер картинки фотоальбома (px) ALBUM_PHOTO_SIZE Указывается размер картинки фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер фотографии-анонса (px) THUMBS_SIZE Указывается размер картинки-анонса альбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер картинки в предпросмотре в списке альбомов (px) SECTION_LIST_THUMBS_SIZE Указывается размер картинки в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Качество фотографии-анонса (%) JPEG_QUALITY1 Указывается качество фотографии-анонса в процентах (100% - самое высокое качество).
Обязательно ограничивать размер оригинала (px) (при значении 0 ограничение не происходит) ORIGINAL_SIZE Задается размер оригинала фотографии в пикселях. Фотография будет уменьшена до указанной величины. Если указано значение 0, то изменение размера не происходит. Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Качество загружаемой фотографии (%) JPEG_QUALITY Указывается качество загружаемой фотографии в процентах (100% - самое высокое качество).
Дополнительные эскизы ADDITIONAL_SIGHTS Указываются типы для эскизов фотографий, которые должны быть показаны.
Отображать список альбомов в качестве рубрик со списком последних добавленых фотографий PHOTO_LIST_MODE [Y|N] При отмеченной опции в списке альбомов-рубрик будут отображаться последние добавленные фотографии.
Количество выводимых фотографий в списке альбомов SHOWN_ITEMS_COUNT Задается количество отображаемых последних фотографий в альбомах в режиме, включенном параметром PHOTO_LIST_MODE.
Отображать навигационную цепочку 'хлебные крошки' в рамках комплексного компонента SHOW_NAVIGATION [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).
MAX_VOTE и VOTE_NAMES.
Настройки тегов
Показывать теги 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

Внимание! Функционал авторского знака устарел и не поддерживается с версии 14.5.0 Главного модуля (main).


[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 Задается величина прозрачности авторского знака (в %).


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

<?$APPLICATION->IncludeComponent("bitrix:photogallery","",Array(
		"SHOW_LINK_ON_MAIN_PAGE" => array("id","rating","comments","shows"),
		"USE_LIGHT_VIEW" => "Y",
		"SEF_MODE" => "Y",
		"IBLOCK_TYPE" => "gallery",
		"IBLOCK_ID" => "10",
		"SECTION_SORT_BY" => "UF_DATE",
		"SECTION_SORT_ORD" => "DESC",
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "desc",
		"PATH_TO_USER" => "",
		"SECTION_PAGE_ELEMENTS" => "15",
		"ELEMENTS_PAGE_ELEMENTS" => "50",
		"PAGE_NAVIGATION_TEMPLATE" => "",
		"ALBUM_PHOTO_SIZE" => "120",
		"THUMBNAIL_SIZE" => "100",
		"JPEG_QUALITY1" => "100",
		"ORIGINAL_SIZE" => "1280",
		"JPEG_QUALITY" => "100",
		"ADDITIONAL_SIGHTS" => array(),
		"PHOTO_LIST_MODE" => "Y",
		"SHOWN_ITEMS_COUNT" => "6",
		"SHOW_NAVIGATION" => "N",
		"DATE_TIME_FORMAT_DETAIL" => "d.m.Y",
		"DATE_TIME_FORMAT_SECTION" => "d.m.Y",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_NOTES" => "",
		"USE_RATING" => "Y",
		"SHOW_TAGS" => "Y",
		"DRAG_SORT" => "Y",
		"UPLOADER_TYPE" => "applet",
		"APPLET_LAYOUT" => "extended",
		"UPLOAD_MAX_FILE_SIZE" => "1024",
		"USE_WATERMARK" => "Y",
		"WATERMARK_RULES" => "ALL",
		"WATERMARK_TYPE" => "PICTURE",
		"WATERMARK_FILE" => "",
		"WATERMARK_FILE_ORDER" => "usual",
		"WATERMARK_POSITION" => "mc",
		"WATERMARK_TRANSPARENCY" => "20",
		"PATH_TO_FONT" => "",
		"WATERMARK_MIN_PICTURE_SIZE" => "800",
		"MAX_VOTE" => "5",
		"VOTE_NAMES" => array("1","2","3","4","5"),
		"DISPLAY_AS_RATING" => "rating",
		"USE_COMMENTS" => "Y",
		"COMMENTS_TYPE" => "blog",
		"BLOG_URL" => "admin-blg",
		"COMMENTS_COUNT" => "10",
		"PATH_TO_BLOG" => "",
		"PATH_TO_SMILE" => "/bitrix/images/forum/smile/",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"TAGS_PAGE_ELEMENTS" => "150",
		"TAGS_PERIOD" => "",
		"TAGS_INHERIT" => "Y",
		"TAGS_FONT_MAX" => "30",
		"TAGS_FONT_MIN" => "10",
		"TAGS_COLOR_NEW" => "3E74E6",
		"TAGS_COLOR_OLD" => "C0C0C0",
		"TAGS_SHOW_CHAIN" => "Y",
		"SEF_FOLDER" => "/",
		"SEF_URL_TEMPLATES" => Array(
			"index" => "index.php",
			"section" => "#SECTION_ID#/",
			"section_edit" => "#SECTION_ID#/action/#ACTION#/",
			"section_edit_icon" => "#SECTION_ID#/icon/action/#ACTION#/",
			"upload" => "#SECTION_ID#/action/upload/",
			"detail" => "#SECTION_ID#/#ELEMENT_ID#/",
			"detail_edit" => "#SECTION_ID#/#ELEMENT_ID#/action/#ACTION#/",
			"detail_list" => "list/",
			"search" => "search/"
		),
		"VARIABLE_ALIASES" => Array(
			"index" => Array(),
			"section" => Array(),
			"section_edit" => Array(),
			"section_edit_icon" => Array(),
			"upload" => Array(),
			"detail" => Array(),
			"detail_edit" => Array(),
			"detail_list" => Array(),
			"search" => Array(),
		)
	),
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024