Gérer les éléments formulaires

Sous le menu « Formulaires » du panneau latéral, vous avez accès à :

• La gestion des éléments formulaires,
• Aux catégories du module,
• Aux paramètres du module (en cliquant sur l'icône présente à la droite de l'onglet).

Les paramètres du module

Les paramètres correspondent aux préférences générales :

• La langue par défaut visible lorsque vous irez sur la gestion des éléments de formulaires. Il faut saisir ici un nom de code langage valide (fr ou en),
• La catégorie par défaut dans laquelle seront crées les formulaires,
• Le nom de la barre d'outil du wysiwyg utilisée à l'édition d'un formulaire. La barre d'outil par défaut « cms_forms » contient la gestion des outils d'assistant de création de formulaires essentielles à la création de ceux ci.

Les catégories du module

Elles permettent d'organiser et d'affiner vos droits sur les différents formulaires. La gestion des éléments de formulaires permet d'accéder à l'ensemble des formulaires existants, en les filtrant par langue ou/et catégories.

Créer un nouveau formulaire

Cliquez sur « Nouveau », en ayant pris soin d'être dans la langue dans laquelle vous souhaitez créer le formulaire (cliquez pour cela sur le bouton radio de la langue souhaitée).

Dans le champ titre, précisez un nom qui vous permettra d'identifier facilement votre formulaire. C'est ce libellé qui apparaîtra à l'édition de votre rangée, quand vous souhaiterez ajouter un formulaire à l'une de vos pages).

Vous pouvez ensuite choisir de rendre actif ou non actif un formulaire. Un formulaire inactif n'est pas visible, et ce de manière immédiate (inutile de régénérer la page).

Dans le champ source, vous allez créer votre formulaire.  Cliquez pour cela sur l'icône d'assistant de formulaire.

Cet assistant vous permet d'ajouter des champs de plusieurs types. Il a aussi le rôle essentiel de générer des balises de formulaires uniques et enregistrées en base de données.

Les différents types de champ que vous pouvez ajouter sont :

• Texte : zone de texte sur une ligne. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Texte email : zone de texte sur une ligne. Un contrôle sur la validité de l'email sera effectué à la soumission du formulaire. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Texte chiffres : zone de texte sur une ligne. Un contrôle sur la validité des caractères saisis sera effectué à la soumission du formulaire. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Texte URL : zone de texte sur une ligne. Un contrôle sur la validité de l'url saisie sera effectué à la soumission du formulaire. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Texte Mot de passe : zone de texte de type mot de passe. Des étoiles apparaissent à la place des caractères saisis par l'utilisateur. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Fichier joint : champ permettant à l'utilisateur de sélectionné un fichier sur son ordinateur. Ce fichier sera placé en pièce jointe dans le cas d'un traitement du formulaire comprenant l'envoi d'un email. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Zone de texte : zone de texte multiligne. Vous aurez la possibilité d'éditer la valeur par défaut du champ.
• Sélection multiple : créer un champ de sélection parmi des valeurs. Vous aurez la possibilité d'éditer les valeurs.
• Case à cocher : permet de créer des cases à cocher. Vous aurez la possibilité d'éditer la valeur par défaut (0 ou 1)
• Champ caché : permet d'insérer un champ non visible par l'utilisateur (pour transmettre des données à la soumission du formulaire en vue d'un traitement postérieur)
• Bouton Valider : il faut au moins un champ de ce type par formulaire pour que l'utilisateur puisse soumettre son formulaire.

Pour ajouter un champ, vous choisissez le type de champ et vous cliquez sur « Ajouter ».

Le champ apparaît dans la zone de haut. Pour chacun des champs, vous pouvez préciser :

• son caractère obligatoire.
• Son libellé. Si vous avez rendu le champ obligatoire, veillez à l'indiquer à l'utilisateur, par un * en regard du libellé, par exemple. Le xHTML est supporté dans ce champ, sachant qu'il sera encapsulé dans une balise « label » relié au champ.
• En options, vous pouvez, selon le cas, modifier la valeur par défaut en cliquant sur « Défaut », ou modifier les valeurs disponibles en cliquant sur « Valeurs »
• Dans la colonne d'actions, vous pouvez choisir de supprimer le champ ou de modifier son ordre par rapport aux autres champs.
• Cliquez sur « Valider » pour confirmer la création des champs.

Modifier la valeur par défaut :

Cliquez sur « Défaut ». saisissez la valeur et cliquez sur « Retour au formulaire ».

Attention, si vous cliquez directement sur « OK », vous validerez la structure des champs et les actions menées précédement dans l'assistant, mais pas la valeur juste saisie.

Vous pouvez saisir pour valeur une des variables générales en respectant la syntaxe décrite.

Modifier les valeurs :

• Cliquez sur « Valeurs »,
• Dans le champ « Texte », saisissez le texte visible pour l'utilisateur,
• Dans le champ « Valeur », saisissez la valeur transmise à la soumission du formulaire,
• Cliquez sur « Ajouter » pour ajouter le couple « texte/valeur » à la liste des valeurs.

Dans le champ des valeurs, vous pouvez modifier l'ordre des valeurs dans la liste, et en choisir une comme étant celle sélectionnée par défaut.

Cliquez sur « Retour au formulaire » pour valider votre saisie.

Attention, si vous cliquez directement sur « OK », vous validerez la structure des champs et les actions menées précédement dans l'assistant, mais pas les valeurs juste saisies.

Une fois vos champs crées, vous avez la possibilité de modifier la mise en page, en utilisant les outils classiques du wysiwyg.

Sélectionnez finalement la ou les catégories du formulaire, limiter le nombre de réponse d'un utilisateur et validez. Vous verrez votre formulaire apparaître dans la liste des formulaire existant.

Modifier un formulaire

Pour modifier un formulaire, vous avez la possibilité de :

• Modifier l'ensemble des champs d'un coup. Pour cela, cliquez sur l'icone d'assistant de formulaire. Attention cependant, car la validation de création des champs réinitialise le formulaire dans le wysiwyg, et vous perdrez votre mise en page.
• Modifier un seul champ. Pour cela, cliquez avec le bouton droit sur le champ ou sur son label après avoir sélectionné celui-ci. Dans le menu contextuel, cliquez sur « Modifier le champ »
• Ajouter un seul champ. Pour cela, cliquez avec le bouton droit à l'emplacement souhaité. Dans le menu contextuel, cliquez sur «Ajouter un champ ».