Mailform4

$Mailform4['recipient'] = 'contact@example.com'; //the address the contact form output will be sent to
$Mailform4['subject'] = 'example.com contact form message';
// Optionnal, uncomment those two lines to use cc or bcc extra contacts
//$Mailform4['cc'] = 'carbon_copy_contact@example.com';
//$Mailform4['bcc'] = 'blind_carbon_copy_contact@example.com';

//define the fields and the validation checks:
$Mailform4ValidFields = array(
  'name' => array('string', 3, 120), //a string between 3 and 120 characters long
  'sender' => array('email', 3, 120),//an email between 3 and 120 characters long
  'text' => array('string', 3, null) //a string with at least 3 characters
);

include_once('cookbook/mailform4.php');

(Here comes some text...)

(:include Mailform4/FormTemplate:)

(... some more text)

$Mailform4ValidFields = array(
  'name' => array('string', 3, 120), //a string between 3 and 120 characters long
  'age' => array('number', 12, 99), //a number between 12 and 99
  'sender' => array('email', 3, 120),//an email between 3 and 120 characters long
  'text' => array('string', 3, null) //a string with at least 3 characters
);

(:mailform4-show-msgs:)
(:input form "{*$PageUrl}?action=mailform4" post:)
|| border=0
||$[Your name]: ||(:input text size="50" name="mailform4[name]" value="{$Mailform4Name}":) ||
||$[Your age]: ||(:input text size="2" name="mailform4[age]" value="{$Mailform4Age}":) ||
||$[Your email address]:  ||(:input text size="50" name="mailform4[sender]" value="{$Mailform4Sender}":) ||
||$[Your message]: ||||
||(:input textarea name="mailform4[text]" value="{$Mailform4Text}" rows=10 cols=70:) ||||
||$[Enter CAPTCHA value]: {$Captcha} (:input captcha:) ||||
||(:input submit value="$[Send message]":) ||||
(:input end:)

The following text has been submitted via contact form at %DATETIME% by:

Name: %NAME%
Age: %AGE%
Email: %SENDER%
IP: %IP%

Text:
%TEXT%

--
Created by contact form software %MAILFORM4_URL% @ %WEBSITE%

$Mailform4ValidFields = array(
  // ... other fields ...
  'contact' => array('checkbox', null, null), //a single checkbox allowing both checked and unchecked
  'why' => array('radio', array('Commend', 'Complain', 'Enquire'), null) //a set of three radio buttons
);

• For each checkbox, the 2nd and 3rd parameters of the array control the validation. Setting both to TRUE or FALSE will enforce that the checkbox is checked or unchecked respectively. Setting them to nulls or different booleans will allow both unchecked and checked. The value of the field when rendered in the email is "checked" or "unchecked".
• For a set of radio buttons, the 2nd parameter is an array of valid field values. (The 3rd parameter is ignored.) The value of the field when rendered in the email is the selected valid field value.
• For a multi-language use, the value of the fields rendered in the email can by translated via the Site.XLPage-Mailform4-XX page. For instance, to use the above 'why' element in french, you should add these lines :

  # Return for checkboxes an radios 
  'Commend' => 'Commande',
  'Complain' => 'Plainte',
  'Enquire' => 'Requête'

(:mailform4-show-msgs:)
(:input form "{*$PageUrl}?action=mailform4" post:)
|| border=0
||$[Options]: ||(:input checkbox name="mailform4[contact]" value="Contact" {$Mailform4Contact} :) $[Please contact me] ||
||$[Reason]: ||(:input radio name="mailform4[why]" value="Commend" {$Mailform4WhyCommend} :) $[I have a commendation] ||
||           ||(:input radio name="mailform4[why]" value="Complain" {$Mailform4WhyComplain} :) $[I have a complaint] ||
||           ||(:input radio name="mailform4[why]" value="Enquire" {$Mailform4WhyEnquire} :) $[I have a question] ||
||(:input submit value="$[Send message]":) ||||
(:input end:)

• For a checkbox, the input variable name (eg. $Mailform4Contact) is formed as for string, numeric and email fields.
• For a set of radio buttons, each button in the set needs an input element. Each shares the same name. The values must correspond to those in the $Mailform4ValidFields entry. The input variables (eg. $Mailform4WhyCommend) are formed by concatenating the expected input variable name with the value for the button. (Only one of these variables will be set to "checked".)

  ### Mailform4 translations
  'Your email address' => 'Votre adresse email',
  'Your message' => 'Votre message',
  'Your name' => 'Votre nom',
  'Enter CAPTCHA value' => 'Entrer le CAPTCHA-Code',
  'Send message' => 'Envoyer message',

  # Check form messages
  'Please enter a valid email address.' => 'Saisissez une adresse email valide.',
  'Please enter a valid number between %d and %d.' => 'Saisissez un nombre compris entre %d et %d.',
  'Please enter a string that is between %d and %d characters long.' => 'Saisissez un texte entre %d et %d caractères.',
  'Please uncheck the checkbox.' => 'Décochez la case, SVP.',
  'Please check the checkbox.' => 'Cochez la case, SVP.',
  'Please fix the checkbox.' => 'Corrigez la case, SVP',
  'Please select one radio button.' => 'Sélectionnez un des choix proposés, SVP',
  'Please enter a value.' => 'Saisissez une valeur, SVP.',
  'Invalid CAPTCHA code. Please try again.' => 'Code CAPTCHA incorrect. Réessayez, SVP',

  # Feedback messages
  'Sending mails has been disabled.' => "L'envoi d'email a été désactivé.",
  'Thank you! Your mail has been successfully sent!' => 'Merci ! Votre email a été envoyé avec succès !',  
  'Failure sending email.' => 'L'envoi de votre email a échoué',

  # Return for checkboxes an radios 
  'checked' => 'coché',
  'unchecked' => 'décoché',

  # Name of fields
  'name' => 'nom',
  'sender' => 'email',
  'text' => 'texte'