EXT:form_tools is a little collection of tools to extend TYPO3's EXT:form. Currently this extension contains a finisher to store all form fields as XML only.

Extension Manual

This documentation is for the TYPO3 extension form_tools.

Introduction

What does it do?

EXT:form_tools contains a collection of tools for TYPO3's EXT:form:

It contains an extended version of SaveToDatabase finisher called StoreFieldsAsXmlToDb which additionally stores all form fields into a xml-column of the DB table.

Use the table garbage collection task of TYPO3 to remove entries older than 30 days.

Installation

Installation Type

Composer

You can install form_tools with following shell command:

composer req jweiland/form-tools

Extensionmanager

If you want to install form_tools traditionally with Extensionmanager, follow these steps:

Visit ExtensionManager
Switch over to Get Extensions
Search for form_tools
Install extension

DEV Version (GIT)

You can install the latest DEV Version with following GIT command:

git clone https://github.com/jweiland-net/form_tools.git

Configuration

Finisher

StoreFieldsAsXmlToDb

First of all you have to load our YAML file which contains a configuration to register our finisher to EXT:form

plugin.tx_form.settings.yamlConfigurations.1611907550 = EXT:form_tools/Configuration/Form/StoreAsXml.yaml
module.tx_form.settings.yamlConfigurations.1611907551 = EXT:form_tools/Configuration/Form/StoreAsXml.yaml

Now you can use our finisher with the same configuration which is valid for SaveToDatabase finisher of EXT:form

finishers:
  -
    options:
      table: 'tx_formtools_requests'
      mode: 'insert'
      elements:
        email-1:
          mapOnDatabaseColumn: 'email'
        textarea-1:
          mapOnDatabaseColumn: 'content'
      databaseColumnMappings:
        subject:
          value: 'Default Subject from YAML'
        pid:
          value: 1
        tstamp:
          value: '{__currentTimestamp}'
        crdate:
          value: '{__currentTimestamp}'
    identifier: StoreFieldsAsXmlToDb

Set the value of pid to your page/folder where the mails should be found in the Backend.

Renderables

Checkboxlink

First of all you have to load our YAML file which contains a configuration to register our form element to EXT:form

plugin.tx_form.settings.yamlConfigurations.2345 = EXT:form_tools/Configuration/Form/Checkboxlink.yaml

Now you can use our form element of EXT:form

renderables:
   -
     type: Checkboxlink
     identifier: dsgvo
     label: 'Datenschutzerklärung gelesen'
     validators:
       -
         identifier: NotEmpty
     properties:
       value: '1'
       fluidAdditionalAttributes:
         required: required