Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

Chapter 1. EXT: FE extended mailform functionality

Version 3.9.0

Extension Key: th_mailformplus

Copyright 2000-2006, Peter Luser, <peter@typoheads.com>

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

First of all:

Many thanks to all the people who supported me and helped improving this extension!

What does it do?

When you reach the limits of the standard mailform functionality of typo3 (especially when you want the form to look special) you can use this module to use your conventional HTML-formulars (as HTML-snippets) with full mailform functionality.

  1. Displays your conventional HTML-form

  2. checks fields that have to be filled out – displays error message (you can specify the fields you want to check)

  3. sends all fields with the values to one or more emailaddresses (also configrable)

  4. if successful: it does a redirect to a page (also configurable)

  5. full javascript support for validating fields before the form is submitted (has to be implemented manually in the HTML snippet containing the form)

  6. current languages: englisch, german, italian (since 2.4.0)

  7. you can send a special formatted email to the user himself e.g. “confirmation” or “thank you for your interst, we will contact you soon”

  8. you can automatically fill out the form with the data of the frontend user who is logged in. (since 2.4.0)

  9. submitted data is stored in the database and can be exported via .csv file (since 3.0)

  10. data can be stored in a DB table of your choice (can be configured via TypoScript) plus file upload support: user can upload a file (you can limit type and size via typoscript) (since 3.1)

  11. extended error messages: you can define your own error messages for the fields (since 3.1)

  12. build dynamic input forms with the use of TypoScript (since 3.4)

  13. “secure” mailform with captcha support (ext: “captcha”) (since 3.7)

  14. multipage forms (since 3.9)

  15. HTML mails, plaintextmails, multipart mails (HTML+plain) (since 3.9)

  16. server side error check (since 3.9)

  17. better file upload handling (since 3.9)

  18. summary of submitted form on the “thank you” page via PRINT-subtemplate stored in session (since 3.9)

New in version 3.9.0

  1. multipage forms (attention: only works with JavaScript enabled, special naming requirements within template)

  2. sending mails: HTML, plain, HTML+ plain (multipart). special thx to Andreas Westermaier!

  3. server side error check: defined via TypoScript. predefined checks like “email”, “integer”,.. built in. advanced error checks via regular expression can be defined.

  4. file uploads: file size, type upload directory can be defined per upload field via TypoScript.

  5. PRINT-template showing a summary of the submitted form on the “thank you” page (note: since this template is stored in session data, it has to be printed out via a user-function)

  6. all values are now automatically stripslashes() and htmlspecialchars() transformed to prevent code injection

New in version 3.8.0

  1. TYPO3 4.0 compatible (path to tslib directory)

  2. template-file: reference to file can be stored instead of making a copy

  3. new TypoScript setting:saveDB.if_is_empty.[fieldname] = [value if field is not filled out]

  4. log-table: field "date" changed to "logdate" (typ:timestamp)

  5. example mailform provided in "example_form/" directory

  6. "email from" field can have blanks now: "my real name" <email@domain.com>

  7. bugfix: PHP 4.4.2. header(..."\n\n") fixed

  8. bugfix: export to csv: first line shows field descriptions for sure

  9. bugfix: if no files uploaded: error was shown

Screenshots

Frontend multipage form with 3 steps:

Backend module: