Presentation
This module lets you create forms for your visitors. Forms can be entered using the online editor for rich-text fields: see the Form Editor documentation.
The data entered can be sent to external applications or directly processed by the CMS, respectively known as :
- External form: data is sent to external applications.
- Form CMS: data is processed internally.
Overview
Render a contact form:
Main features
- Robust, intuitive online editor for entering forms in your content.
- Validation of form fields: mandatory fields, min and max numbers, regular expressions, etc. (see Form editing)
- Alerts email notifying new data submissions. (see Form editing)
- Acknowledgement of receipt (mail) sent to visitors after a submission.
- Form entries: lists form entries and enables a number of operations, such as deleting entries, exporting to Excel...
- List of forms: list of forms contained in site content
Acknowledgement of receipt
In the Form editing tab CMS, click on the Acknowledgement button to set up such a system.
The acknowledgement of receipt settings window opens:
Fill in the fields :
- Sender: email address which will appear as the sender of theemail acknowledgement of receipt. Leave blank to use the default value (application setting).
- To: Select the "email" form field to be used as the recipient of the acknowledgement of receipt.
- Then fill in the subject and body of theemail.
Your form must contain at least one field of type email to be able to implement this functionality:
List of forms
From the Home tab, the "Forms" tool lets you view all the forms present in the site's content.
From this screen, you can:
- Export: Excel export of form entries
- View entries: access to form data, i.e. all form responses (the same operation can be performed with a double-click)
- View query SQL: displays the text of the SQL query used to retrieve all form data for further processing.
- Delete all: deletes all entries
- Open the content containing the form by clicking on the link in the "Content title" column.
Form entries
You can access form entries either from the "Forms" tool shown above, or from content.
In the Content tab, click on the Form entries button.
The page must contain at least one form for this button to be active.
Form entries
If there is only one form, the tool opens directly on the only possibility. Otherwise, a window opens, allowing you to select a form from the various possible ones.
If the form has a lifecycle, the form entry viewer appears as shown below (see Editing forms - v1.9.0, v1.10.0, v1.11.0).
From this screen, you can:
- Export: Excel export of form entries
- View entries: access to form data, i.e. all form responses (the same operation can be performed with a double-click)
- View query SQL: displays the text of the SQL query used to retrieve all form data for further processing.
- Delete: deletes one or more entries
- Delete all: deletes all entries
- Advancing the input lifecycle
Standard life cycle
The lifecycle is fully configurable (see Plugin Forms - Integration manual v1.9.0).
The standard lifecycle, proposed by default, has 4 states:
- Submitted: a visitor has submitted a request (form response)
- Accepted: the webmaster has accepted the request
- Refused: the webmaster refused the request
- Request for additional information: the webmaster has requested additional information from the requester.
Request for additional information
In the standard lifecycle, the completion request may result in a mail being sent to the visitor who responded to the form.
However, this is subject to the condition that the form has a field of type "email".
If this is the case, the following dialog box will be displayed when requesting a supplement.
Check the "Send to mail" box and customize the mail text to be sent.
If you wish to advance the workflow without sending mail, uncheck the "Send mail" box.
Back to top