Bitrix API. Вставка на страницу встроенного редактора картинок

В CMS Bitrix имеется довольно неплохой по функциональным возможностям и дизайну встроенный графический редактор картинок.

Поэтому может возникнуть желании использовать его на сайте. Но как это сделать? На самом деле это не так сложно. Класс компонента графического редактора является \Bitrix\Main\UI\FileInput и располагается в файле /bitrix/modules/main/lib/ui/fileinput.php

Для вывода кода компонента необходимо создать экземляр класс с помощью статического метода createInstance. Затем получить код на вывод через метод show. Полный код вызова компонента будет иметь следующий вид:

<?=\Bitrix\Main\UI\FileInput::createInstance([
	"name" => "picture",
	"description" => true,
	"upload" => true,
	"allowUpload" => "I",
	"medialib" => true,
	"fileDialog" => true,
	"cloud" => true,
	"delete" => true,
	"maxCount" => 1
	])->show($id);
?>

Переменная $id содержит идентификатор картинки в системе.

Параметры:

• name – задаёт параметр формы, в котором будут переданы данные файла;
• description – можно ли задавать описание к файлу;
• upload – можно ли загружать файл;
• allowUpload – какой тип файлов разрешён к загрузке (F – файлы, I – картинки, A – все типы, по умолчанию);
• allowUploadExt – какие типы расширений разрешены к загрузке (*.zip,*.rar,*.doc и пр.);
• medialib – можно ли использовать медиа-библиотеку;
• fileDialog – разрешён ли файловый диалог для загрузки;
• cloud – использовать ли модуль облачного хранилища для загрузки файлов;
• delete – можно ли удалять картинку;
• edit – можно ли редактировать картинку:
• maxCount – максимальное количество файлов;
• maxSize – максимальный размер файла (байт).

Также необходимо учитывать, что некоторые параметры будут работать только при определённых условиях, как, например, medialib и cloud.