skolmarketing/ifm

Improved File Manager

IFM - improved file manager

This is a simple filemanager. It is a single file solution which uses HTML5, CSS3, JavaScript and PHP. It works like a client-server system where HTML5/CSS3/JavaScript is the client part and the PHP API acts as the server, which reduces the traffic significant. The IFM comes with a embedded Version of jQuery and ACE Editor.

requirements

Client

• HTML5 and CSS3 compatible browser
• activated JavaScript

Server

• = PHP 5.5 (only if using auth; if not PHP 5.4 works either)

• optional: cURL extention (for remote upload)

issues

Currently there are no known issues.

screenshot

installation

Just copy this ifm.php to your webspace - thats all :)

configuration

The configuration is located at the top of the script in a separate configuration class. The options in the class are commented and named laconically. If you have questions anyway write me an email.

authentication

Meanwhile I added a super simple authentication feature using the configuration keys auth and auth_source. You can configure it like this:

    "auth" => 1,
    "auth_source" => 'inline;<username>:<password_hash>',

In the example above the user and password are declared inline. You can also use a file (which should lie out of the $DocumentRoot of the webserver):

	"auth_source" => 'file;/path/to/file',

The file should contain ONLY ONE LINE:

<username>:<password_hash>

The password hash has to be a hash generated by PHPs password_hash() function. The default credentials are "admin:admin".

security information

The IFM was developed with the assumption that the highest level of operation is the scripts base location. So it is neither possible to nagivate nor to use any API function in a level above the script root.

It is highly recommended to restrict access to the script e.g. using a basic authentication.

references

I used some nice free icons in my script which I want to mention here:

• file icons: Free file icons by Teambox
• other icons: Mono icons from tutorial9.net