Описание photogallery.upload
Компонент служит для загрузки фотографии. Компонент стандартный и входит в дистрибутив модуля.
В визуальном редакторе компонент находится в Компоненты > Контент > Фотогалерея 2.0.
Компонент относится к модулю Фотогалерея.
Параметры
Поле |
Параметр |
Описание |
Основные параметры |
Тип инфоблока |
IBLOCK_TYPE |
Указывается один из созданных в системе типов информационных блоков. |
Инфоблок |
IBLOCK_ID |
Для выбранного типа инфоблоков указывается идентификатор информационного блока, фотографии из которого будут выводиться. |
ID раздела |
SECTION_ID |
Указывается числовой код, в котором передается идентификатор раздела. |
Шаблоны ссылок |
Индексная страница |
INDEX_URL |
Указывается адрес главной страницы галереи. |
Страница просмотра альбома |
SECTION_URL |
Указывается адрес страницы просмотра содержимого альбома фотогалереи. |
Дополнительные настройки |
Устанавливать заголовок страницы |
SET_TITLE |
[Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Загрузка фотографий. |
Настройки фотогалереи |
Тип загрузчика |
UPLOADER_TYPE |
Указывается тип загрузчика фотографий в фотогалерею:
- Одиночная загрузка через форму (form);
- Множественный загрузчик (Java/ActiveX) (applet);
- Множественный Flash-загрузчик (flash).
Параметр устарел с версии 15.0.0.
|
Схема множественного загрузчика | APPLET_LAYOUT | Параметр определяет тип загрузчика в фотогалерии по умолчанию:
- Стандартный шаблон (extended);
- Упрощенный шаблон загрузчика (simple).
Выбор параметра доступен только при выборе параметра "Тип загрузчика" (UPLOADER_TYPE) равным "Множественный загрузчик (Java/ActiveX)" (applet).
Параметр устарел с версии 15.0.0.
|
Максимальный размер загружаемого файла (Мб) |
UPLOAD_MAX_FILE_SIZE |
Указывается максимальный размер загружаемого файла в Мб. |
Пользовательские эскизы |
ADDITIONAL_SIGHTS |
Выбираются пользовательские эскизы из заданных в настройках модуля. |
Обязательная премодерация фото |
MODERATION |
[Y|N] При отмеченной опции будет выполняться обязательная премодерация фото. |
Размер картинки-анонса фотоальбома (px) |
ALBUM_PHOTO_THUMBS_WIDTH |
Указываются картинки-анонса для фотоальбома в пикселах. |
Настройки авторского знака |
Наносить авторский знак |
USE_WATERMARK |
Внимание! Функционал авторского знака устарел и не поддерживается с версии 14.5.0 Главного модуля (main).
[Y|N] При отмеченной опции при загрузке фотографий можно будет наносить авторский знак.Станут доступны
поля настройки авторского знака.
Поля настройки авторского знака:
Правила нанесения авторского знака |
WATERMARK_RULES |
Указывается правило нанесения авторского знака:
- На усмотрение пользователя (USER);
- Обязательно наносить авторский знак (ALL).
Если выбрано значение USER, то необходимо настроить следующие параметры: WATERMARK_TYPE, PATH_TO_FONT и WATERMARK_MIN_PICTURE_SIZE.
Если выбрано значение ALL, то необходимо настроить следующие параметры:
- WATERMARK_TYPE, PATH_TO_FONT, WATERMARK_MIN_PICTURE_SIZE, WATERMARK_POSITION и WATERMARK_TRANSPARENCY;
- и в зависимости от значения параметра WATERMARK_TYPE дополнительно настроить соответствующие поля.
|
Тип авторского знака |
WATERMARK_TYPE |
Указывается тип авторского знака:
- На выбор: текст или картинка (BOTH) - доступно, если в параметре USE_WATERMARK выбрано значение USER;
- Надпись (текст) (TEXT);
- Картинка (PICTURE).
Если выбрано значение TEXT, а в параметре USE_WATERMARK было выбрано значение ALL, то дополнительно необходимо настроить параметры: WATERMARK_TEXT, WATERMARK_COLOR и WATERMARK_SIZE.
Если выбрано значение PICTURE, а в параметре USE_WATERMARK было выбрано значение ALL, то дополнительно необходимо настроить параметры: WATERMARK_FILE и WATERMARK_FILE_ORDER.
|
Файл со шрифтом для авторского знака |
PATH_TO_FONT |
Указывается путь к файлу со шрифтом для авторского знака. |
Минимальный размер фото для авторского знака (px) |
WATERMARK_MIN_PICTURE_SIZE |
Указывается минимальный размер фото, на которых будет нанесен авторский знак в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения. На фотографии меньшего размера знак добавлен не будет. |
Размещение авторского знака |
WATERMARK_POSITION |
Указывается область размещения авторского знака на фото:
- Сверху слева (tl);
- Сверху по центру (tc);
- Сверху справа (tr);
- Cлева (ml);
- По центру (mc);
- Cправа (mr);
- Снизу cлева (bl);
- Снизу по центру (bc);
- Снизу cправа (br).
|
Прозрачность авторского знака |
WATERMARK_TRANSPARENCY |
Задается величина прозрачности авторского знака (в %). |
Текст надписи |
WATERMARK_TEXT |
Задается текст авторского знака. |
Цвет надписи (без #, например, FF00EE) |
WATERMARK_COLOR |
Указывается шестнадцатеричный код цвета надписи без использования #. |
Размер надписи (% от размера картинки) |
WATERMARK_SIZE |
Задается размер надписи авторского знака в процентном соотношении от размера фото. |
Физический полный путь к картинке |
WATERMARK_FILE |
Указывается полный путь к картинке для авторского знака. |
Расположение картинки на фото |
WATERMARK_FILE_ORDER |
Указывается тип расположения картинки авторского знака на фото. |
|
Эскиз фотографии |
Размер фотографии (px) |
THUMBNAIL_SIZE |
Указывается размер картинки-анонса альбома в пикселях (px). Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения. |
Качество загружаемой фотографии (%) |
JPEG_QUALITY1 |
Указывается качество фотографии-анонса в процентах (%). |
Фотография |
Обязательно ограничивать размер оригинала (px) (при значении 0 ограничение не происходит) |
ORIGINAL_SIZE |
Задается размер оригинала фотографии в пикселях. Фотография будет уменьшена до указанной величины. Если указано значение 0, то изменение размера не происходит.
Размер задается для одной стороны картинки, вторая будет высчитана пропорционально для загружаемого изображения. |
Давать возможность пользователю выбирать размер загружаемых фотографий |
P_SHOW_RESIZER |
Разрешать пользователю выбирать размер загружаемых фотографий.
Параметр устарел с версии 15.0.0. |
Качество загружаемой фотографии (%) |
JPEG_QUALITY |
Указывается качество загружаемой фотографии в процентах (%). |
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:photogallery.upload","",Array(
"SHOW_TAGS" => "Y",
"USE_LIGHT_TEMPLATE" => "Y",
"SHOW_WATERMARK" => "Y",
"WATERMARK_COLORS" => array(),
"IBLOCK_TYPE" => "photos",
"IBLOCK_ID" => "23",
"SECTION_ID" => $_REQUEST["SECTION_ID"],
"INDEX_URL" => "index.php",
"SECTION_URL" => "section.php?SECTION_ID=#SECTION_ID#",
"UPLOAD_MAX_FILE_SIZE" => "7",
"ADDITIONAL_SIGHTS" => array(),
"MODERATION" => "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",
"ALBUM_PHOTO_THUMBS_WIDTH" => "120",
"THUMBS_SIZE" => "250",
"JPEG_QUALITY1" => "95",
"PREVIEW_SIZE" => "600",
"JPEG_QUALITY2" => "95",
"ORIGINAL_SIZE" => "0",
"JPEG_QUALITY" => "90",
"SET_TITLE" => "Y"
),
);?>
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.