.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================ EXT: Mailform new generation ============================ :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: LAVAL Carine :Changed: 2009-03-24T10:51:54.210000000 :Classification: mailform_new_generation :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: forEditors, forAdmins, forBeginners, forIntermediates, mail, form, mailform :Author: Alienor.net Dev Team :Email: typo3@alienor.net :Info 4: :Language: en |img-1| |img-2| EXT: Mailform new generation - mailform\_new\_generation .. _EXT-Mailform-new-generation: EXT: Mailform new generation ============================ Extension Key: mailform\_new\_generation Language: en Keywords: forEditors, forAdmins, forBeginners, forIntermediates, mail, form, mailform Copyright 2000-2008, Alienor.net Dev Team, 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.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: Mailform new generation 1 <#1.EXT:%20Mailform%20new%20generation|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 5 <#1.3.Users%20manual|outline>`_** **`Configuration 6 <#1.4.Configuration|outline>`_** `Reference 6 <#1.4.1.Reference|outline>`_ **`Known problems 7 <#1.5.Known%20problems|outline>`_** **`To-Do list 8 <#1.6.To-Do%20list|outline>`_** **`ChangeLog 9 <#1.7.ChangeLog|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - This extension essentially makes typo3 standard mailform accessible with server checks, and fancy layout on fields with errors. The main reason for developing it was the assumption that the javascript-based form checking was a very bad idea in the default form object. - It also adds an automatic reply option with configurable reply message on a form-to-form basis (new fields to tt\_content) - Make possible to add captcha based on mathematical operations - The sent messages (normal form mail and automatic message) are templatable via a template file. .. _Screenshots: Screenshots ^^^^^^^^^^^ (Be careful with email fields : don't forget to use the required validators (like EMAIL) as described in the tsref : `http://documentation.typo3.org/documentation/tsref/cobjects/form/ `_ ) This is how the new fields are rendered when editing or creating a form record in the backend : |img-3| This is how the default form is rendered in the frontend (here with errors). The form is unstyled by default but different classes are defined to style it : |img-4| .. _Users-manual: Users manual ------------ - The only new options from the user's point of view are : - Whether an automatic reply message must be sent to the user. This option is rendered as a “Send an automatic reply to the user?” checkbox in the form content record. - In the case a reply must be sent, the message must be defined in the new field “Message sent with the automatic reply”. - If the automatic reply is activated, there must be a field named “from\_email” to which the reply will be sent. The default mail will be sent using this address too. - If you want to add captcha : - there must be a field named “captcha”; - the field's label must contain “%s” : that's represent the mathematical operation to solve. - The page on which the form is placed can be cached (it is not mandatory to check the “No cache” checkbox in the page properties). .. _Configuration: Configuration ------------- - Important notice : This extension extends the “tslib\_cObj” class. Therefore, it is incompatible with other extensions that extend this same class. - All important configuration options of the normal FORM object are still available with mailform\_new\_generation. .. _Reference: Reference ^^^^^^^^^ .. _Reference-TypoScript: Reference (TypoScript) """""""""""""""""""""" Typoscript configuration is mainly made by changing the tt\_content.mailform.20 object. .. ### BEGIN~OF~TABLE ### .. _templateFile: templateFile ~~~~~~~~~~~~ .. container:: table-row Property templateFile Data type resource Description Contains the templates for the default mail and the automatic reply Default EXT:mailform\_new\_generation/res/mailform\_ng\_mail.html .. ###### END~OF~TABLE ###### [tsref:tt\_content.mailform.20] .. _Template: Template """""""" The default mail template contains 4 markers : - ###SUBJECT### - Subject of the mail - ###LABEL### - Label of a field - ###VALUE### - Value of a field - ###SPACE### - Conditional newline if the value is longer than 60 char The automatic reply message template contains 2 markers : - ###AUTOREPLY\_MSG### - Message entered in the form record via the backend - ###SENT\_FIELDS### - Reproduction of the form result This last marker must be used with caution, ideally with a captcha, because it may be used for SPAM (automatic mail sent to any address chosen by the malicious user). It is deactivated by default. .. _Known-problems: Known problems -------------- None for the moment. .. _To-Do-list: To-Do list ---------- - Make this extension independent of an x-class of tslib\_cObj - Finetuning of the automatic reply parameters .. _ChangeLog: ChangeLog --------- 09-03-05\* Captcha added - 08-12-02\* By default, the automatic reply does not include the fields contents anymore - 08-11-03\* Automatic reply added - 08-10-31\* Mail templates added - 08-10-29\* Move to COA\_INT (do not need no\_cache parameter anymore)\* Mandatory file input has been taken into account - 08-02-26\* Initial release 9 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 535 .. :id: images1 .. :name: images1 .. :width: 518 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 255 .. :id: images2 .. :name: images2 .. :width: 545