.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


========================
EXT: Confirm formresults
========================

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed:
      2005-09-14T16:20:01

:Author:
      Rupert Germann

:Email:
      rupi@gmx.li

:Info 3:


:Info 4:


.. _EXT-Confirm-formresults:

EXT: Confirm formresults
========================

Extension Key:  **nc\_formresults**

Copyright 2000-2002, Rupert Germann, <rupi@gmx.li>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

**Sponsoring: Netcreators, Netherlands**

The content of this document is related to TYPO3

\- a GNU/GPL CMS/Framework available from www.typo3.com

.. _Table-of-Contents:

Table of Contents
-----------------

**EXT: Confirm formresults 1**

**Introduction 1**

What does it do? 1

Screenshots 1

**Users manual 2**

FAQ 3

**Configuration 3**

Reference 3

**Known problems 3**

**To-Do list 3**

**Changelog 3**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This extension extends the “Form” content element by the possibility
to show the data a user has inserted in a form before actually
submitting them to the TYPO3 mailer. After having verified the data
the user can submit or cancel the submission of the mailform.


.. _Screenshots:

Screenshots
^^^^^^^^^^^

A “Form” content-element with the new field “Display formdata before
submit”:

|img-1|

Confirmation form on the website:

|img-2|


.. _Users-manual:

Users manual
------------

Install the extension with the extension manager.

Include the static TypoSript template from the extension: "Display
form data (nc\_formresults)" to your TS template on the page where
your form is used.

For a first test create or open a “Form” content-element. You'll find
a new field below the field “Recipient-email” where you can activate
the formdata confirmation. Check this field and add some fields to the
form (make sure that the the submit button is called “formtype\_mail”
- this involves the TYPO3 mailer engine).

Include the variables you use in your mailform in the constant editor.
You use the fields here like you name them in the form.

|img-3|


.. _FAQ:

FAQ
^^^

nothing yet


.. _Configuration:

Configuration
-------------

if you want to change the layout of the form it is important that the
changes are written to a TS template which is parsed before the staic
extension template is included.


.. _Reference:

Reference
^^^^^^^^^

TypoScript setup:

.. ### BEGIN~OF~TABLE ###


.. _showVarsList:

showVarsList
""""""""""""

.. container:: table-row

   Property
         showVarsList
   
   Data type
         string
   
   Description
         list of vars to show in the confirm page. (Default value is set in the
         Constant editor)
   
   Default
         name,email



.. _data-stdWrap:

data\_stdWrap
"""""""""""""

.. container:: table-row

   Property
         data\_stdWrap
   
   Data type
         ->stdWrap
   
   Description
         Wraps the whole confirmation data
         
         **Example:**
         
         (default setup)
         
         ::
         
            plugin.tx_ncformresults {
              data_stdWrap.wrap = <dl id="ncformresults">|</dl>
              names_stdWrap.wrap = <dt>|</dt>
              values_stdWrap.wrap = <dd>|</dd>
              fileNames_stdWrap.wrap = <dd>|</dd>
              confirmHeader_stdWrap.wrap = <strong>|</strong>
            }
   
   Default



.. _names-stdWrap:

names\_stdWrap
""""""""""""""

.. container:: table-row

   Property
         names\_stdWrap
   
   Data type
         ->stdWrap
   
   Description
         Wraps the names
   
   Default



.. _values-stdWrap:

values\_stdWrap
"""""""""""""""

.. container:: table-row

   Property
         values\_stdWrap
   
   Data type
         ->stdWrap
   
   Description
         Wraps the values
   
   Default



.. _fileNames-stdWrap:

fileNames\_stdWrap
""""""""""""""""""

.. container:: table-row

   Property
         fileNames\_stdWrap
   
   Data type
         ->stdWrap
   
   Description
         Wraps the filenames in case the form offers fileupload
   
   Default



.. _Unknown-Property:

((Unknown Property))
""""""""""""""""""""

.. container:: table-row

   Property
   
   
   Data type
   
   
   Description
   
   
   Default


.. ###### END~OF~TABLE ######

[tsref:plugin.tx\_ncformresults


.. _Known-problems:

Known problems
--------------

nothing yet


.. _To-Do-list:

To-Do list
----------

nothing yet


.. _Changelog:

Changelog
---------

- v0.1.1 small improvement for the TS setup

- v0.1.0 first public version

- v0.0.3 added manual

- v0.0.2 Fixed wrapping of submit and cancel button

- v0.0.1: Moved all Labels to a locallang file.

|img-4| EXT: Confirm formresults - 3


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 286
.. :id: Grafik1
.. :name: Grafik1
.. :width: 309

.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 213
.. :id: Grafik3
.. :name: Grafik3
.. :width: 308

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 208
.. :id: Grafik2
.. :name: Grafik2
.. :width: 516

.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102