README

Form_tools是一个用于TYPO3 CMS的扩展。它收集了一些TYPO3 FormFramework的工具。

1 特性

• 它包含一个表单结束器，用于将所有表单字段以XML结构存储到数据库中
• 它包含一个表单元素，用于在您的表单中设置GDPR链接（与表单编辑器兼容）

2 使用方法

2.1 安装

使用Composer安装

推荐使用Composer安装扩展。

在基于Composer的TYPO3项目中运行以下命令

composer require jweiland/form-tools

从TYPO3扩展仓库（TER）作为扩展安装

使用扩展管理模块下载并安装form_tools

2.2 最小配置

1. 检查数据库表tx_formtools_requests是否已成功创建
2. 打开您的TypoScript文件或记录
3. 添加：plugin.tx_form.settings.yamlConfigurations.1234 = EXT:form_tools/Configuration/Form/StoreAsXml.yaml
4. 现在您可以使用标识符为StoreFieldsAsXmlToDb的结束器
5. 添加：plugin.tx_form.settings.yamlConfigurations.2345 = EXT:form_tools/Configuration/Form/Checkboxlink.yaml
6. 添加：module.tx_form.settings.yamlConfigurations.2345 = EXT:form_tools/Configuration/Form/Checkboxlink.yaml
7. 添加

    lib.formLegalUid = TEXT
    lib.formLegalUid.value = 1 # or e.g.: {$form.legalUid}
   

   到您的SETUP中，并定义“数据保护通知”链接的目标。
8. 现在您可以使用类型为Checkboxlink的表单元素

2.3 StoreFieldsAsXmlToDb结束器

将结束器复制到您的表单YAML文件中。

  -
    options:
      -
        table: tx_formtools_requests
        mode: insert
        elements:
          text-1:
            mapOnDatabaseColumn: first_name
          name:
            mapOnDatabaseColumn: last_name
          telefon:
            mapOnDatabaseColumn: telephone
          strasse:
            mapOnDatabaseColumn: address
          plzort:
            mapOnDatabaseColumn: city
          email:
            mapOnDatabaseColumn: email
          textarea-2:
            mapOnDatabaseColumn: message
        databaseColumnMappings:
          pid:
            value: 12107
          tstamp:
            value: '{__currentTimestamp}'
          crdate:
            value: '{__currentTimestamp}'
    identifier: StoreFieldsAsXmlToDb

• 一些字段如first_name到message已存在于数据库中。您可以将可渲染映射到它们。
• 设置邮件应保存的pid（例如，与插件相同的位置）。
• 数据库字段xml将自动包含所有提交的数据。