Skip to content
/ fm2 Public
forked from simogeo/Filemanager

An open-source file manager released under MIT license. Up-to-date for use with nodejs, but under HEAVY development, so expect rapid changes until we reach a working state. Currently at verion 2.4.0-alpha. Contributions and / or donations are welcome!

Notifications You must be signed in to change notification settings

jlaustill/fm2

 
 

Repository files navigation

Build Status Filemanager

FM2 is an open-source file manager released under MIT license. It is an alternative to elfinder or CKFinder.

Support

FM2 is under free license. If you want to support the filemanager development or just thank its main maintainer by paying for a glass of whiskey, you can make a donation by clicking the following button : Donate

Main features 2.0

  • completely rewritten from scratch using 1.0 as a blueprint. simogeo did such a wonderful job with this filemanagers visual appearance, why mess with a good thing?
  • All libraries updated to newest, jquery 3, dropzone 4.3, and jquery.splitter 0.23
  • Now based on Bootstrap 3
  • MVVM architecture with Knockoutjs 3.4.0
  • Fancy Tree replaces jquery.filetree
  • Sweetalert replaces jquery.impromptu
  • toastr replaces alerts
  • Bundled with Browserify, built with gulp
  • api and ui seperate

2.0 Future roadmap

  • jquery extension $.fm2() instead of iframes
  • spotlight like search
  • drag and drop
  • in place file editing
  • same great themes
  • same great language support

Screenshot

Current state as of version 2.4.0-alpha15 Filemanager-2.0 V2.0.3 Screenshot

Documentation

Filemanager is highly documented on the wiki pages.

Installation and Setup

Preamble

Since many changes have been done recently, only a Node.js api is available. Previous connectors will NOT work, promise 100%. I have standardized the api to JSON API 1.0 standards. I hope to work with other developers to bring at least asp.net and php on board.

To use other connectors, please download v0.8 version from the original filemanager https://github.com/simogeo/Filemanager/archive/v0.8.zip (PHP, ASHX, ASP, CFM, lasso, PL and JSP connectors are available)


Install fm2 with bower

bower install fm2#2.4.0-alpha15

It will install into bower_components/fm2 by default unless you have bower configured to install elsewhere.

(2) Make a copy of the default configuration file ("fm2.ui.config.default.json" located in the dist/config directory), removing the '.default' from the end of the filename, and edit the options according to the following wiki page : https://github.com/jlaustill/fm2/wiki/Filemanager-configuration-file

I have not testeg FCKEditor, please give me feedback if you do

(3a) If you are integrating the FileManager with FCKEditor, open your fckconfig.js file and find the lines which specify what file browser to use for images, links, etc. Look toward the bottom of the file. You will need to change lines such as this:

FCKConfig.ImageBrowser = false ;
FCKConfig.ImageBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Image&Connector=../../connectors/' + _FileBrowserLanguage + '/connector.' + _FileBrowserExtension ;

...to this:

FCKConfig.ImageBrowser = true ;
FCKConfig.ImageBrowserURL = '[Path to Filemanager]/index.html' ;

I have not tested CKEditor, please give me feedback if you do

(3b) If you are integrating the FileManager with CKEditor 3.x or higher, simply set the URL when you configure your instance, like so:

CKEDITOR.replace('instancename', {
	filebrowserBrowseUrl: '[Path to Filemanager]/index.html',
	...other configuration options...
});

If you want to use the modal dialog mode (instead of pop-up), please refer to the dedicated wiki page.

(3c) If you are integrating the FileManager with TinyMCE (>= 3.0), you should:

Create a Javascript callback function that will open the FileManager index.html base page (see URL below for examples) Add a line like: "file_browser_callback : 'name_of_callback_function'" in the tinyMCE.init command See http://www.tinymce.com/wiki.php/TinyMCE3x:How-to_implement_a_custom_file_browser for more details.

See also the dedicated wiki page, with TinyMCE 4 sample : https://github.com/jlaustill/Filemanager/wiki/How-to-use-the-Filemanager-with-tinyMCE--3-or-4-%3F

License

License: MIT

Contact

Joshua Austill

Find me on my blog, there's links to my twitter etc etc.

About

An open-source file manager released under MIT license. Up-to-date for use with nodejs, but under HEAVY development, so expect rapid changes until we reach a working state. Currently at verion 2.4.0-alpha. Contributions and / or donations are welcome!

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 86.2%
  • HTML 8.6%
  • Python 2.8%
  • CSS 2.4%