[doc 2.6] 2 : Basics



<< Ch 1 : Introduction | Up | Ch 3 : AjaXplorer GUI >>

2.1 Download

The current build of AjaXplorer can be downloaded from http://sourceforge.net/projects/ajaxplorer/. Unzip using WinZip, ZipGenius or tar -xzf AjaXplorer-core-2.4-dist.zip.

2.2 Installation

Now that we’ve got our files, we can upload the whole directory to the web server (using your favorite FTP program) in case you’re not already working there.

AjaXplorer needs to save/download files and be able to modify user registry. Therefore make sure the following directories (and file within) are writeable for the web server:

  • files
  • server
  • server/user
  • server/logs

2.3 Configuration & Quick Start

Quick Start : Once you have extracted the AjaXplorer distribution, just access it through your web browser. A diagnostic tool will be ran once to check that your configuration is ok. Then you will have a warning telling you that the user « admin » has been created with the password « admin » : log in with these id/password, and go the the « Settings » panel to change the admin password. You are done!

Custom Start : For more security, you can browse to server/conf and open the file conf.php. Use your favorite text editor to open and modify this document. We’ll customize settings in this file for your unique server configuration and security purposes. Make the mandatory changes listed in section 2.4 Required Settings.

2.4 Required Settings

  • $dft_langue=’en‘: Set the default language to be used (modify bold portion).
  • define(‘ADMIN_PASSWORD’, ‘admin‘): Set the administrator password which is granted most permissions (access) on your file server (modify bold portion). This can also be changed from the GUI at first use.

2.5 Optional Settings

  • Global users management :
    • ENABLE_USERS :  Toggle user accounts on/off.
    • ALLOW_GUEST_BROWSING : Toggle whether guests (unauthenticated users) can browse your files.
  • Public links feature configuration :
    • PUBLIC_DOWNLOAD_FOLDER
    • PUBLIC_DOWNLOAD_URL : read documentation inside the comments, these are used by the « Public Link » feature.
  • Upload configuration
    • $upload_max_number : Maximum number of files for each upload. Leave to 0 for no limit.
    • $upload_max_size_per_file: Maximum size per file allowed to upload. By default, this is fixed by php config « upload_max_filesize ». Use it only if you want to set it smaller than the php config.
    • $upload_max_size_total : Maximum total size (all files size cumulated) by upload.
  • Misc :
    • $max_caracteres: Maximum number of characters for file/directory names [default=50].
    • $use_https: Change value to ‘true’ if using an HTTPS (SSL) domain, this is used to correct a bug in Internet Explorer
    • $allowRealSizeProbing : set to true, use system code to get FileSize. Enable this on 32bits machine, to overcome PHP 4GB limit on file size. This requires shell_exec permission on linux, and fork permission on windows. Under Windows, it’s faster to install COM PHP Extension.

2.6 Protect Your Installation

Access through your web server to the following directories should be denied upon completing configuration:

  • server/conf
  • server/users

Note: AjaXplorer uses .htaccess files to protect these directories automatically, be sure to allow override of the Limit directives on your web server (contact your Webmaster).

2.7 Running AjaXplorer

Upon completing installation, browse to your live site on the web server (http://yourdomain.com). As AjaXplorer loads, it will display « Loading Components’ Main Template Loaded’ Action Bar Initialized’ List Loaded ». Once you arrive at the login screen, login using your credentials. [default username=admin / password=admin]

Select Remember Me to save a cookie with your login credentials to the local machine. Note: Do not use on public computers.

<< Ch 1 : Introduction | Up | Ch 3 : AjaXplorer GUI >>