############################ Mailcode v.1.9.5 ##############################

Mailcode is a simple feedback form system, designed with the novice
web designer in mind. It utilizes CAPTCHA technology to prevent spam
submission, validates email address structure, and validates form fields
to ensure all requested information is provided.

Mailcode is expandable, allowing you to include your own form fields
without editing the complicated source code. Simply add your fields to
the basic HTML form and the mail handler will interpret them. Edit the
HTML form to match your website layout.

To start using the system, simply upload and configure the script, and add
one line of code to your webpage.

__________________________________________________________________

Licensing:

This script is released under GNU Public Licensing terms. It is free to
use, modify, and distribute.

Support is available at http://www.myphpscripts.net

Enjoy!

##########################################################################

// Installation Requirements //

- PHP 4
- GD Library (to generate the .png images)
- sendmail (to send the outgoing e-mail message)

// Installation Instructions //

1. Edit the variables in the mailcode-includes/config.php file.

2. Upload the contents of the mailcode folder in the directory you want to
run the script from. Retain all file and folder locations.

3. Paste the following code wherever you want the form to be shown on your
page: <? include("contact.php"); ?>

4. If the extension on your webpage is not .php, change the extension to .php.
Example: Rename homepage.htm to homepage.php

5. If you want to use file attachments, CHMOD 755 the tmp directory.

6. If you want to use logging, CHMOD 755 your logs directory.

That should be it! The form should show up on your page, and you have a
spam-proof feedback form.

Note: To add form fields or change the form layout, basic HTML knowledge
is required. Edit the contact.php file to make changes.

##########################################################################

// Updates & Bugfixes //

03/05/2010 Fixed a bug in MIME boundary strings when attaching files.

02/06/2010 The included form was updated to XHTML 1.1 standards.

MIME type was changed from text/plain to text/html to support
HTML.

Form parsing has been improved to allow
grouping. To utilize this functionality, grouped fields
must be submitted as an array. For example:

<input type="checkbox" name="checkbox[]" value="checkbox 1" />
<input type="checkbox" name="checkbox[]" value="checkbox 2" />
<input type="checkbox" name="checkbox[]" value="checkbox 3" />
<input type="checkbox" name="checkbox[]" value="checkbox 4" />
<input type="checkbox" name="checkbox[]" value="checkbox 5" />

12/30/2008 Field validation has been improved to reference
unchecked checkboxes.

12/29/2008 Improved logging capabilities. Logfiles now include
required and submitted security codes, attachment names,
errors, referrer string, and user agent string.

12/22/2008 Removed the word "Message" from generated emails and
separated the actual message with two linefeeds.

12/21/2008 Added an array to specify validated fields, changed the
CAPTCHA refresh code to eliminate page reloads.

02/26/2008 Added multi-file upload capabilities, combined external files.

09/29/2007 Redesigned the CAPTCHA image.

07/07/2007 Fixed a bug in which enabling file attachments would cause
the script to require an attached file with all messages.
Added stripslashes() to all submitted form values.

07/01/2007 Changed the default font.

06/23/2007 Added file attachments.

05/27/2007 Headers will now be formatted to use the sender's
name and email. Fixed a bug that caused logging to
remain on all the time.

04/25/2007 Added form field validation. All form fields are checked to
ensure they have been filled out. Added a javascript image
reloader.

04/24/2007 Added logging capabilities. All messages submitted through
the form can now be logged to the directory of your choice.
Regardless of whether the form was mailed or not, submissions
can be logged in date-formatted flat files. This means that
each day, a new logfile is generated and all submissions for
that day will be logged in the new file.