====== AfterOffice Form-To-Mail Template with Captcha Support ======

Version: 1.5\\

This form can be used by AfterOffice customers to create contact or feedback form on their website, which will send all collected information to the target email address.


**Important Notes:**\\
  * This form is designed to AfterOffice customers only.
  * This form must submit to a valid email address (hosted with AfterOffice).
  * jquery.js must be included in the html in order to support the captcha display.

-----------

===== Form Action =====
The form action looks like below.

<code>
<FORM action="http://vo.yourdomain.com/cgi-bin/vo/formmail.cgi.vo" method="post">
</code>

Where //yourdomain.com//: Your domain.

-----------

===== Fields =====
Press refer to this page for all supported fields: https://afteroffice.com/form/form-captcha.html


-----------

===== Captcha Support =====
In order to load and display captcha, you are required to insert the following javascript function into your html header.

<code>
<script language="javascript">
   $(document).ready(function(){
      $('#hv').load('/cgi-bin/vo/form_hv.cgi.vo');
   });
</script>
</code>

To display the captcha field, simply insert //<span id="hv"></span>// into your form.

<code>
Your Name: <input type="name" id="name" name="name" required>
Your Email: <input type="email" id="email" name="email" required>
<span id="hv"></span>
<input type="submit" value="Send Message">
</code>

-----------

===== Captcha Validation (Optional) =====
The following javascript function is used to check if captcha is filled when the form is submitted. If the captcha is not filled, the user will be alerted.

<code>
<script>
   function validateForm()
   {
      var x=document.forms["formName"]["_hv"].value;
      if (x==null || x=="")
      {
         alert("Please fill in captcha");
         return false;
      }
   }
</script>
</code>

Where //formName// represents the name of the form.

This function can be inserted as the onsubmit event of the form, like the example below.

<code>
<FORM action="http://vo.yourdomain.com/cgi-bin/vo/formmail.cgi.vo" method="post" id="formName" name="formName" onsubmit="return validateForm() />
</code>


-----------

==== Samples ====

https://afteroffice.com/form/sample/sample_enquiry_captcha.html