MailForms plugin - User guide

Costumize your forms with our latest extensions, the MailForms plugin!

Create your form in your favorite editor, then simply replace the <form> opening and closing tags by the plugin's tag:

{mailforms mailto="sebastien.chartier#gmail.com" }
  
  <!-- THE INPUT FIELDS HERE -->

{/mailforms}

Contact form

This example shows how to implement a simple contact form using the MailForms plugin. This code would result in a popup form, the text of the link to open the popup would be "Example 1" and the subject of the email would be "Message subject".

<p>{mailforms mailto="sebastien.chartier#gmail.com" 
                label="Example 1"
                style="icones" 
                display="popup" 
                subject="Message subject"}</p>
  <h3>Contact us by email!</h3>
  <p>
    <label for="name">Your Name:</label> 
    <input id="name" style="width: 60%;" type="input" name="data[name]" />
  </p>
  <p>
    <label for="email">Your Email:</label>
    <input id="email" class="required valid-email" style="width: 60%;" type="input" name="data[email]" />
  </p>
  <p>
    <label for="subject">Subject:</label>
    <input id="subject" class="required" style="width: 60%;" type="input" name="data[subject]" />
  </p>
  <p>
    <label for="message">Message:</label>
    <textarea id="message" class="required" name="data[message]" rows="3" cols="26"></textarea>
  </p>
  <p>{captcha /}</p>
  <p style="text-align: center;">
    <input id="submit" type="submit" value="  Send  " />
  </p>
<p>{/mailforms}</p>

IMPORTANT: Only fields of the form data[name] will be displayed in the message.

Plugin's tag

This example shows all the parameters available for the tag, ONLY THE MAILTO ATTRIBUTE IS REQUIRED!

{mailforms mailto="your#email.com"
                style="none" 
                label="Example 1" 
                display="popup" 
                subject="Message subject"
                width="400"
                errorMessage="Message displayed on error"
                successMessage="Message displayed when the form is submitted succesfully"
                wrongCaptcha="Message displayed when the wrong captcha is entered" }

Form validation

You can use default Joomla! form validators as defined here.

To enable form validation on an input in your form, simply add the one or more of the following class to the input tag (see previous example):

• required
• validate-username
• validate-password
• validate-numeric
• validate-email

The form is validated automatically before being sent.

Styles (compatible with ContactFormPro styles)

• light
• dark
• icones
• legerete
• minimal
• smooth

Captcha

To insert a captcha inside your form, simply use the {captcha /} tag.

Notes

You cannot use <input type="textarea" ... /> in TinyMCE editor (default Joomla! editor), you must use <textarea>.