heimrichhannot / contao-submissions
A generic module to store and handle submissions in contao.
Installs: 9 076
Dependents: 3
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 1
Open Issues: 0
Type:contao-bundle
pkg:composer/heimrichhannot/contao-submissions
Requires
- php: ^8.2
- contao/core-bundle: ^5.3
- heimrichhannot/contao-form-type-bundle: ^0.1 || ^0.2
- heimrichhannot/contao-utils-bundle: ^3.6
- terminal42/notification_center: ^2.0
- v2.x-dev
- 2.0.0-beta.7
- v2.0.0-beta.6
- v2.0.0-beta.5
- v2.0.0-beta.4
- v2.0.0-beta.3
- v2.0.0-beta.2
- v2.0.0-beta.1
- v1.x-dev
- 1.24.1
- 1.24.0
- 1.23.6
- 1.23.5
- 1.23.4
- 1.23.3
- 1.23.2
- 1.23.1
- 1.23.0
- 1.22.0
- 1.21.4
- 1.21.3
- 1.21.2
- 1.21.1
- 1.21.0
- 1.20.4
- 1.20.3
- 1.20.2
- 1.20.1
- 1.20.0
- 1.19.1
- 1.19.0
- 1.18.1
- 1.18.0
- 1.17.0
- 1.16.0
- 1.15.1
- 1.15.0
- 1.14.0
- 1.13.0
- 1.12.0
- 1.11.0
- 1.10.0
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.2
- 1.6.1
- 1.6.0
- 1.5.8
- 1.5.7
- 1.5.6
- 1.5.5
- 1.5.4
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.9
- 1.4.8
- 1.4.7
- 1.4.6
- 1.4.5
- 1.4.4
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.13
- 1.3.12
- 1.3.11
- 1.3.10
- 1.3.9
- 1.3.8
- 1.3.7
- 1.3.6
- 1.3.5
- 1.3.4
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.45
- 1.0.44
- 1.0.43
- 1.0.42
- 1.0.41
- 1.0.40
- 1.0.39
- 1.0.38
- 1.0.37
- 1.0.36
- 1.0.35
- 1.0.34
- 1.0.33
- 1.0.32
- 1.0.31
- 1.0.30
- 1.0.29
- 1.0.28
- 1.0.27
- 1.0.26
- 1.0.25
- 1.0.24
- 1.0.23
- 1.0.22
- 1.0.21
- 1.0.20
- 1.0.19
- 1.0.18
- 1.0.17
- 1.0.16
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.0
- dev-master
- dev-feature/opt-in-event
- dev-feature/formgenerator
- dev-feature/replace_haste
This package is auto-updated.
Last update: 2025-10-22 14:46:16 UTC
README
A generic module to store and handle submissions in Contao. You can use it with all of your modules to simplify submission handling.
Features
- Directly store form generator submissions.
- Submissions organized in archives using a dedicated DCA.
- Highly customizable: define new fields on the data container.
- Auto-creates palettes for your fields.
- Feature set includes opt-in process, permissions handling and (csv) export.
- Notification Center 2.0 support (terminal42/contao-notification_center)
Install
- Install with composer or contao manager
composer require heimrichhannot/contao-submissions
- Update database
Usage
In the backend, you will find a new menu item called “Submissions”. Create a new archive with a title and select the fields that should be contained in your submissions.
Form generator
You can save your form generator submissions directly as a submission. Simply activate "Save as submission" and select the submission archive. The names of the form fields must be the same as the field names of the saved entity.
Use ##form_attachment_*##
tokens in your notification center notifications to include attachments in your emails.
Opt in process
Use the built-in double opt-in process to verify submissions.
Create an opt-in challenge notification in notification center and select it on your form in the form generator.
You can also define a jump to page to which the user is redirected when the opt-in is successful.
If you want to bump a property at successful opt-in, set a boolean confirmation field (i.e. to set the field publish
to true).
Use the following notification tokens in the opt-in notification:
Token | Description |
---|---|
##optin_token## |
To be replaced with the opt-in token |
##optin_url## |
To be replaced with the absolute opt-in url |
##email## |
Same as ##form_email## , but guaranteed to be in a valid email address format. Intended use as recipient email address. |
Export
Active "Allow export" in the submission archive settings to enable CSV export of submissions. Afterwards you will find an "Export" button in the submission list view.
Development
Fields on tl_submission
Take a look at dca/tl_submission.php
for all available fields.
Adjust the dca to your needs.
Mark fields as noSubmissionField
to make them unavailable for use as submission fields.
$dca = &$GLOBALS['TL_DCA']['tl_submission']; $dca['fields']['my_field']['eval']['noSubmissionField'] = true;
Events
Event | Description |
---|---|
SubmissionsBeforeSendConfirmationNotificationEvent | Dispatched before success notification is sent. Requires enabled double opt-in. |