elFinder

      _ ______ _           _           
     | |  ____(_)         | |          
  ___| | |__   _ _ __   __| | ___ _ __ 
 / _ \ |  __| | | '_ \ / _` |/ _ \ '__|
|  __/ | |    | | | | | (_| |  __/ |   
 \___|_|_|    |_|_| |_|\__,_|\___|_|

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.

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.0-src - 2.0 development branch (Security fix only), auto build to 2.0 on commit
2.1 - 2.1 nightly build branch
2.0 - 2.0 nightly build branch

Features

2.0.x

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 volume storage drivers
Background file upload with Drag & Drop HTML5 support
List and Icons view
Keyboard shortcuts
Standard methods of file/group selection using mouse or keyboard
Move/Copy files with Drag & Drop
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 files
Easy to integrate with web editors (elRTE, CKEditor, TinyMCE)
Flexible configuration of access rights, upload file types, user interface and other
Extensibility
Simple client-server API based on JSON

2.1.x

More High performance server backend and light client UI
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.
Folder upload with Chrome
Chunked file upload
Upload directly to the folder
Upload form URL (or list)
Creating the archive by specifying the file name
Direct extraction to the current working directory (you do not want to create a folder)
Supports Dropbox.com© (Configurable & As network volume)
Supports custom information in info dialog
Configuable columns of list view
Supports custom CSS class function of tree view
For more details, see the Changelog

Requirements

jQuery / jQuery UI

jQuery 1.8.0+
jQuery UI 1.9.0+

However, we recommend newest version.

Client

Modern browser. elFinder was tested in Firefox 12, Internet Explorer 8+, Safari 6, Opera 12 and Chrome 19

Server

Any web server
PHP 5.2+ (Recommend PHP 5.4 or higher) And for thumbnails - GD / Imagick module / convert(imagemagick) require

Installation

Builds (compressed)

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

Source (uncompressed)

Clone this repository to your PHP server

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

Rename /php/connector.minimal.php-dist to /php/connector.minimal.php
Load /elfinder.src.html in your browser to run elFinder

Installer

Setup elFinder 2.1.x nightly with Composer

Downloads

Stable releases (Changelog)

Nightly builds

Demo sites

2.1.x Nightly

2.0

http://elfinder.org/ (rc1)
http://hypweb.net/elFinder-nightly/demo/2.0/ (2.0.x Nightly)

FAQs

Which version of elFinder should I use?

2.0.x if you do not need 2.1 of the advanced features.
2.1.x if you want to try the experimental (bleeding edge, but API 2.1 connector is PHP only). It is also available from the connector on the API 1.x and 2.0.

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.

3rd party connectors

3rd party Volume Drivers

League\Flysystem (PHP) (for elFinder 2.1+)

3rd party Themes

Support

Authors

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

We hope our tools will be helpful for you.

License

elFinder is issued under a 3-clauses BSD license.

Copyright (c) 2009-2016, Studio 42
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the Studio 42 Ltd. nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL "STUDIO 42" BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

tqsq2005 / elfinder Goto Github PK

elfinder's Introduction