CC MailForm Help

RLAJ.COM CC MailForm Help

For Unix or NT

CC MailForm will send mail to you from any form you design. The form may be designed any way you like, with any combination of field types. There are a few tags (see below) that must be present in your form for the program to send mail to you. See the example form.

Input tags you may use:

text input fields
radio buttons
checkboxes
textareas
hidden tags

Designing your Form

In your HTML Form there are tags that must be present in the form for the program to send mail to you.
Note: The fields that start with XX- CAN NOT be changed and must be exactly as shown below.

Hidden Tag Names CAN NOT be changed!

The special hidden tags MUST be exactly as shown below in your form. The "names" are case sensitive.

<input type=text name=XX-email size=40> The "Your E-Mail Address" Field (sender)

The mail Subject
<input type="Hidden" name="XX-subject" value="My Mail Subject">

To Sort or not to Sort
<input type="Hidden" name="XX-sort" value="yes"> or value="no"
This determins the order of the fields in the email. If you DO NOT use the
sort, the fields will be printed in the same order as on the form.

Optional Hidden tags

Print Blank Fields
<input type="Hidden" name="XX-print_blank_fields" value="yes"> <! yes - no >

Setting Up Required Fields (optional)
<input type="Hidden" name="REQUIRED" value="name,XX-email,Comments">

To make a form field Required to be filled in by the user use the tag above in your form. To define which fields you want to require, put the name of the field
( name for the users Name Field )
in the Value="name" portion of the REQUIRED tag. To Require more than one field, place a comma (,) between the fields you want to require.
Example - value="name,XX-email,Comments" will require the users Name, users E-Mail, and Comments.
Important: Use only one REQUIRED tag in your form.

Setting Up Sort Order (optional)
<input type="Hidden" name="XX-Sort_Order" value="name,XX-email,address,city,state,zip,Comments">

To sort the fields in a certain order use the hidden tag above. Enter the names of the fields in the order you want them to appear in the email.
Use a comma between the fields in the value tag.
Important: if you are using the sort order hidden tag,
all of your form fields MUST be listed in the Value="" of the XX-Sort_Order tag.

EXAMPLE: value="name,XX-email,address,city,state,zip,comments" In this example the order of the fields would be:
name
email
address
city
state
zip
comments

Send and email receipt to the user -- Must be '1' to send a receipt
<input type="Hidden" name="XX-Send-Receipt" value="1"> <! 1 = Yes 0 = no >

<input type="Hidden" name="XX-receipt-mail-subject" value="Thank you for visiting my page">
<input type="Hidden" name="XX-Receipt-Mail-Body" value="This is the mail body to send to the user. This must be all in one line as shown here.">

Redirection the user to ?
<input type="Hidden" name="XX-redirect-to-url" value="http://www.rlaj.com">

Using this tag in the form, you can "redirect" the user to another page after they have filled in your form. If you do not use this tag, the user will see a "Thank You" screen after the form is submitted. The thankyou page is at: /cgi-bin/cc_mailform/html/thankyou.html

Attaching a file to the email the user receives

See the configuration section of the cc_mailform.pl

Information for Attachments
Attached Files you can send any type of file, .zip .pdf .html etc.

Using as a Credit Card Processor with Encryption

If you are using the form to process credit cards, the following tags must be present on the form. YOU CAN NOT CHANGE THE NAMES OF THE FIELDS.

<input type="Text" name="XX-Card_no" value="">
You can use Radio or a Select box here.
<input type="Radio" name="XX-card_type" value="Visa">
Possible Values are: Mc - Visa - AE - Disc
The values must be formatted exactly as shown above.

<input type="Radio" name="XX-cc-exp-month" value="This is the mail body to send to the user. This must be all in one line as shown here.">
<input type="Radio" name="XX-cc-exp-year" value="This is the mail body to send to the user. This must be all in one line as shown here.">

Example Form HTML Code

Example Form

* Your Name

* E-Mail Address

* Address

* City

* State

* Post Code

*Please Check Card Type.

* Card Number * Exp Date

* Message
*

Example Form Code

<html>
<head>
<title>Mail Form</title>
</head>
<BODY BGCOLOR="#FFFFF1">
<center>
<h2>Send your questions or comments</h2>
</center>
<form method="POST" action="cc_mailform.pl">

<input type="Hidden" name="XX-attach_file" value="c:\website\wsdocs\mailform\mailform.htm">
<input type="Hidden" name="XX-attach_file_name" value="mailform.htm">

<input type="Hidden" name="XX-subject" value="Mail Subject">
<!input type="Hidden" name="XX-redirect-to-url" value="http://www.rlaj.com">
<!input type="Hidden" name="REQUIRED" value="name,XX-email,Comments">
<input type="Hidden" name="XX-sort" value="no">
<!input type="Hidden" name="XX-Sort_Order" value="name,XX-email,address,city,state,zip,comments"> 
* Your Name
<BR>
<input type=text name="name" size=40>
<p>
* E-Mail Address
<BR>
<input type=text name="XX-email" size=40>
<p>
* Address
<BR>
<input type=text name="address" size=40>
<p>
* City
<BR>
<input type=text name="city" size=40>
<p>
* State
<BR>
<input type=text name="state" size=40>
<p>
* Post Code
<BR>
<input type=text name="zip" size=40>
<p>
*  Message 

<BR>
<textarea name="Comments" WRAP=physical COLS=50 ROWS=10></textarea>
*  
<input type="submit" value=" Send Mail ">
</form>
<P>
 
<P>
<CENTER>MailForm - © 1999/2006 <A HREF="http://www.rlaj.com/scripts">Ranson's Scripts</A></CENTER>
<HR Width=90%>
<HR Width=50%>
<HR Width=10%>
  </body>
</html>