Extension Key: mailform
Copyright 2006-2007, Sebastian Winterhalder, <sw@internetgalerie.ch>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.com
Mailform is a powerful extension for creating forms. In a backend wizard, the user can design very variable forms, which are generated dynamically in the frontend pages. The forms will be sent as an email to specified recievers. For each mailform content element are two different types of mails available. One is e.g. for the site administration and the other is e.g. a confirmation for the user who sent that mail.
More Informations at: http://mailform.typo3-extensions.ch
Multi-Col System
Independent XML-System
Very functional wizard
Administration and User Mail
Addon-Platform for third party development
Statistics Addon available (Ext. key: mailform_statistics)
Template-Manager Addon available (Ext. key: mailform_templates)
Translation already available in English and German.
Mail Statistics
Excel Export
Template wizard
Allows to save own templates and use pre-defined templates
mailform_userfunc – Conflicts with that extension. Extensions with a key starting with 'mailform_' will currently not be able to run with mailform. Only real mailform addons which must start with that key-part can run besides mailform properly.
With different pre-defined input types, its possible to create a very individual form. Following types are supported yet.
Text input
Text input with additional description
Textarea input (multiple lines)
Dropdown / Multiselect Menu
Radiobuttons
Password field
File upload
Hidden inputs (e.g. for displaying individual data in an email)
Typo3 content elements (referenced to a existing T3 content element)
Different Submit Button types
Captcha spam protection
The checkbox is one of the most complicated field type in mailform. It supports many features to controll the users input.
Its possible to make
Illustration 3: If you use checkboxes you will have to configure this interface. Multivalues represent single checkboxes. Standard value will be preselected with CSV and Required Values will be documented more precise.
Checkbox required?Yes, checkboxes can be required. For GBA or simililar things user must chose a checkbox to continue on the form. To setup required checkboxes, check the box 'Required' and input your error message if the user does not choose any of the given values.
If there is a list of values and only one but one must be selected, there is a statement that allows it. In the grafic above, there are three possible values: value1 value2 and value 3. If you want the user to check at least one of those three values, but not choosing one is forbidden write a statement like this: (value1||value2||value3), in the 'Required Values (CSV)' field.
The || stand for a logical OR. If you need the user to input all of those values, you can simply separates value with commas. E.g. “value1,value2,value3”. If you like the user to input every time value1 and value2 or value3 write a statement like this: “value1,(value2||value3)” and so on.
Email Options
If you need to send a email to several recipients, you can input as value the email and choose in the
Every form type has an individual validation. It is possible to give each an according requirement to be valid. Following validation Types are supported yet.
E-Mail validation
Alpha-Numeric validation
Only digits / numbers
Only letters
Regex-Pattern validation
Field containing a given value
Each form type can be designed in an template. With that the possible variations are nearly infinite to design a individual form.
CSS for the page form, and CSS for sent E-Mail is separated. For installation and configuration see section below.
For installation you only need to install the given t3x file. You can either copy the extension directory in your typo3conf/ext/ root, or upload it with the install and import mask of typo3.
Ensure that you allow all Database table to be created, not at least if you add some Add-ons of the extension.
You also should ensure that the server has write access to the EXT:temp/ directory. Which is used for several actions some add-ons or the extension itself uses for a temporary file deposit.


