Thank you for choosing Maian Mail, I hope you like it:

================
DISCLAIMER:
================

This script is a work in progress. It may contain bugs or security issues which have not yet been addressed. 
Use of this script offers no guarantees and is used entirely at your own risk. The script author cannot accept 
any liability for problems that may occur when using this script. Thank you!

Please report a bug if you find one.

================
INSTALLATION:
================

1. Firstly, ensure that you have PHP installed on your server. If you see the PHP code in your browser, then
   this script will not work on your server. PHP v4.3 or higher is recommended. Earlier versions will not respond
   to some of the PHP syntax used in this script. You also need the GD2 Graphics Library installed to display 
   the Captcha code. 

2. Using a text editor (ie: Notepad) open up the 'control/config.inc.php' file and edit it to suit your preferences. 
   More advanced users can play around with the captcha settings in the 'captcha/secureimage.php' file.

3. Create a directory on your web server to hold the script files. ie: 'mail'

3. Into this directory upload the the following files/folders (and their contents) in the same structure:
         
   /boxtrapper/
   /captcha/
   /classes/
   /control/
   /lang/
   /templates/
   index.php
   
5. If you have enabled the Box Trapper function, chmod the 'boxtrapper' folder to make it world writeable. 

   ie: 0777 or 0755

   Note: If you have specified a different name for the box trapper folder in the config file, make sure 
   you rename this folder first. It is recommended you do rename the folder.
   
6. Access the index.php file in your browser. ie: http://www.yoursite.com/mail/index.php

7. Run a test to see if everything is working ok.

ENJOY!! NOW PLEASE READ BELOW!!

=========================
TEMPLATES & APPEARANCE:
=========================

The templates for the script are in the 'templates' folder. Edit these to fit into your existing website.

Additional HTML can be found in the 'templates/html/' folder.

It is important that you DO NOT remove any of the PHP code in the .tpl.php template pages or words between braces 
from the .htm files. This will cause the script to malfunction. Variables may appear like the following:
  
<?php echo $this->VAR; ?> or {code}

To change the colours and appearance of the script, edit the 'templates/style.css' file. All the colours and
control elements are here.
  
If you want to change the header graphic, simply overwrite the 'templates/images/logo.jpg' file.   

To edit the e-mail templates, open the 'templates/email/*.txt files in a text editor.

All language is found in 'lang/english.php'.

================
BOX TRAPPER:
================

Maian Mail has a built in optional box trapper function. Some servers have this kind of option installed, which
requires a person to verify their e-mail address before a message gets sent. If the box trapper function is enabled
the message that is submitted gets written to a flat text file until the person verifies their e-mail address. Once they
have verified their e-mail address, the message gets sent and the data gets deleted.

A whitelist contains all verified e-mail addresses, so anyone who verifies their e-mail address are only required to
do it once. Next time they use the form, their message gets sent straight away. Finally, so that the server doesn`t get
cluttered with unsent messages, a duration can be set, after which time the message gets auto deleted. I haven`t at
this stage included a blacklist file for banned addresses. This may appear in the next version.

The box trapper was new in v3.1 and is still in its experimental stages. The captcha code will give pretty good anti spam
support anyway and should always be enabled. I encourage you to try out the box trapper function and send me your
comments/opinions/feedback. Thanks.

================
ATTACHMENTS:
================

If you wish, you can have the system e-mail you attachments. You can specify as many attachment files as you wish. When
the form is processed, the attachments are sent to your e-mail program like a standard e-mail.

You can also specify the files allowed for this feature and also the max file size per file. Files are renamed before
being sent to your inbox for security reasons, however, you should always use your virus scanner to scan attachments
before you open them. Trust NOTHING that has been submitted by a visitor.

NOTE: Attachments do not function with the box trapper system. If you enable attachments, the box trapper function
is disabled.

================
CAPTCHA:
================

Maian Mail has a captcha feature to help prevent spam bots. The options for the captcha are in the 'captcha/secureimage.php'
file. Here you change colours, text options and also the size of the captcha. By default the captcha reads from a word list,
but you can change this to be random if you wish. Just edit the captcha php file and update. You can also change the word
list if you want to. To do this edit the 'captcha/words/words.txt' file.

If you do not see the captcha load, your server may not have the GD graphic library enabled. If you are unsure contact your
host. Alternatively, check your error log for other failure reasons.

--------
**HELP**
--------

I hope you enjoy your new mail system.

If you are have any problems, please post on the support forum:
http://www.maianscriptworld.co.uk/forums

---------------------------------------------------------------
Maian Mail. Copyright  David Ian Bennett. All Rights Reserved.

Maian Script World
http://www.maianscriptworld.co.uk
