
--------------------
 Installation Guide
--------------------


Requirements
""""""""""""

  PHP 4.1 or greater
  PEAR packages: DB
  A web server supported by PHP (Apache is most widely used)
  A database with adequate support compiled into PHP


Installation
""""""""""""

The most common method of installing CleverMail is to grab the archive,
unzip it somewhere and run through the code making all the changes you need.

Here is the process:

1) Obtain clevermail*.zip or clevermail*.tgz

2) uncompress it into the directory you want

3) Make sure your directory structure is like this:

      cm/
      cm/admin
      cm/design
      cm/docs
      cm/install

4) If the previous stages were done locally, upload the whole directory to your
   server.

5) Before updating from an older version of CleverMail, ...

6) Then you have two possibilities :

   a) Use the online configuration tool by accessing 'cm/install/index.php'

   b) Do it manually. Move into 'cm/admin/include' directory and make changes
      to the 'appconfig.php' file (see 'docs/configuration.txt' for details
      about the directives).

7) Once all this has been done, you should protect the config file (that
   contains your login/password for db access). Look at your server
   documentation to find out how to do this.
   For the Apache server, you may need to create an ".htaccess" file
   (without quotes) in the config subdir that contains:

      <files appconfig.php>
      Order Deny,Allow
      Deny From All
      </files>

