terminal42 / contao-leads
Leads extension for Contao Open Source CMS; Store and manage form data with ease!
Fund package maintenance!
terminal42
Other
Installs: 114 350
Dependents: 8
Suggesters: 4
Security: 0
Stars: 33
Watchers: 11
Forks: 23
Open Issues: 7
Type:contao-bundle
Requires
- php: ^8.1
- codefog/contao-haste: ^5.0
- contao/core-bundle: ^4.13 || ^5.0
- menatwork/contao-multicolumnwizard-bundle: ^3.6
- phpoffice/phpspreadsheet: ^1.26
Requires (Dev)
- contao/manager-plugin: ^2.0
- terminal42/contao-build-tools: dev-main
Suggests
- dompdf/dompdf: Export leads to PDF document (using Dompdf)
- mpdf/mpdf: Export leads to PDF document (using mPDF)
- tecnickcom/tcpdf: Export leads to PDF document (using TCPDF)
Conflicts
- contao/manager-plugin: <2.0 || >=3.0
- dev-main
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- v1.x-dev
- 1.4.33
- 1.4.32
- 1.4.31
- 1.4.30
- 1.4.29
- 1.4.28
- 1.4.27
- 1.4.26
- 1.4.25
- 1.4.24
- 1.4.23
- 1.4.22
- 1.4.21
- 1.4.20
- 1.4.19
- 1.4.18
- 1.4.17
- 1.4.16
- 1.4.15
- 1.4.14
- 1.4.13
- 1.4.12
- 1.4.11
- 1.4.10
- 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.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.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- dev-haste-5
- dev-develop
This package is auto-updated.
Last update: 2024-04-15 12:01:11 UTC
README
terminal42/contao-leads is an extension for the Contao CMS.
It allows you to store submissions from the Contao form generator into the database without the need to create tables for each form. Leads can then be viewed in the back end as well as exported into various formats (e.g. CSV or Excel).
If multiple identical forms exist (e.g. in different languages), lead data can be grouped by the main form (e.g. your fallback language). This allows to view and export data as if it was just one form.
Installation
Choose the installation method that matches your workflow!
Installation via Contao Manager
Search for terminal42/contao-leads in the Contao Manager and add it to your installation. Finally, update the
packages.
Manual installation
Add a composer dependency for this bundle. Therefore, change in the project root and run the following:
composer require terminal42/contao-leads
Depending on your environment, the command can differ, i.e. starting with php composer.phar … if you do not have
composer installed globally.
Configuration
Initial configuration can be done in the form generator of Contao. Do not forget to activate the fields you want to save! In the form configuration, you can set a label for the back end menu link of your leads and define the listing of the form data using simple tokens.
To configure exports, first make sure you have at least one form submission. A global operation to configure exports is then available when viewing the lead data.
Permissions
For users that are not admins of the system, permissions need to be set up to access leads. Enable access to the leads back end module and select the forms of which lead data should be available. If the user does not need to configure the form itself, you don't need to give access to the form generator!
You can additionally configure if a user is allowed to edit or delete existing leads.
Simple Tokens
Contao Simple Tokens are used to generate the back end list and as well as for customized exports.
All saved form fields are available by their field name. For example, if you created a text field with name firstname,
you can output its value in the back end list or the export using the ##firstname## simple token.
Additionally, the following simple tokens are providing data of the lead itself, rather than the data submitted through the form generator.
- ##_id##
- Database ID of the lead record.
- ##_created##
- Date and time when the lead was saved (when the form was submitted).
- ##_form
- Database ID (and title) of the form that was submitted.
- ##_member##
-
ID of the front end member that was logged in while the form was submitted, or
0if no member was logged in.
License
This bundle is released under the LGPL 3.0+ license