Frequently Asked Questions

There is a simple variable in FileGator called max_filesize but this will only work within your server limits. If you need to increase server limits see below...

Maximum file upload size is controlled by your 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's configuration.php file around line 46:

'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.

uploadlimits.txt

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

If you’re stuck with your server’s config you can enable ‘upload in smaller chunks’ feature as described below

* On some servers you must increase max_execution_time inside php.ini as well

** On Microsoft IIS requestFiltering settings can sometimes block large file uploads

*** For Nginx servers adjust client_max_body_size value in the http{} context

**** Apache 1.3.x or 2.0.x cannot work above the 2.0GB file limit, as this is something the webserver itself cannot handle due to 32bit register limits. Apache 2.2.x has changed this by using 64bit file registers so you must upgrade to that in order to handle >2GB files. Your LimitRequestBody should also be set to 0 (unlimited) after upgrading or you'll see 413 error.

***** File size is represented as integer value and the size of php ints is platform dependent, in other words files that are above 2GB can show inaccurate file size on some 32bit systems, windows php installations, 32bit php builds etc.

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported!

Yes, you can activate that feature by editing 3 files:

maxChunkSize: 50000,
            

'discard_aborted_uploads' => false,
            

gator::error('Config param max_filesize is bigger than php server setting: post_max_size = '.$php_post_max_size.', upload_max_filesize = '.$php_upload_max_filesize);
            

Clear browser’s cache and you are ready to go. Note that upload in chunks is not available in Microsoft Internet Explorer.

Absolutely, you can create two (or more) different users on the same folder, one with full permissions and other with read&upload permissions for example.

Even better, you can create one user with full permissions and within this user’s home folder create other users each having one subfolder as a home, this way first user will act as superuser and he can see folders of other users while others cannot go up to superuser folder. See example:

/filegator/repository/
/filegator/repository/john/
/filegator/repository/maria/
            

In this case give your superuser access to /filegator/repository/ and he will also see John’s and Maria’s folders.

Although nginx is not fully tested and supported, it has been reported that FileGator works on those servers just fine.

client_max_body_size 100M;
            

location ~* /filegator/repository {
deny all;
}
location ~* /filegator/config {
deny all;
}

You can change colors inside stylesheet CSS file located here:

filegator/include/views/style.css
            

For example you can change background color by editing 3rd line.

You can also change button colors by editing this CSS file:

filegator/include/foundation/stylesheets/foundation.css
            

Styles for buttons are between lines 602-693

All icons are stored into a single sprite file include/views/img/icons30px.png. You can download several different color schemes (black, green, red and blue) from here or use Photoshop's Hue-Saturation to tweak the colors.

Yes, look for this line in filegator/include/blueimp/server/php/upload.class.php

move_uploaded_file($uploaded_file, $file_path);
            

and add you custom code after or before that line, something like this email notification:

mail('[email protected]', 'Subject', 'New file uploaded');
            

You can access current user’s parameters such as username, email, homedir or permissions via $_SESSION[‘simple_auth’] variable. See this example:

mail('[email protected]', 'Subject', 'New file uploaded by the user: '.$_SESSION['simple_auth']['username']);
            

More complex example using current SMTP configuration:

$gator = new gator();
$gator->sendEmail('[email protected]', 'Notification', 'New file uploaded by the user: '.$_SESSION['simple_auth']['username']); // admin
$gator->sendEmail($_SESSION['simple_auth']['email'], 'Notification', 'New file uploaded: '.$file->name); // user
            

To reset your admin password upload recoverpass.php from this archive to your filegator folder and point your browser there (http://www.example.com/filegator/recoverpass.php). Remove this file from the server and login with defaut admin password admin123

To enable image preview mode by default open: include/views/main-filelist.php and change this:

<a <?php if($file['buffer']!=false) echo 'class="'.$file['buffer'].'"';?> <?php if(gatorconf::get('use_lightbox_gallery') && $file['type'] == 'image') echo 'rel="lightbox[images]"';?> href="<?php echo gatorconf::get('base_url')?>/?download=<?php echo $file['crypt']?>"><?php echo $file['name']?></a>

<a <?php if($file['buffer']!=false) echo 'class="'.$file['buffer'].'"';?> <?php if(gatorconf::get('use_lightbox_gallery') && $file['type'] == 'image') echo 'rel="lightbox[images]"';?> href="<?php echo gatorconf::get('base_url')?>/?download=<?php echo $file['crypt']?>"><?php if(gatorconf::get('use_lightbox_gallery') && $file['type'] == 'image') echo '<img class="image-preview" src="'.gatorconf::get('base_url').'/?download='.$file['crypt'].'" />'; echo $file['name']?></a>

<a class="image-size decrease" style="display:none"></a>
<a class="image-size increase" style="display:none"></a>

<a class="image-size decrease"></a>
<a class="image-size increase"></a>

Note: This section is written for developers and advanced users. Feature or method described below is experimental and it’s not officially supported! You must have allow_url_fopen enabled in your php.ini in order for file_get_contents to work.

<input type="hidden" name="submit" value="ie_enter_fix">

<script src="https://www.google.com/recaptcha/api.js" async defer></script> 
<div class="g-recaptcha" data-sitekey="XXXX"></div>
            

$user = gator::getUser($_POST['username']);

$secret = "YYYY";
$response = $_POST["g-recaptcha-response"];
$ret = json_decode(file_get_contents("https://www.google.com/recaptcha/api/siteverify?secret=".$secret."&response=".$response."&remoteip=".$_SERVER['REMOTE_ADDR']), true); 
if($ret['success'] != true) $errors = lang::get("Wrong Captcha"); 

static function addUser($username, $data){

$gator = new gator();
$gator->copyRecursively(gatorconf::get('repository').DS.'skeleton', $data['homedir']);

Default sort is by ‘name’, ascending. If you want to change that open include/file-gator.php and search for this:

$_SESSION['sort']['by'] = 'name';
$_SESSION['sort']['order'] = 1;
            

you can replace ‘name’ with ‘date’ or ‘size’ and change order to -1 for descending.

You must log out and log in again to apply this changes.

Officially symlinks are not supported but they could work with a little tweak. Open filegator/file-gator.php and replace this line:

if (filetype($directory.DS.$file) == 'dir'){
            

with this line:

if (filetype($directory.DS.$file) == 'dir' || filetype($directory.DS.$file) == 'link'){
            

Symbolic links can be used on linux to simulate shared folders.

Although you can use any existing folder as a repository, including folders outside the web root, we do not provide support for this type of configurations. This is due to many different server and filesystem types, configuration variables, and permission combinations involved.

Allowing users to access your server and files can lead to security risks. That’s why FileGator has a whole set of security features implemented out of the box reducing that risk to minimum. These features include:

• Users can login to system only if you grant them access.
• You can grant read-only permissions and disable upload and write operations.
• Special .htaccess file inside repository folder prevents users from executing php and other scripts. Check if this is working (see below).
• Filesystem operations between browser and server can be encrypted with mcrypt function. This can be enabled with config parameter encrypt_url_actions.
• Users cannot exit their own home folder.
• In users database file passwords are encrypted. This file is protected with .htaccess and can be stored outside web root folder on secure location. You can also use database for this.

If for some reason you need very strong security you can improve security even more by following these security guidelines:

• Always use the latest FileGator version.
• Pick strong passwords for users and admin, disable changing passwords if necessary to prevent users from picking weak passwords.
• Relocate config/config.json file outside web root folder or use database to store users info.
• Check if users can execute php scripts by uploading test.php file to user repository. If 403 access forbidden error is thrown when user clicks on test.php file then this security feature is working. Beware that .htaccess works on Apache servers only.
• Enable url encryption for filesystem actions in config section (encrypt_url_actions = true). When this function is enabled server will accept only encrypted filenames for all operations.
• Grant access to the users you trust, not everyone.
• Enable ssl on your server and accept only https connections. This way all communication between user and server will be encrypted. You may need to adjust base_url inside config.
• Use repository folder outside web root (public server path)
• Do not use shared hosting or shared servers.
• Test everything with non-critical data.

And remember, you are solely responsible for your files, server and data. If you have very sensitive data do not use this or any other software or digital storage – store your data in safe-deposit box in a bank you trust.

Open configuration.php file and enable guest account:

'allow_guests' => true,
            

...then login as admin and give full access rights to the guest.

DO NOT use this setup on public servers since everyone could write to your filesystem

Open configuration.php and set ‘encrypt_url_actions’ to true.

FileGator respects session lifetime settings defined on your server.
If you wish to change that you can add your custom settings inside filegator/index.php

<?php
// session will expire after 1 hour
ini_set('session.gc_maxlifetime', 3600);
session_set_cookie_params(3600);