Forms editing

L'éditeur en ligne des champs riches offre la possibilité de créer et gérer des formulaires dans vos contenus.

Cette page documente le processus de création d'un formulaire à l'aide de l'éditeur en ligne. Ce fonctionnement s'applique à la fois aux formulaires gérés avec l'application mais aussi aux formulaires vers un site externe.
Tous les autres renseignements quant aux fonctionnalités liées aux formulaires dans Ametys sont disponibles à la page suivante : Formulaires.

1. Create a form
   1. Form CMS
   2. External form
   3. Lifecycle
   4. Input limitation
   5. Form fields
      1. Field type details
         1. Simple text
         2. Text area
         3. Drop-down list
         4. Check box
         5. Selection boxes
         6. Password
         7. File
         8. Hidden field
         9. Coût
         10. Captcha
         11. Field group
         12. Validate button
         13. Cancel button
2. Illustrated example
   1. Create and edit the article containing the form.
   2. Setting up the form

Create a form

Form CMS

Un formulaire CMS :
- Stocke les données saisies par les utilisateurs en base de donnée.
- Ces données sont par la suite exploitables grâce à la fonction d'export des données au format Excel (fichier CSV).
- De plus il est possible de définir des destinataires du formulaire qui recevront les données saisies par les internautes.
- Enfin vous pouvez mettre en place un système d'accusé de réception permettant à l'utilisateur de recevoir un email confirmant la bonne réception des données dans l'application.

In the Edit tab, a form is represented by:

In the Form contextual tab CMS, you can add fields and format your form.

Gérer le Formulaire CMS :

External form

In the Edit tab, the external form is represented by:

In the toolbar, you can manage the form:

Gérer un formulaire externe :

Lifecycle

For each of your CMS forms, you can choose a workflow that will apply to form entries (i.e. responses submitted by visitors).

The list of lifecycles depends on your application. Lifecycles are defined by the integration: Plugin Forms - Integration manual v1.9.0

If, during the life of a form, you modify its lifecycle, the status (workflow state) of all entries will be reset.

Input limitation

Cette fonctionnalité est disponible à partir de la v2.10 des formulaires. 

Lors de l'édition d'un formulaire, il est possible de limiter les entrées, c'est-à-dire limiter le nombre de soumissions que les visiteurs pourront effectuer avant que le formulaire ne soit fermé. 

Cette limitation est accessible via le menu , qui ouvre la fenêtre suivante : 

Le bouton "Ok" permet de mettre en place la limitation des entrées, 

le bouton "Supprimer" permet quant à lui de supprimer les limitations. Dans ce cas, le nombre de soumissions n'est pas contrôlé. 

Form fields

This is a list of the types of fields you can insert in a form; their properties are described below.

The rendering of fields in edit mode is for information only.

The contextual tab for each field offers several parameter-setting areas:

• The"properties" zone is used to enter general parameters.
• The"rules" area is used to define certain aspects of the field's behavior (mainly constraints).
• The"control" zone is used to move or delete the form field.

Pour que votre site reste accessible, les cases de choix (bouton radio) d'un même groupe doivent être situées à l'intérieur d'un groupe de champs.

Dans le cas d'un formulaire externe, il est important de s'assurer que les identifiants des champs correspondent avec ceux attendus par l'application externe.

Field type details

Simple text

Check the"Mandatory" box to make this field mandatory.

Check the"With confirmation" box to add a second simple text just below it, asking the user to confirm their entry. This option is mainly used to confirm a password or an e-mail address.

Pre-fill: You can choose to automatically pre-fill the field with information about the logged-in user: Last name, First name, Full name, Email or Login.
Please note that the field will only be pre-filled if the form is on a restricted-access page and a user is logged in to the site.

Rule: You can choose a predefined rule by selecting an entry from the list:

• Integral
• Decimal
• Email
• Phone
• Date
• Time
• Date and time
• Personalized

Then fill in the min and max values as required (depending on the rule selected).

If you choose"Custom", you can specify a regular expression. (See Mozilla's dedicated guide for more information on regular expressions)

Text area

Check the"Mandatory" box to make this field mandatory.

Drop-down list

Check the"Mandatory" box to make this field mandatory.

Check the"Multiple choice" box to authorize multiple selection (using the CTRL and SHIFT keys).

La case "Participe au coût" est disponible à partir de la version 2.11

Cocher la case "Participe au coût" si le champ participe au calcul du coût total. 

The"Select list" button is used to populate the list with values.

• Si la case "Participe au coût" n'est pas cochée : 

• Si la case "Participe au coût" est cochée, il est possible d'entrer un coût pour chaque option :

Check box

Check the"Mandatory" box to make this field mandatory.

Check the"Checked by default" box so that the box appears checked when the form is loaded.

Selection boxes

Identical to "checkbox", except for the"Group" property, which defines groups of checkboxes. Only one "choice box" can be selected per group.

Password

Characters are replaced by * on the screen.

Check the"Mandatory" box to make this field mandatory.

Check"With confirmation": a second password field is added just below, to confirm the entry.

As with the "Simple text" field, you can specify"min","max" and"regular expression" rules.

File

Check the"Mandatory" box to make this field mandatory.

Maximum size (in MB): Maximum file size that the visitor can send via the form.

The total size of the form is limited by the server: for example, if the server limits file uploads to 10 MB per form, all the files on the form must not exceed this value.

Hidden field

Defines a hidden field.

Coût

Ce champ Coût est disponible à partir de la version 2.11

Ce champ, en lecture seule, affiche le total des options sélectionnées (et sur lesquelles le coût a été activé) par l'utilisateur. 

Il est possible de choisir l'unité s'affichant après le coût : 

Exemple d'utilisation du coût : 

Captcha

Insert a Captcha in the form to protect against robots.

Field group

A field group allows you to group several fields together.

Validate button

Cancel button

Illustrated example

The webmaster or a contributor wishes to add a form to a page, for example a contact form.

Create and edit the article containing the form.

We know that a form is one of the elements that can make up content.
The first step is to create or modify a page, and then add content to it:

• Open or create the page containing the form
• select the zone containing the form
• insert an article: in the Page tab, click on Add content and choose Article
• in the Content tab (since the new item is automatically selected), click on the Modify content button

A tab is displayed with the Article in edit mode. The Edit tab is displayed.

As with any Article content edition, the contributor can enter an introductory text, an image, etc...

Setting up the form

Once editing the content, the contributor can insert a form in any rich-text area of the content. For our article, we'll add the form to the Rich Text field entitled Content.

• Position cursor where form is to be placed
• in the Edition, cliquer sur la flèche à droite de Form
  

• click on Form CMS
• a new zone is added to the content, representing the form's boundaries

• a new Form tab CMS is opened:

• This ribbon lets you define form parameters and build the form.

Here's an example of a contact form in edit mode:

Voici ci-dessous le rendu sur le front-office.