Email finisher 

Using email finishers in the backend form editor 

Editors can use two email finishers in the backend form editor:

Email to sender (form submitter)

This finisher sends an email with the contents of the form to the user submitting the form .

Email to receiver (you)

This finisher sends an email with the contents of the form to the owner of the website. The settings of this finisher are the same as the "Email to sender" finisher

Options of the email finisher 

Additional email finisher options 

Additional options can be set in the form definition YAML and programmatically in the options array but not in the backend editor:

Email finishers in the YAML form definition 

This finisher sends an email to one recipient. EXT:form has two email finishers with identifiers EmailToReceiver and EmailToSender.

identifier: example-form
label: 'example'
type: Form

finishers:
  -
    identifier: EmailToReceiver
    options:
      subject: 'Your message'
      recipients:
        your.company@example.com: 'Your Company name'
        ceo@example.com: 'CEO'
      senderAddress: 'form@example.com'
      senderName: 'form submitter'

Using Email finishers in PHP code 

Developers can create a confirmation finisher by using the key EmailToReceiver or EmailToSender.

<?php

use TYPO3\CMS\Form\Domain\Model\FormDefinition;

class SomeClass
{
    private function addEmailToReceiverFinisher(FormDefinition $formDefinition)
    {
        $formDefinition->createFinisher('EmailToReceiver', [
            'subject' => 'Your message',
            'recipients' => [
                'your.company@example.com' => 'Your Company name',
                'ceo@example.com' => 'CEO'
            ],
            'senderAddress' => $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'],
            'senderName' => $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromName'],
        ]);
    }
}

This finisher is implemented in \TYPO3\CMS\Form\Domain\Finishers\EmailFinisher .

Working with BCC recipients 

Email finishers can work with different recipient types, including Carbon Copy (CC) and Blind Carbon Copy (BCC). Depending on the configuration of your server and TYPO3 instance, it may not be possible to send emails to BCC recipients. The $GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_sendmail_command'] configuration value is important here. As documented in CORE API, TYPO3 recommends using the parameter -bs (instead of -t -i) with sendmail. The parameter -bs tells TYPO3 to use the SMTP standard so that BCC recipients are properly set. Symfony also mentions the -t parameter problem. Since TYPO3 7.5 (#65791) the transport_sendmail_command is automatically set from the PHP runtime configuration and saved. If you have problems sending emails to BCC recipients, this could be the solution.

About FluidEmail 

The FluidEmail finisher allows emails to be sent in a standardized way.

The finisher has an option property title that adds an email title to the default FluidEmail template. Variables can be used in options using the bracket syntax. These variables can be overwritten by FlexForm configuration in the form plugin

Use these options to customize the fluid templates:

• templateName: The template name (for both HTML and plaintext, without the extension)
• templateRootPaths: The paths to the templates
• partialRootPaths: The paths to the partials
• layoutRootPaths: The paths to the layouts

Here is an example finisher configuration:

identifier: contact
type: Form
prototypeName: standard
finishers:
  -
    identifier: EmailToSender
    options:
      subject: 'Your Message: {message}'
      title: 'Hello {name}, your confirmation'
      templateName: ContactForm
      templateRootPaths:
        100: 'EXT:my_site_package/Resources/Private/Templates/Email/'
      partialRootPaths:
        100: 'EXT:my_site_package/Resources/Private/Partials/Email/'
      addHtmlPart: true

These template files must exist:

• EXT:my_site_package/Resources/Private/Templates/Email/ContactForm.html
• EXT:my_site_package/Resources/Private/Templates/Email/ContactForm.txt