# uncompress or sub-module into: connectors/php/plugins/s3
$   cd {path/to/filemanager}/connectors/php/plugins
$   mkdir s3
$   curl -# -L https://github.com/Net-Results/filemanager-php-s3-plugin/tarball/master | tar -xz --strip 1 -C s3/

# uncompress or sub-module into: connectors/php/plugins/s3
$   git submodule add https://github.com/Net-Results/filemanager-php-s3-plugin.git {path/to/filemanager}/connectors/php/plugins/s3

$   cp filemanager.config.js.default filemanager.config.js

var culture              = 'en',
    defaultViewMode      = 'grid',
    autoload             = true,
    showFullPath         = false,
    displayPathDecorator = function(path) { return path.replace(/^\d+\/images/i, ''); },
    browseOnly           = false,
    lang                 = 'php',
    am                   = document.location.pathname.substring(1, document.location.pathname.lastIndexOf('/') + 1),
    fileRoot             = '/',
    relPath              = '//xxxxxxxxxxxxxx.cloudfront.net/',
    showThumbs           = true,
    imagesExt            = ['jpg', 'jpeg', 'gif', 'png'];

// Set culture to display localized messages
var culture = 'en';

// Set default view mode : 'grid' or 'list'
var defaultViewMode = 'grid';

// Autoload text in GUI
// If set to false, set values manually into the HTML file
var autoload = true;

// Display full path - default : false
var showFullPath         = false;

// Browse only - default : false
var browseOnly = false;

// Set this to the server side language you wish to use.
var lang = 'php';

var am = document.location.pathname.substring(1, document.location.pathname.lastIndexOf('/') + 1);

// Set this to the directory you wish to manage.
var fileRoot = '/';

// Path to the manage directory on the HTTP server
var relPath = '//d40rlfik0wts0.cloudfront.net/';

// Show image previews in grid views?
var showThumbs = true;

// Allowed image extensions when type is 'image'
var imagesExt = ['jpg', 'jpeg', 'gif', 'png'];

$   cp filemanager.s3.config.php.dist filemanager.s3.config.php

<?php
/**
 * S3 plugin configuration
 *
 * You may over-ride any parameters set by the filemanager.config.php file here
 *
 * @license MIT License
 * @author	Wil Moore III <wmoore@net-results.com>
 */

/*******************************************************************************
 * Credentials
 ******************************************************************************/

/**
 * Amazon Web Services Key. Found in the AWS Security Credentials. [default = '']
 */
$config['aws-access-key']     = 'XXXXXXXXXXXXXXXXXXXX';

/**
 * Amazon Web Services Secret Key. Found in the AWS Security Credentials. [default = '']
 */
$config['aws-secret-key']     = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';

/*******************************************************************************
 * Domain, path, etc.
 ******************************************************************************/

/**
 * [optionally] override the base filemanager's 'doc_root' setting
 * You should leave of leading and trailing slashes as they will be removed anyhow
 */
$config['doc_root']           = "{$_SESSION['userId']}/images";
// NOTE: $_SESSION... is not the best way to handle this, but this is just an example

/**
 * Should the root directory be created if it doesn't exist? [default = false]
 * use if you are dynamically building document root and appending a user specific directory
 */
$config['create-root-dir']    = true;

/**
 * S3 bucket name (REQUIRED) [default = '']
 */
$config['s3-bucket']          = 'our-corporate-file-store';

/**
 * Public DNS name (REQUIRED) [default = null]
 *
 * suggestions:
 *  1)  cloudfront distribution domain (i.e. {distribution-name}.cloudfront.net)
 *  2)  s3 origin domain (i.e. s3.amazonaws.com)
 */
$config['s3-public-domain']   = 'xxxxxxxxxxxxx.cloudfront.net';

/*******************************************************************************
 * Cache
 ******************************************************************************/

/**
 * Where should cached objects be stored? [default = 'apc']
 * apc, xcache, memcache, memcached, pdo, pdo_sqlite, sqlite, sqlite3 (or path on disk)
 */
$config['aws-cache-scheme']   = 'apc';

/**
 * compress (gzip) cached objects (true|false) [default = true]
 */
$config['aws-cache-compress'] = true;

/**
 * expire cache after this date/time interval. [default = '1 day ago']
 * seconds as integer | relative: http://php.net/manual/en/datetime.formats.relative.php
 */
$config['aws-cache-expirein'] = '1 minute';

/*******************************************************************************
 * Debugging
 ******************************************************************************/

/**
 * Enable debug mode (true|false) [default = false]
 * Enabling this will turn on debugging for the following components:
 *
 * 1 - curl (our favorite low-level http-client)
 * 2 - CFRuntime (the underlying component behind the AWS services API
 * 3 - FileManagerS3 (the actual filemanager plug-in you seek)
 *
 * Enabling this will also hard disable caching regardless of what you set in:
 * - $config['aws-cache-config']
 * - $config['aws-cache-compress']
 *
 * Where debug messages end up depends on 'log_errors' and 'error_log' ini settings
 */
$config['enable-debug-mode']  = true;

/*******************************************************************************
 * PHP error log settings
 ******************************************************************************/

/**
 * as a bare-minimum, you will want to have 'log_errors' and 'error_log' set
 */
ini_set('log_errors', true);
ini_set('error_log',  'syslog');