This page is still a beta!

Chapter 1. Mailform

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

1.1. Introduction

What does it do?

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

Highlights

  1. Multi-Col System

  1. Independent XML-System

  2. Very functional wizard

  3. Administration and User Mail

  4. Addon-Platform for third party development

  5. Statistics Addon available (Ext. key: mailform_statistics)

  6. Template-Manager Addon available (Ext. key: mailform_templates)

  7. Translation already available in English and German.

Mailform-Addons

  1. Mail Statistics

    1. Excel Export

  2. Template wizard

    1. Allows to save own templates and use pre-defined templates

Screenshots

Illustration 1: Formular Wizard. Shown is here the backend wizard to create forms. Different field types are shown. Multiple Cols are used. This Form is available with the 'mailform_templates' Extension Add-On.

Illustration 2: Example above in the Frontend

Illustration 2: Example above in the Frontend

Known conflicts

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.

Form Types

With different pre-defined input types, its possible to create a very individual form. Following types are supported yet.

Interactive Types

  1. Text input

  2. Text input with additional description

  3. Textarea input (multiple lines)

  4. Dropdown / Multiselect Menu

  5. Radiobuttons

  6. Password field

  7. File upload

  8. Hidden inputs (e.g. for displaying individual data in an email)

  9. Typo3 content elements (referenced to a existing T3 content element)

  10. Different Submit Button types

  11. Captcha spam protection

Checkbox

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

Date

The date field type supports a calendar selection interface.

Layout types

  1. Separator Line <hr> Element

  2. Title element

  3. HTML-Element

Pagenavi Types

What are 'Pagenavi Types' for? They are used to set up a navigation system on a multipage formular or reset a formular.

  1. Next page

  2. Previous page

  3. Pagebrowser

  4. Reset formular

  5. Submit button

  6. Submit button with image

  7. Submit button with extended options

Validation

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.

  1. E-Mail validation

  2. Alpha-Numeric validation

  3. Only digits / numbers

  4. Only letters

  5. Regex-Pattern validation

  6. Field containing a given value

Validation interactive

With the extension Xajax interactive validation is supported. There may occure bugs, due software development. For that the feature is disabled until future versions. At this moment the extension Xajax is not required for using Mailform, but in future version it will be.

Templates

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.

Installation

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.