AeroMail

----------
 Overview
----------

AeroMail is a web-based e-mail client written in PHP. AeroMail uses an
IMAP server to read and store messages in one or more user-defined
folders. Features include:
* HTTP authentication for login (no cookies) or login with cookies 
* Optional IMAP folder manipulation
* Optional spam flagging using reverse DNS mapping
* HTML messages and attachments
* Simple HTML that can be embedded in a page of your own design
* JavaScript not necessary
* Support for different character sets (e.g. Russian and Chinese)
* Support for SSL IMAP servers
* Support for sendmail's genericstable (reverse mapping of users for
  outbound mail)

--------------
 Requirements 
--------------

Apache, PHP 4 or better (has to be running as a module), the IMAP
functions must be compiled into PHP, an IMAP server. Information about
Apache, PHP, and compiling IMAP support into PHP can be found at one of
the following URL's

    http://www.apache.org/
    http://www.php.net/

--------------
 Installation 
--------------

Unpack the AeroMail package (.gz or .zip file) into a directory within
your web server. Then follow the steps below to configure AeroMail.

----- First-time configuration -----

Make sure that directory is writable for the web server's user, or
create a file called config.inc.php that is writable for the web
server's user. Now access that directory from a web browser, or browse
directly to the file configure.php. A configuration form will appear.
Fill in all the fields to match your configuration. Alternatively you
can copy config.inc.php.dist to config.inc.php, and modify it yourself
using a text editor.

After you are done with the configuration, make sure you make
config.inc.php read-only for the web server's user. For additional
safety, you can remove configure.php from the directory. If necessary,
make the AeroMail installation directory read-only for the web-server's
user again.

----- Upgrading from a previous version of AeroMail -----

Make a backup of your old AeroMail installation. Copy your
config.inc.php or config.inc and any theme files and template files you
customized into the new AeroMail directory.
If you upgrade from AeroMail 2.30 or earlier to AeroMail 2.40 or later,
rename all .inc files to .inc.php.
Make sure config.inc.php is writable for the web server's user. Now
access configure.php in that directory from a web browser. A
configuration form will appear, showing your old configuration settings
and default values for any new features. Change the settings to suit
your needs. A new config.inc.php will be written. After everything is
set up correctly, copy the new installation over your old one.
 
----- Note on upgrading from AeroMail 2.xx -----

The configuration process will convert config.inc (or config.inc.php)
automatically to work with this version of AeroMail. Theme files and
template files should work with any version of AeroMail. If you made
changes to layout.inc (or layout.inc.php), style.php or any language
files, you will have to remake those changes yourself.

----- Note on upgrading from AeroMail 1.xx -----

The configuration process will convert config.inc automatically to work
with AeroMail 2. It will not, however, convert any other changes you
made. You will have to make those changes yourself.

----- Using AeroMail -----

Access index.php in the AeroMail directory with a web browser. The
username and password pair are your IMAP username and password.

----- Customizing AeroMail -----

You can embed AeroMail in a webpage of your own design. To do this,
create a template or modify one of the templates in the themes
directory. You can specify your own style sheet and font size in your
template file; that way you don't have to change the AeroMail files.

If you want a completely different layout, change layout.inc.php and
style.php.

-----------------
 Common Problems 
-----------------

Q:  I'm getting the error:
    "Fatal error: Call to unsupported or undefined function imap_open() in
    global.inc.php on line xx"

A:  You haven't compiled IMAP support into PHP. See
    http://www.php.net/imap


---------
 Credits
---------
Version 2.0
    Dion Nicolaas <dion@nicolaas.net>
    and Laird Bedore <lmbedore@vectorstar.com>

    with help from:
    SteX <stefano.melchior@fastwebnet.it>

Version 1.x
    Mark Cushman <mark@cushman.net> with help from:

    Thorsten Huber <thorsten@huber3000.de>
    Justin R. Miller <justin@openup.com>
