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

Фото (загрузка)


Описание 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"
	),
);?>


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

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

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

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

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