Deprecation: #80420 - EmailFinisher single address options

Description

The EmailFinisher of EXT:form has options to set multiple recipients for To, CC and BCC. For consistency reasons and to limit the number of choices, resulting in easier configuration, the single value configuration options have will be removed in favour for their respective multi value variants.

For this reason, the following options have been marked as deprecated and will be removed in TYPO3 11.0:

• recipientAddress
• recipientName
• replyToAddress
• carbonCopyAddress
• blindCarbonCopyAddress

If any of these options are used, their values will be automatically migrated to their replacements.

Opening and saving a form with the form editor once also performs this migration and makes it permanent.

Impact

Any of these options will no longer work in TYPO3 11.0.

Affected Installations

All installations which use EXT:form and its EmailFinisher.

Migration

All single value options must be migrated to their list value successors.

finishers:
  -
    identifier: EmailToReceiver
    options:
      recipientAddress: to@example.org
      recipientName: 'To Example'

finishers:
  -
    identifier: EmailToReceiver
    options:
      recipients:
        to@example.org: 'To Example'

finishers:
  -
    identifier: EmailToReceiver
    options:
      replyToAddress: rt@example.org

finishers:
  -
    identifier: EmailToReceiver
    options:
      replyToRecipients:
        rt@example.org@example.org: 'Reply-To Example'

finishers:
  -
    identifier: EmailToReceiver
    options:
      carbonCopyAddress: cc@example.org

finishers:
  -
    identifier: EmailToReceiver
    options:
      carbonCopyRecipients:
        cc@example.org: 'CC Example'

finishers:
  -
    identifier: EmailToReceiver
    options:
      blindCarbonCopyAddress: bcc@example.org

finishers:
  -
    identifier: EmailToReceiver
    options:
      blindCarbonCopyRecipients:
        bcc@example.org: 'BCC Example'