andreaskiessling/form-dynamic-recipient

Adds new form select type, which shows recipient records of a given page. This information can be used as dynamic recipient for the form data.

v4.1.0 2026-01-12 17:14 UTC

Requires

• typo3/cms-core: ^13.4
• typo3/cms-form: ^13.4

Requires (Dev)

• phpstan/phpstan: ^1.10
• saschaegerer/phpstan-typo3: ^1.8.4

GPL-2.0+

• Andreas Kießling

README

This extension adds simple database records, that can be used to generate a select field in the frontend. The selected option can be accessed with an assigned alias and thus be used as a dynamic recipient, e.g. in the Recipient address field.

Use the old release from extrameile/form-dynamic-recipient if you need support for TYPO3 <= 12.4. Further development and support will happen in this repository.

Installation via composer

composer require andreaskiessling/form-dynamic-recipient

Setup

The backend module TypoScript should be automatically loaded through ext_localconf.php

Without Site Sets

The ext_typoscript_setup.typoscript should provide the yaml inclusion for the frontend output.

With Site Sets

Either include the config manually

@import 'EXT:form_dynamic_recipient/Configuration/TypoScript/setup.typoscript'

or use the provided Set with the dependency for typo3/form

dependencies:
  - andreaskiessling/formdynamicrecipient

Usage

• Create database records with a label and target email address
• add a select field of type Selectable recipient to the form, configure the page to load the values from and the variable to fill with the selected value: dynamicRecipient is preset when adding the field and is not configurable in the form manager, only directly in the YAML file
• New with version 3.x: leave the page field empty in the form yaml to load the recipients from the page with the form plugin
• Configure the Email to receiver finisher with {dynamicRecipient.email} and {dynamicRecipient.label} - set the form field to required, if you use {dynamicRecipient.email} as the target email address.

Running phpstan

.Build/bin/phpstan analyse --memory-limit=1G -l6 .

Resources

• https://daniel-siepmann.de/Posts/2017/2017-09-07-typo3-form-select-with-db-values.html
• https://github.com/tritum/form_element_linked_checkbox

Contributors

Thanks to Thomas Löffler (spoonerWeb) and Hawkeye1909 for your contributions!