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 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.dist to config.inc, and modify it yourself using a text
editor.

After you are done with the configuration, make sure you make config.inc
read-only for the web server's user, or remove configure.php from the
directory.

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

Make a backup of your old AeroMail installation. Copy your config.inc
and any other files you customized into the new AeroMail directory.
Make sure config.inc 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 will be written. Now copy the new installation over your old
one.
 
----- Upgrading from AeroMail 1.xx -----

No automatic upgrade is possible from older versions of AeroMail. Follow
the steps described in 'First-time installation' to make a new
installation. 

----- 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 and
style.php.

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

Q:  I'm getting the error:
    "Fatal error: Call to unsupported or undefined function imap_open() in
    global.inc 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>

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

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