Extension Form email contentblocks 

Classification

form email contentblocks

Version

3.0

Language

English

Description

Manual covering the TYPO3 extension "form_email_contentblocks".

Keywords

form,email,introduction,signature,content,finisher,fluidemail,extend

Copyright

2023

Author

Manuel Schnabel

Email

service@passionweb.de

License

This document is published under the Open Publication License available from http://www.opencontent.org/openpub/

Rendered

Wed, 24 Dec 2025 15:50:09 +0000

The content of this document is related to TYPO3, a GNU/GPL CMS/Framework available from www.typo3.org.

Table of Contents

Introduction 

Features 

  • Add a content element at the beginning of the email to receiver template
  • Add a content element at the beginning of the email to sender template
  • Add a content element at the end of the email to receiver template
  • Add a content element at the end of the email to sender template
  • Edit the background color and logo (relative fileadmin paths and extension paths are possible) of the fluid email template for sender and receiver
  • Set form variables that are automatically replaced with the sender's data in the email templates (since version 1.1.0)

What does this extension do? 

This extension provides additional finishers for the TYPO3 system extension "Form" ([EXT:form](https://docs.typo3.org/c/typo3/cms-form/11.5/en-us/Index.html "EXT:form")). In order for this extension to work as desired, the extension must be installed and configured correctly.

Following finishers are available:

  • IntroductoryReceiverFinisher (Adds a content element at the beginning of the email to receiver template)
  • IntroductorySenderFinisher (Adds a content element at the beginning of the email to sender template)
  • SignatureReceiverFinisher (Adds a content element at the end of the email to receiver template)
  • SignatureSenderFinisher (Adds a content element at the end of the email to sender template)
  • ExtendFluidEmailFinisher (Edit the background color and logo of the fluid email template for sender and receiver)

All previous finishers must be placed in front of the associated email finishers (EmailToSender or EmailToReceiver). Otherwise the corresponding content blocks are ignored. The same applies to the ExtendFluidEmailFinisher variables.

For each finisher, the corresponding notes are also displayed in the header of the respective finisher.

Troubleshooting and logging 

If something does not work as expected take a look at the log file first. Every problem is logged to the TYPO3 log (normally found in var/log/typo3_*.log).

If something still doesn't work as desired after checking the logs, feel free to contact me.

Important notes 

This extension does not override any of the default EXT:form finisher classes, as it uses the FinisherVariableProvider object to share variables between finishers.

But the default email templates are overwritten. If you use several extensions that overwrite the default email templates of EXT:form, conflicts can arise.

Achieving more together or Feedback, Feedback, Feedback 

I'm grateful for any feedback! Be it suggestions for improvement, extension requests or just a (constructive) feedback on how good or crappy the extension is.

Feel free to send me your feedback to service@passionweb.de or contact me on Slack

Administration Manual 

Target group: Administrators

Requirements 

This extension provides additional finishers for the TYPO3 system extension "Form" (EXT:form). In order for this extension to work as desired, the extension must be installed and configured correctly.

Installation 

Add via composer.json:

composer require "passionweb/form-email-contentblocks"
Copied!
  • Install the extension via composer
  • Flush TYPO3 and PHP Cache

Extension configuration (TypoScript) 

All necessary configurations are read in using the ExtensionManagementUtiltity:addTypoScript() function within ext_tables.php.

plugin.tx_form.settings.yamlConfigurations {
    1673535916 = EXT:form_email_contentblocks/Configuration/Yaml/BaseSetup.yaml
}

module.tx_form.settings.yamlConfigurations {
    1673535916 = EXT:form_email_contentblocks/Configuration/Yaml/BaseSetup.yaml
    1673535917 = EXT:form_email_contentblocks/Configuration/Yaml/FormEditorSetup.yaml
}
Copied!

Editors Manual 

Target group: Editors

How editors can/should use the extension 

  1. Create new or edit an existing form
  2. Add the finisher(s) you want to use (and place them in the right order)
  1. Save the form

Set form variables 

Since version 1.1.0 it is possible to use form variables in the content elements or the text fields for the plaintext. You can use it in the same way as in the finisher configurations.

Known Problems 

There are currently no known issues. If you encounter one please file a report at issue tracker.