FileGator v2.4

Powerful PHP File-Manager and AJAX Uploader

Created: 09/19/2012
latest Update: 04/19/2013
By: alcalbg
Email: info@file-gator.com

What is FileGator?

FileGator is Powerful PHP File-Manager and AJAX Uploader.

For more info please visit gator's web page www.file-gator.com

Liability

We cannot guarantee that this software will run in every environment or together with any other application, without producing errors. Any liability for damage of any sort is hereby denied. You are solely responsible for your files, server and data

Please evaluate this software with non-critical data before use.

Copyright

Designed & developed by alcalbg. Logo design by batabarata.

This software uses open-source plugins blueimp, foundation, lightbox and jquery.

Features

Main Features:

Upload multiple files with Ajax and manage them online
Copy, move, rename, create, edit or delete online files and folders
Create archives with zip or unzip and decompress files online
Hierarchical Treeview
Search files and folders
Preview images in gallery mode
Multiple user accounts + guest account
Adjustable read/write/upload permissions for each user
Home directories for each user or default directory if not specified
Admin interface for user management
Nice user-friendly fluid interface
No database required, flash free
Highly configurable

Main Screen Explained:

1. - Sign in / Sign out links

2. - Upload one or more Files. Or you can drag&drop into the browser but not in IE

3. - Create new Folder or create new File

4. - Preview images (only active on folders with images), open Tree view and Filter Files by filename options

5. - File properties and options (download, rename, unzip, edit)

6. - Go back to parent folder

7. - Sort Files and invert sort

8a. - Select Files and Folders

8b. - Copy, Move, Delete or Zip selected Files and Folders

Installation

The installation of FileGator is very simple:

- Copy all files to your server using FTP or similar tool

- Point your browser to filegator folder (example: http://yourserver.com/filegator)

- Sign in as admin/admin123 to admin interface (username: admin password: admin123)

- Change admin password by clicking on gears icon next to admin account

- Create one or more user accounts

- Sign out of admin interface and Sign in as regular user to test filegator

Additional Notes:

- Beware who you give access and writing permissions since users can gain full acces to your server. You are solely responsible for your files, server and data.

- Make sure you have minimum PHP 5.2 on you server

- Make sure Apache service has read/write access to the repository folder(s). Consult your system administrator about this.

- Current .htaccess file inside repository directory will prevent script and html execution inside that directory. You may need to adjust this to fit your needs.

This is the actual .htaccess content.

#
# secure directory by disabling script and html execution
#

AddHandler cgi-script .php .pl .py .jsp .asp .htm .html .xhtml .shtml .sh .cgi
Options -ExecCGI

Configuring FileGator

You can set all configuration options by editing the index.php file.

All configuration options begins with explanation so read them carefully.

Configuration options are inside single array so you must be careful not to break the array structure. Some options can include sub-arrays.

NOTE: You may need to logout/login for some changes to take effect

Here is a full set of default configuration options:

$config = array(

// user config storage file
'user_config_file' => getcwd().'/config/config.json',

// main file repository
// this is also a repository for users without specific homedir
// you'll need to make sure your webserver can write here
'repository' => getcwd().'/repository',

// mask directories up to the main file repository (true/false)
// set this to true if you don't want to use full path iside admin area
'mask_repository_path' => false,

// allow guest account (true/false)
'allow_guests' => false,

// allow clickable links on files (true/false)
// set to false if repository is not inside server's public directory
'allow_file_links' => true,

// use lightbox plugin to preview images (true/false)
// this also enables allow_file_links
'use_lightbox_gallery' => true,

// accepted file types when uploading or '*' for no restrictions
// example: 'accept_file_extensions' => array('gif','jpg','jpeg','png'),
'accept_file_extensions' => array('*'),

// max number of files on batch upload
'max_files' => 100,

// maximum file size in bytes when uploading
// The php.ini settings upload_max_filesize and post_max_size
// take precedence over the following setting
'max_filesize' => 2097152, // 2MB

// time/date format - see php date()
'time_format' => 'd/m/y',

// use simple copy-move instead of cut-copy-paste (true/false)
'simple_copy_move' => true,

// use zip functions (true/false)
// zip extension must be enabled on server (see http://php.net/manual/en/book.zip.php)
'use_zip' => true,

// files can be edited (true/false)
'allow_edit_files' => true,

// files/folders can be renamed (true/false)
'allow_rename_files' => true,

// show top-bar (true/false)
'show_top_auth_bar' => true,

// users can change their password (true/false)
'allow_change_password' => false,

// this restricted files will be hidden (no wildcards)
'restricted_files' => array('.htaccess'),

// encrypt url actions (true/false)
'encrypt_url_actions' => false,

// allow links to be sent via email (true/false)
'allow_email_links' => false,
'mail_subject' => 'File for you',

// Use goo.gl URL shortener (true/false). This requires cURL php support.
'use_googl_shorturl' => false,
// get goo.gl API key from: http://code.google.com/apis/console/
'googl_shorturl_api_key' => '123456789',

// use advanced smtp mail protocol (true/false)
'use_smtp_protocol' => false,
'mail_smtp_from' => 'info@example.com',
'mail_smtp_from_name' => 'info',
'mail_smtp_host' => 'smtp.example.com:25',
'mail_smtp_username' => 'info@example.com',
'mail_smtp_password' => 'mypassword',
'mail_smtp_connection_security' => 'tls', // 'tls', 'ssl' or '' for no security
'mail_smtp_debug' => false,

// use authentication module (true/false)
// WARNING: if you set this to false anyone can see, change or delete your files without need to login
// this will also disable encrypt_url_actions
'use_auth' => true,

// server url and base path, usually you don't need to change this
'base_url' => 'http://'.$_SERVER['HTTP_HOST'].dirname($_SERVER['PHP_SELF']),
'base_path' => getcwd(),

// write user actions to usage.log file (true/false)
'write_log' => false,


);

Compatibility

FileGator is tested and found compatibile with:

Browsers

Microsoft Internet Explorer version 7, 8 and 9
Firefox
Google Chrome
Safari

Server Versions

Minimum PHP 5.2 + Apache2

Operating Systems

Windows (Tested with NTFS / Windows NT 6.1 build 7600 aka Windows 7)
Linux (CentOS 2.6)

(Tested on x86 and x86_64 platforms)

FAQ

How can I increase maximum upload file size?

This is controlled by web server and PHP settings inside php.ini file.

Follow these steps to increase maximum upload file size to 200MB:

1. Locate your php.ini file. On windows look into c:/Program Files/php/ or c:/xampp/apache/bin/ or simply search for php.ini. Sometimes there are two or more php.ini files (on some xampp installations) so you must figure out which one is used.

2. Inside php.ini file set parameters to something similar:

upload_max_filesize = 200M ;this is 200 Megabytes
post_max_size = 205M ;this must be greater then upload_max_filesize

3. Restart your web server to apply new settings. Don’t forget this!

4. Change FileGator index.php config file around line 78:

'max_filesize' => 209715200, // This is 200 Megabytes

5. Refresh page in your browser and you’re done.

Here is a good link to explain this more deeply.

http://www.radinks.com/upload/config.php

Note: If you don’t have your own server consult your hosting provider about this.

Changelog

Version 2.3 (02/21/2013)

ADDED: filter files by filename
ADDED: preview images
FIXED: minox bug-fix
CHANGED: documentation updated

Version 2.2 (11/23/2012)

FIXED: security update for .htaccess file (thanks to ne03)
FIXED: minor bug-fix
CHANGED: documentation updated

Version 2.1 (11/20/2012)

ADDED: option for sending links to email via php mail() or smtp protocol
ADDED: masking options for main file repository enabling short path in admin area
FIXED: minor bug-fix
CHANGED: documentation updated

Version 2.0 (10/16/2012)

ADDED: admin interface added to administer user accounts, passwords and permissions
ADDED: config file added filegator/config/config.json
ADDED: new config option user_config_file
CHANGED: passwords changed from plain text to MD5 crypted
FIXED: minor bug-fix - notice on create new folder/file on blank input field
REMOVED: config option removed: users array; 
REMOVED: config option removed: flush_url_on_chdir (set to never flush)
MOVED: config options encryption_salt changed and moved to file-gator.php->validateConf()
MOVED: config option new_dir_mode moved to file-gator.php->validateConf()
CHANGED: documentation updated

Version 1.1 (10/08/2012)

FIXED: bug with file names containing multiple spaces fixed
CHANGED: default config values changed to:
 'accept_file_extensions' => array('*'),
 'encrypt_filenames' => false,
FIXED: Minor bug causing PHP Notice fixed
FIXED: JavaScript fix on treeview
CHANGED: documentation updated

Version 1.0 (09/18/2012)

launched v1.0