Настройка клиента¶
elFinder может быть настроен несколькими способами:
1. при инициализации:
1 $(selector).elfinder({
2 option1: value1,
3 option2: value2
4 })2. до инициализации и после подключения файлов elFinder (можно переопределить все параметры):
1 var opts = {
2 option1: value1,
3 option2: value2,
4 option3: value3
5 }
6 elFinder.prototype.options = $.extend({}, elFinder.prototype.options, opts)1 elFinder.prototype.options.option1 = value1;Опции¶
| Параметр | Тип | Описание |
|---|---|---|
| url | String | URL коннектора. Единственный обязательный параметр |
| lang | String | Язык интерфейса. Требует подключения файла js/i18n/elfinder.LANG.js, где LANG двухбуквенное обозначения языка, например ru |
| cssClass | String | Дополнительный CSS класс для контейнера |
| wrap | Integer | Кол-во символов на которые разбивается длинные имена файлов в режиме отображения "иконки". По умолчанию - 14. Не разбивать имена файлов - 0 |
| places | String | Название папки "избранное". Локализуется. По умолчанию - Places. Укажите пустую строку "", чтобы отключить "избранное" |
| placesFirst | Boolean | Поместить "избранное" перед деревом файлов в панели навигации? По умолчанию - true |
| editorCallback | Function или null | Функция обратного вызова для WYSIWYG редактора (CKEditor, TinyMCE, elRTE и тд). Получает один аргумент (String) - URL выбранного файла |
| cutURL | String | указывает какую подстроку от начала URL файла необходимо отрезать до передачи значения в editorCallback. Может содержать часть урла, пустую строку или ключевое слово root - отрезать корневой URL |
| closeOnEditorCallback | Boolean | Закрыть elFinder после вызова editorCallback? По умолчанию - true. (бессмыслено для CKEditor, TinyMCE) |
| view | String | Внешний вид текущей директории по умолчанию. Возможные значения: icons, list. По умолчанию - icons |
| width | Integer или String | Ширина окна файлового менеджера. По умолчанию не задана, ширина указана в CSS файле source:src/css/elfinder.css |
| height | Integer | Высота окна файлового менеджера. По умолчанию не задана, возможно указать в CSS |
| disableShortcuts | Boolean | Отключить сочетания клавиш (кроме стрелок и пробела). По умолчанию - false |
| rememberLastDir | Boolean | Открывать последнюю посещенную директорию после перезагрузки страницы или закрытии/открытии браузера |
| cookie | Object | Параметры cookie (вид текущей директории, последняя открытая директория, "избраное"). По умолчанию - {expires : 30, domain : '', path : '/', secure : false} |
| toolbar | Array | Группы кнопок на панели инструментов. По умолчанию - все доступные кнопки/команды. Для настройки - см соответствующий раздел документации |
| contextmenu | Object | Содержимое контекстного меню. По умолчанию - все доступные команды. Для настройки - см соответствующий раздел документации |
| dialog | Object | Опции диалогового окна jQueryUI dialog, в котором будет открыт elFinder. Если опция docked == true - elFinder будет открыт на странице с возможностью "отстегивания" в диалоговое окно с указаными параметрами |
| docked | Boolean | Разрешить "отстегивание" elFinder в диалоговое окно (может упоминаться в документации, как docked mode) |
| autoReload | Integer | Количество минут, через которое содержимое текущей директории и дерева директории обновляется. По умолчанию - 0 (отключено) |
Панель инструментов¶
По умолчанию на панели инструментов включены все кнопки/команды. Если команда отключена в коннекторе, оне не будет показана в панели инструментов даже если указана в конфиге клиента.
Опция toolbar (Array) - двухмерный массив. Первый уровень - группы кнопок, визуально разделенные на панели инструментов. Второй - кнопки внутри группы. Группы кнопок и кнопки внутри группы будут отрисованы в порядке, указаном в конфиге.
Список всех доступных кнопок: back, reload, open, select, quicklook, info, rename, copy, cut, paste, rm, mkdir, mkfile, upload, duplicate, edit, archive, extract, resize, icons, list, help.
Пример:
1 $(selector).elfinder({
2 toolbar : [
3 ['back', 'reload'],
4 ['select', 'open'],
5 ['mkdir', 'mkfile', 'upload']
6 ],
7 ...
8 })
Контекстное меню¶
За контекстное отвечает опция contextmenu (Object).
Пример:
1 $(selector).elfinder({
2 contextmenu : {
3 // Команды, исполняемые для текущей директории
4 cwd : ['reload', 'delim', 'mkdir', 'mkfile', 'upload', 'delim', 'paste', 'delim', 'info'],
5 // Команды для одного выбраного файла
6 file : ['select', 'open', 'delim', 'copy', 'cut', 'rm', 'delim', 'duplicate', 'rename'],
7 // команды для группы файлов
8 group : ['copy', 'cut', 'rm', 'delim', 'archive', 'extract', 'delim', 'info']
9 },
10 ...
11 })