Документация для разработчиков
Документация для разработчиков Документация по D7 Документация по REST Пользовательская документация
Темная тема

Фотогалерея 2.0


Описание conf.photogallery

Комплексный компонент позволяет получить полнофункциональную фотогалерею. Компонент доступен при использовании решения Сайт конференции и поддерживает два режима настройки: простой и расширенный. Компонент стандартный и входит в дистрибутив модуля.

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

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



Параметры

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

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

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

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

Если режим поддержки ЧПУ выключен, то необходимо настроить следующие параметры:
Идентификатор раздела 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] При отмеченной опции будут установлены заголовки всех страниц в соответствии с их содержимым.
Настройки фотогалереи
Размер картинки фотоальбома (px) ALBUM_PHOTO_SIZE Указывается размер обложки фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер фотографии-анонса (px) 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).
Схема множественного загрузчикаAPPLET_LAYOUTПараметр определяет тип загрузчика в фотогалерии по умолчанию:
  • Стандартный шаблон (extended);
  • Упрощенный шаблон загрузчика (simple).
Выбор параметра доступен только при выборе параметра "Тип загрузчика" (PHOTO_UPLOADER_TYPE) равным "Множественный загрузчик (Java/ActiveX)" (applet)
Максимальный размер загружаемого файла (не должен превышать 1024Mб) (Мб) UPLOAD_MAX_FILE_SIZE Указывается максимальный размер загружаемого фото в Мб (не должен превышать 1024Mб).
Наносить авторский знак USE_WATERMARK [Y|N] При отмеченной опции при загрузке фотографий можно будет наносить авторский знак. Станут доступны поля настройки авторского знака
Правила нанесения авторского знака WATERMARK_RULES Указывается правило нанесения авторского знака:
  • На усмотрение пользователя (USER);
  • Обязательно наносить авторский знак (ALL).
Если выбрано значение ALL, то дополнительно необходимо настроить следующие параметры:
  • WATERMARK_POSITION и WATERMARK_TRANSPARENCY;
  • в зависимости от значения параметра WATERMARK_TYPE настроить соответствующие поля.
Размещение авторского знака WATERMARK_POSITION Указывается область размещения авторского знака на фото:
  • Сверху слева (tl);
  • Сверху по центру (tc);
  • Сверху справа (tr);
  • Cлева (ml);
  • По центру (mc);
  • Cправа (mr);
  • Снизу cлева (bl);
  • Снизу по центру (bc);
  • Снизу cправа (br).
Прозрачность авторского знака WATERMARK_TRANSPARENCY Задается величина прозрачности авторского знака (в %).
Тип авторского знака 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_FILE Указывается полный путь к картинке для авторского знака относительно корня сайта.
Расположение картинки на фото WATERMARK_FILE_ORDER Указывается тип расположения картинки авторского знака на фото:
  • Без изменений (usual);
  • Растянуть (resize);
  • Замостить (repeat).
Файл со шрифтом для авторского знака PATH_TO_FONT Указывается файл со шрифтом для создания авторского знака (будет использоваться также и при множественной загрузке). Шрифты предварительно загружаются в директорию \bitrix\modules\photogallery\fonts\. Поддерживаются TTF-, OTF- и PS-шрифты.
Минимальный размер фото для авторского знака (px) WATERMARK_MIN_PICTURE_SIZE Указывается минимальный размер фото, на которых будет нанесен авторский знак в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально. На фотографии меньшего размера знак добавлен не будет.
.

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

Поле Параметр Описание
Дополнительно
Показывать ссылки на главной странице SHOW_LINK_ON_MAIN_PAGE Указываются категории ссылок, которые будут отображены на главной старнице:
  • Новые (по дате добавления) - (id);
  • Посещаемые (по количеству показов) - (shows);
  • Лучшие (по количеству голосов) - (rating);
  • Обсуждаемые (по количеству комментариев) - (comments).
Основные параметры
Использовать простой режим настройки USE_LIGHT_VIEW [Y|N] При отмеченной опции будет использоваться простой режим настройки фотогалереи (значения остальных параметров будут по умолчанию).
Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационных блоков.
Инфоблок IBLOCK_ID Для выбранного типа инфоблоков указывается идентификатор информационного блока, в котором будут храниться фотографии.
Этап конференции PARENT_SECTION Выбирается этап конференции.
По какому полю сортируем альбомы 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 Указывается один из созданных в системе форумов, который будет использован для комментариев.
Блог для комментариев BLOG_URL Указывается блог, в котором будут храниться комментарии.
Путь к блогу PATH_TO_BLOG Указывается путь к главной странице блога.
Количество комментариев на странице 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 Указываются адреса следующих страниц:
  • index - главная страница фотогалереи;
  • section - страница просмотра альбома;
  • section_edit - страница редактирования параметров альбома;
  • section_edit_icon - страница выбора обложки альбома;
  • upload - страница загрузки фотографий;
  • detail - страница просмотра фотографий;
  • detail_edit - страница редактирования параметров фотографии;
  • detail_list - страница со списком фотографий альбома;
  • search - страница поиска.
Имена переменных VARIABLE_ALIASES Имена переменных для управления страницами.
SEF_FOLDER, SEF_URL_TEMPLATES и VARIABLE_ALIASES.

Если режим поддержки ЧПУ выключен, то необходимо настроить следующие параметры:
Идентификатор раздела SECTION_ID Указывается имя переменной, которой передается идентификатор раздела (альбома) фотогалереи.
Идентификатор элемента ELEMENT_ID Указывается имя переменной, которой передается идентификатор элемента (фотографии) фотогалереи.
Идентификатор страницы PAGE_NAME Указывается имя переменной, которой передается идентификатор страницы фотогалереи.
Идентификатор действия ACTION Указывается имя переменной, которой передается идентификатор действия фотогалереи.
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] При отмеченной опции в качестве заголовка страницы будет установлено Фотогалерея.
Настройки постраничной навигации
Количество альбомов на странице SECTION_PAGE_ELEMENTS Указывается количество альбомов на странице. Весь список альбомов будет выведен с помощью постраничной навигации.
Количество фото на странице ELEMENTS_PAGE_ELEMENTS Указывается количество фотографий на странице. Весь список фотографий будет выведен с помощью постраничной навигации.
Шаблон для постраничной навигации PAGE_NAVIGATION_TEMPLATE Указываются название шаблона для постраничной навигации.
Настройки фотогалереи
Размер картинки фотоальбома (px) ALBUM_PHOTO_SIZE Указывается размер картинки фотоальбома в пикселях (px). Размер задается для большей стороны картинки, другая сторона загружаемого изображения будет высчитана пропорционально.
Размер фотографии-анонса (px) 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).
Схема множественного загрузчикаAPPLET_LAYOUTПараметр определяет тип загрузчика в фотогалерии по умолчанию:
  • Стандартный шаблон (extended);
  • Упрощенный шаблон загрузчика (simple).
Выбор параметра доступен только при выборе параметра "Тип загрузчика" (PHOTO_UPLOADER_TYPE) равным "Множественный загрузчик (Java/ActiveX)" (applet)
Максимальный размер загружаемого файла (не должен превышать 1024Mб) (Мб) UPLOAD_MAX_FILE_SIZE Указывается максимальный размер загружаемого файла в Мб (не должен превышать 1024Mб).
Наносить авторский знак USE_WATERMARK [Y|N] При отмеченной опции при загрузке фотографий можно будет наносить авторский знак. Станут доступны поля настройки авторского знака
Правила нанесения авторского знака WATERMARK_RULES Указывается правило нанесения авторского знака:
  • На усмотрение пользователя (USER);
  • Обязательно наносить авторский знак (ALL).
Если выбрано значение ALL, то дополнительно необходимо настроить следующие параметры:
  • WATERMARK_POSITION и WATERMARK_TRANSPARENCY;
  • в зависимости от значения параметра WATERMARK_TYPE настроить соответствующие поля.
Размещение авторского знака WATERMARK_POSITION Указывается область размещения авторского знака на фото:
  • Сверху слева (tl);
  • Сверху по центру (tc);
  • Сверху справа (tr);
  • Cлева (ml);
  • По центру (mc);
  • Cправа (mr);
  • Снизу cлева (bl);
  • Снизу по центру (bc);
  • Снизу cправа (br).
Прозрачность авторского знака WATERMARK_TRANSPARENCY Задается величина прозрачности авторского знака (в %).
Тип авторского знака 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_FILE Указывается полный путь к картинке для авторского знака относительно корня сайта.
Расположение картинки на фото WATERMARK_FILE_ORDER Указывается тип расположения картинки авторского знака на фото:
  • Без изменений (usual);
  • Растянуть (resize);
  • Замостить (repeat).
Файл со шрифтом для авторского знака PATH_TO_FONT Указывается полный путь к файлу шрифта для авторского знака относительно корня сайта.
Минимальный размер фото для авторского знака (px) PATH_TO_FONT Указывается минимальный размер фото в пикселях, меньше которого авторский знак наноситься не будет.
.


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

<?$APPLICATION->IncludeComponent(
"bitrix:conf.photogallery",
	"",
	Array(
		"SHOW_LINK_ON_MAIN_PAGE" => array("id"),
		"USE_LIGHT_VIEW" => "Y",
		"SEF_MODE" => "Y",
		"IBLOCK_TYPE" => "s1_conference",
		"IBLOCK_ID" => "8",
		"PARENT_SECTION" => "0",
		"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",
		"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",
 		"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" => "USER",
		"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" => "forum",
		"COMMENTS_COUNT" => "10",
		"PATH_TO_SMILE" => "/bitrix/images/forum/smile/",
		"USE_CAPTCHA" => "N",
		"PREORDER" => "N",
		"POST_FIRST_MESSAGE" => "N",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"TAGS_PAGE_ELEMENTS" => "150",
		"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" => "/conf2013/visitors/",
		"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
Наверх