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


=======================
EXT: Smile Form Archive
=======================

:Author:
      Kasper Skårhøj

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

:Changed:
      2007-11-26T18:37:56

:Author:
      Smile

:Email:
      typo3@smile.fr

:Info 3:


:Info 4:


.. _EXT-Smile-Form-Archive:

EXT: Smile Form Archive
=======================

Extension Key:  **smile\_form\_archive**

Copyright 2007, Smile, <typo3@smile.fr>

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

.. _Table-of-Contents:

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

**EXT: Smile Form Archive 1**

**Introduction 1**

What does it do? 1

Screenshots 1

**Users manual 2**

**To-Do list 3**

**Changelog 3**


.. _Introduction:

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


.. _What-does-it-do:

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

The extension Smile Form Archive saves the content of submitted forms
into Typo3 data records in a human-readable format.

If this extension is placed on a page which receives the data of a
html form (in particular a Typo3 mailform), it automatically saves all
the transmitted data into a data record. The data records can be
viewed in the Typo3 backend in “List” mode.

Other actions, which are normally triggered by the form submit, are
not affected by this plugin. Though it's inserted as a content element
on a page, it doesn't generate any output in the frontend.


.. _Screenshots:

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

An example record with the data submitted from a standard Typo3
mailform.

|img-1|

The plugin inserted on the confirmation page of a mailform :

|img-2|


.. _Users-manual:

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

The installation of this extension is really simple :

If not already done, create a page where the form data records should
later be stored by the plugin. Generally, a “SysFolder” type page
should be used for this purpose.

Insert the plugin on the page which  **receives** the form data. For a
standard Typo3 mailform, this is the page configured at “ **Jump to
page** ” in the mailform plugin record settings.

In the plugin configuration, set the (previosly created) page as
“Archive record storage page”.

Optionally you can select the “mailform” element which sends the
content to this page. If this is specified, the recipient email
address is extracted from the mailform and saved in the data record.

If you like the user IP address to be stored in the data record, check
the corresponding checkbox.

Save and you're done!

Once inserted, the plugin will listen to all POST form data submitted
to this page and save it in the configured page. It won't produce any
output itself. (However, if you fill in the field “Header”, it might
be shown.)

Note: The Typo3 following variables are internal mailform variables
and won't be stored: “html\_enabled”, “subject”, “locationData”,
“formtype\_mail”.

The data records can thus subsequently consulted in “List” mode on the
page chosen as “Archive record storage page”.


.. _To-Do-list:

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

- Configurable list of fields to exclude

- Configurable data storage format (XML, CSV, ...)

- Possibility to configure some settings globally (using TypoScript or
  constants)


.. _Changelog:

Changelog
---------

\- 26 nov. 2007 : First public release

|img-3| EXT: Smile Form Archive - 3


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

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 372
.. :id: Image1
.. :name: Image1
.. :width: 582

.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 303
.. :id: Image2
.. :name: Image2
.. :width: 636

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