studio-42 / elfinder

📁 Open-source file manager for web, written in JavaScript using jQuery and jQuery UI

elFinder

WARNING: IF YOU HAVE OLDER (IN PARTICULAR 2.1.62 OR EARLIER) VERSIONS OF ELFINDER ON PUBLIC SERVERS, IT MAY CAUSE SERIOUS DAMAGE TO YOUR SERVER AND VISITED USER. YOU SHOULD UPDATE TO THE LATEST VERSION OR REMOVE IT FROM THE SERVER.

elFinder is an open-source file manager for web, written in JavaScript using jQuery UI. Creation is inspired by simplicity and convenience of Finder program used in Mac OS X operating system.

Contents

• Branches
• Features
• Requirements
• Installation
• Downloads
• Demo Sites
• FAQs
• 3rd Party Connectors
• 3rd Party Volume Drivers
• 3rd Party Themes
• Support
• Authors
• License

Branches

• master - Main development branch
• 2.1-src - 2.1 development branch, auto build to 2.1 on commit
• 2.1 - 2.1 nightly build branch

Features

• Usability like the MacOS Finder or Windows Explorer
• Mobile friendly view for touch devices
• All operations with files and folders on a remote server (copy, move, upload, create folder/file, rename, etc.)
• High performance server backend and light client UI
• Multi-root support
• Local file system, MySQL, FTP, SFTP, Box, Dropbox, GoogleDrive and OneDrive volume storage drivers
• Support AWS S3, Azure, Digital Ocean Spaces and more with League\Flysystem Flysystem driver
• Cloud storage (Box, Dropbox, GoogleDrive and OneDrive) drivers
• Background file/folder upload with Drag & Drop HTML5 support
• Chunked file upload for large file
• Upload directly to the folder
• Upload form URL (or list)
• List and Icons view
• Keyboard shortcuts
• Standard methods of file/group selection using mouse or keyboard
• Move/Copy files with Drag & Drop
• Drag & Drop to outside by starting drag with alt/option key press
• Archives create/extract (zip, rar, 7z, tar, gzip, bzip2)
• Rich context menu and toolbar
• Quicklook, preview for common file types
• Edit text files and images
• "Places" for your favorites
• Calculate directory sizes
• Thumbnails for image, movie files
• Easy to integrate with web editors (elRTE, CKEditor, TinyMCE)
• Flexible configuration of access rights, upload file types, user interface and other
• Extensibility by event handling of backend and client side
• Simple client-server API based on JSON
• Supports custom information in info dialog
• Configuable columns of list view
• Supports custom CSS class function for the custom folder icon
• Connector plugin
  • AutoRotate : Auto rotation on file upload of JPEG file by EXIF Orientation.
  • AutoResize : Auto resize on file upload.
  • Normalizer : UTF-8 Normalizer of file-name and file-path etc.
  • Sanitizer : Sanitizer of file-name and file-path etc.
  • Watermark : Print watermark on file upload.
• For more details, see the Changelog

Requirements

jQuery / jQuery UI

• jQuery 1.8.0+
• jQuery UI 1.9.0+
  • Required: draggable, droppable, resizable, selectable, button and slider
  • Recommend: sorter (To make sortable the List column and the Places)

However, we recommend newest version.

Client

• Modern browsers both of desktop or mobile. elFinder was tested in newest Chrome, Edge, Firefox, IE and Opera
  • Caution: Web App mode ("apple-mobile-web-app-capable" meta tag) on iOS is not work perfectly in elFinder

Server

• Any web server
• PHP 5.2+ (Recommend PHP 5.4 or higher) And for thumbnails - GD / Imagick module / convert(imagemagick) require
  • Recommend PHP 7.1 or higher to supports non-ASCII character of file path/name on the Windows server

Installation

Builds (compressed)

1. Download and unzip one of the builds below to your PHP server
2. Rename /php/connector.minimal.php-dist to /php/connector.minimal.php
3. Load /elfinder.html in your browser to run elFinder

Source (uncompressed)

1. Clone this repository to your PHP server

   $ git clone https://github.com/Studio-42/elFinder.git
   

2. Rename /php/connector.minimal.php-dist to /php/connector.minimal.php

3. Load /elfinder.src.html in your browser to run elFinder

Installer

• Setup elFinder 2.1.x nightly with Composer

Downloads

Stable releases (Changelog)

• elFinder 2.1.65
• elFinder 2.0.9 (deprecated)

Nightly builds

• elFinder 2.1.x (Nightly)

Demo sites

2.1.x Nightly

• https://studio-42.github.io/elFinder/ (with CORS)

FAQs

Should I use elFinder builds (compressed) or source (uncompressed)?

For debugging and development, use the source. For production, use builds.

How do I integrate elFinder with CKEditor/TinyMCE/elRTE/etc...?

Check out the wiki for individual instructions.

The procedure of language files created or modified?

You can create or modify the language file to use translation tool. Please refer to the pull request the results to the respective branch.

• 2.1 branch translation tool

3rd party connectors

• ASP.NET / ASP.NET Core / .NET Standard
• Java Servlet
• JavaScript/Efw
• Nodejs
• Python
• Ruby/Rails

3rd party Volume Drivers

• League\Flysystem (PHP) (for elFinder 2.1+) driver for the Flysystem

3rd party Themes

Hint: How to load CSS with RequireJS?

• lokothodida/elfinder-theme-moono
• lokothodida/elfinder-theme-windows-10
• RobiNN1/elFinder-Material-Theme
• StudioJunkyard/elfinder-boostrap-theme

3rd party Integrations

• Django
• Drupal
• Laravel
• Roundcube
• Symfony
• Tiki Wiki
• WordPress
• XOOPS
• XOOPSCube GUI-based control panel: FTP, cloud storage and editors
• Yii
• Zenphoto

Support

• Homepage
• Wiki
• Issues
• [email protected]

Authors

• Current main developer: Naoki Sawada [email protected]
• Chief developer: Dmitry "dio" Levashov [email protected]
• Maintainer: Troex Nevelin [email protected]
• Developers: Alexey Sukhotin, Naoki Sawada [email protected]
• Icons: PixelMixer, Yusuke Kamiyamane, Icons8

We hope our tools will be helpful for you.

License

elFinder is issued under a 3-clauses BSD license.

• License terms

elfinder's Issues

Директория для thumbnails

При изменении в коннекторе опции (директории для превью) 'tmbURL' с .tmb на какую-либо другую всё равно создаётся директория .tmb и превью записываются в неё, но в файловом редакторе превью уже не отображается (видимо редактор пытается их найти уже в новой папке указанной в настройках)

Прокрутка списка файлов / Scrollbar not working in cwd

Не работает прокрутка списка файлов ползунком в браузере Google Chrome 12, а в браузере Opera 11.5 при клике на ползунок включается выделение файлов...

elfinder.min.css breaks icons in ie8

But elfinder.full.css - not

Increase controls scale would lead improved usability

All buttons/elements are too small...

F2 shortcut for rename

In linux/windows F2 should call rename

Ресайз основого окна

При ресайзе окна строка статусбара переносится вверх.
Opera 11.50

Client and Connector options describe

https://github.com/Studio-42/elFinder/wiki/Client-configuration-options (update needed)

https://github.com/Studio-42/elFinder/wiki/Connector-configuration-options (missing yet)

elFinderSupportVer1.js is missing in build

build system cannot copy this file due to missing js/proxy

move python connector to separate github project

subj

in default packaging connector should set 'URL' relative to 'path'

this will allow thumbnails to work out of the box

multiple same file property window

открываются множество окошек со свойствами одного и того же файла.
смысла в этом нет, а при тормозном сервере, человек может понажимать несколько раз и вылезет куча окошкек.
http://img89.imageshack.us/img89/1826/multiplepropertywindows.png

Unable to delete 100 files at once - 414 Request-URI Too Large

I have selected 100 files and tried to delete them server responded with 414 error.
Maybe split delete requests or use post instead?

Display file name in statusbar when only one file selected

Now displays

selected items: 1, size: 444 Kb

Should show:

'putty.exe' selected, size: 444 Kb

Selecting multiple files is ok

Don't create folder with name 0 (zero)

При попытке создать папку с именем 0 (ноль) появляется сообщение:

Invalid parameters for command "mkdir".

scrollbar not working on Chrome

The scrollbar on the right does not work on google chrome.
On firefox, they work but a selection box appears in the background.

Resize images

I think it lacks the command reduce / resize jpg file

selection and scroll issues

1. when select some files and scroll list - selection disappear
2. when select files, scroll not working - ie cant select files outside of filed view

'untitled folder' and 'untitled file.txt' should be i18n

Default template of new file/folder name should be in i18n and on new file with ru locale should offer новый фалй.txt

[Windows] If set parameter URL - files don't open (Error 404: Not Found)

Тестирую на ОС Windows (т.е предопределенная константа - DIRECTORY_SEPARATOR равна \ (обратному слэшу)

Устанавливаю в параметр URL адрес своего сайта:

// root url, not set to disable sending URL to client (replacement for old "fileURL" option)  
'URL'  => 'http://test.ru',   

При попытке открыть файл, допустим /elfinder/js/elfinder.min.js (по двойному клику или через кнопку открыть) получаю ошибку:

Not Found

The requested URL /elfinder\js\elfinder.min.js was not found on this server.

В адресной строке при этом отображается следующий путь:

http://test.ru/elfinder%5Cjs%5Celfinder.min.js

Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr18.png

Если же вручную заменить %5C на обратный слэш () и перейти по получившемуся адресу, то всё открывается нормально
Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr19.png

multiple same file property window

открываются множество окошек со свойствами одного и того же файла.
смысла в этом нет, а при тормозном сервере, человек может понажимать несколько раз и вылезет куча окошкек.
http://img89.imageshack.us/img89/1826/multiplepropertywindows.png

Expand directory in tree when I enter it

Option to auto expand one more level down

div.elfinder-quicklook-info clears on volume change in QuickLook

Info about file just disappears after I change volume in quicklook with <audio> player in Chrome Linux.

Parameter copyOverwrite, rename folder

Устанвливаю:

// on paste file -  if true - old file will be replaced with new one, if false new file get name - original_name-number.ext
'copyOverwrite' => false

Затем делаю так:

Создаю три папки (пустые) c именами:

1
2
3

В папке 1 создаю папку 4, затем перемещаю (перетягиванием) папку 4 из папки 1 в папку 2, и получаю что папка 4 сама переименовывается в 4- (после названия папки добавляется дефис), после этого перемещаю папку 4- в папку 3, папка 4- опять переименовывается в 4-- (после названия папки добавляется ещё один дефис) и т.д с каждым перемещением папки 4 из папки в папку к ней добавляется дополнительный дефис...

P.S
Аналогичная ситуация если перемещать папку с помощью Вырезать - Вставить

P.P.S
Если таким же образом перемещать файл, то он перемещается нормально, без каких-либо переименований

possibility to create files that can't be deleted

in demo directory 42 have file 42 which itself is the symlink pointed on itseld
elFinder shows - can not delete - file not found.

I happy that one who used offense in demo not found it. :)

Undefined class constant 'ERROR_FILE_EXISTS' in elFinderVolumeDriver.class.php on line 1214

Create directory test and set root attributes to:

<?php
array(
    array(
        'pattern' => '/^\/test/',
        'write' => false,
        'read' => false,
        'hidden' => true,
        'locked' => true
    )
)

And try to create directory called test, results in PHP Fatal error: Undefined class constant 'ERROR_FILE_EXISTS' in elFinderVolumeDriver.class.php on line 1214

thumbnails should work without setting tmbPath and tmbURL by default

If tmbPath is in default setting .tmb then set tmbURL = URL + tmbPath

elFinderVolumeDriver.class.php around line 718

Неполный перевод

Отсутсвует перевод ошибок:

erMove и CerrCopyFrom

Скриншот:
http://i011.radikal.ru/1107/9e/f6403f0697b7.jpg

Remember 'Places' collapse/expand state

And Places should be off by default

Авто закрытие окна диалог (dialog)

В скачаном архиве, в примере (elfinder.src.html), если открыть файловый менеджер с помощью кнопки диалог (dialog), а затем попробывать открыть файл или папку с помощью двойного клика, то файловый менеджер закрывается (закрывается в Opera, FireFox, Chrome, в браузере IE 8 всё нормально)

Don't moved the file/folder with dot in the beginning

При попытке перенести файл/папку, имя которого начинается с точки, из папки в папку выскакивает окно с ошибкой, без указания ошибки:

Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr20.png

OS Windows

Позиция менеджера при открытии его в диалоге

Если попробовать расположить кнопку вызова диалога менеджера в нескольких прокрутках от начала страницы и нажать на неё, окно откроется выше на 1-2 разворота. Если после этого попробовать открыть любое изображение, оно откроется над кнопкой открытия диалога, то есть значительно ниже менеджера.

drag and drop directories

If drag and drop directory from filemanager to elfinder it stored as plain file instead of dir.

from konqueror , multiple files works fine
browser google-chrome 12.0.742.68 beta linux

Release 2.0

Close this issue when releasing 2.0 version

Disabled commands

При отключении комманд (я так понимаю это задумывалось как полное отключение данных команд, а не отключение только кнопок?):

// list of commands disabled on this root
'disabled' => array('rename','edit','upload','mkfile','mkdir','rm','cut','copy','duplicate')

Данные команды всё равно исполняются (хотя значки и выглядят как неактивные):

1. С помощью горячих клавиш
2. При клике правой кнопкой команды выглядят как активные
3. При отключении команды upload, команда (значок загрузки) выглядет как неактивная, но при клике на значок загрузки, открывается окно загрузки файла и файлы можно загрузить

Parametr copyJoin, delete files/folders

Устанавливаю параметр:

// if true - join new and old directories content on paste     
'copyJoin'        => false

Затем создаю папки и файлы следующей вложенности:

My Files
 |
 |---Papka-1
     |---file-1.txt
     |---Papka-1
         |---file-2.txt

Пытаюсь переместить вложенную папку Papka-1 (которая вложена в папку с таким же именем) в папку My Files
Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr14.png

Получаю уведомление что такая папка уже существует, соглашаюсь на замену, жму Yes
Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr15.png

И вот дальше получаю ошибку без какого-либо описания
Скриншот: http://dl.dropbox.com/u/6655338/elfinder/Scr16.png

После этого захожу в папку My Files --> Papka-1 а она пустая, там ничего нет, вложенная в неё папка (Papka-1) и файл (file-2.txt) сами удалились...

Cut + Paste in the same directory doesn't work correctly

When I try to cut and then paste a file in the same directory, it creates a copy of the file. (with a new name).

BACKSPACE key in root opens selected file/directory

Chrome browser.

BACKSPACE Should do nothing in root.

too small name edit field for long filenames in thumbnails view mode

may be expand field like in windows icon name edit?

keyboard events still fire after closing dialog in 1.2

I noticed that keyboard events still fire in 1.2 after closing down the dialog. This didn't happen in 1.1 . I'm trying to find the cause of the problem, and post it here if no-one else finds it before me.

no resize limit for `tree` and `cwd`

it should be limit in right same as in left - not close complete dir tree, and not close complete files list

PHP Fatal error: Undefined class constant 'ERROR_POST_DATA_MAXSIZE' in elFinderConnector.class.php

I've tried uploading file 15mb in size.

One problem is that connector does not count post_max_size option in config

my php config:

post_max_size = 8M
upload_max_filesize = 100M

elFinder returns in json that max upload size is 100M

notice on missing 'mime.types' file

Notice: Undefined variable: file in elFinderVolumeDriver.class.php on line 659

isset() check required

Delete folders from Places

Сделайте, пожалуйста, удаление папок из Избранного через "Правая кнопка мыши"-->"Удалить", а то не каждый сможет догадаться, что папки из "Избранного" удаляются перетягиванием (других вариантов удаления я, вроде, не нашел)

file elfinder.quicklook.jplayer.js absent from version 2 sources

path extensions/jplayer/elfinder.quicklook.jplayer.js

[Right click] Add sort menu files/folders

Очень не хватает сортировки, предлагаю добавить выпадающее меню (по аналогии с созданием архивов) с выбором типа сортировки файлов/папок при правом клике мышью

find file string

Don't work backspace and delete buttons in the search field (Chrome)

root folder(s) should be expanded by default

When elFinder load it should expand the root folder in tree view

scrollbar

scrollbar in directory list can't be moved by mouse, rectangular select appear instead
Browser google-chrome 12.0.742.68 beta

Default mkdir mode should be 755, and file 644

It will be more secure by default

Release 2.1

Close this issue when releasing 2.0 version