Création de modèles de formulaires

[lindsey (Lindsey Fogle)]

Ce guide explique comment utiliser les modèles de formulaire pour structurer le contenu dans Discourse.

Niveau d’utilisateur requis : Administrateur

Les modèles de formulaire vous permettent de créer des formulaires structurés avec des règles de validation que les utilisateurs peuvent remplir lors de la création de sujets afin de vous assurer qu’ils fournissent toutes les informations que vous souhaitez ou dont vous avez besoin pour les aider, par exemple pour les rapports de bogues, les demandes de fonctionnalités, etc.

Note : Pour les modèles qui fonctionnent davantage comme des directives plutôt que comme un formulaire structuré, envisagez d’utiliser les modèles de sujet.

Activation des modèles de formulaire

Vous pouvez activer les modèles de formulaire dans Changements à venir en réglant Activer les modèles de formulaire sur « Tout le monde ».

Création de modèles de formulaire

Vous pouvez créer et gérer des modèles de formulaire en allant dans Admin > Apparence > Modèles de formulaire (/admin/customize/form-templates).

Pour créer un modèle de formulaire :

1. Cliquez sur Nouveau modèle.

2. Mettez à jour le champ Nom du modèle avec un nom interne pour votre modèle.

3. Utilisez les boutons en haut de la page pour ajouter les différents champs à votre formulaire et mettez à jour les attributs des champs (détaillés ci-dessous). Beaucoup des options sont des types de champs de formulaire standard (par exemple, case à cocher, réponse courte, liste déroulante, etc.), mais il existe quelques champs spécifiques :

   • Sélecteur de groupe d’étiquettes : Les utilisateurs peuvent sélectionner une ou plusieurs étiquettes d’un groupe particulier.

   • Réponse Markdown : Les utilisateurs peuvent ajouter du contenu directement dans une mini-version du compositeur. Ceci est idéal lorsque les membres doivent saisir directement du Markdown, comme du code, ou ont besoin d’un autre formatage pris en charge par l’éditeur riche.

4. Ajoutez toutes les validations souhaitées à vos saisies. Cliquez sur le bouton Validation pour une clé (également affiché ci-dessous).

5. Cliquez sur le bouton Aperçu pour vous assurer que tout est correct.

6. Cliquez sur Enregistrer.

Attributs de champ

Attributs communs à tous les types de champs :

• label : Le nom du champ visible
• placeholder : Texte d’aide affiché dans les champs vides (saisie, zone de texte, liste déroulante, sélection multiple)
• description : Contexte ou instructions supplémentaires affichés sous le champ.

Attributs spécifiques au téléchargement :

• file_types : Liste séparée par des virgules des extensions de fichiers autorisées (par exemple, .jpg, .png, .pdf)
• allow_multiple : Booléen indiquant si les utilisateurs peuvent télécharger plusieurs fichiers

Attributs de liste déroulante et de sélection multiple :

• none_label : Texte affiché lorsqu’aucune option n’est sélectionnée
• choices : Tableau des options disponibles

Options de validation

Clé	Type	Description
required	booléen	Nécessite que le champ soit rempli pour soumettre le formulaire.
minimum	entier	Pour les champs de texte, spécifie le nombre minimum de caractères autorisés.
maximum	entier	Pour les champs de texte, spécifie le nombre maximum de caractères autorisés.
pattern	regex; chaîne	Pour les champs de texte, une expression régulière spécifiant la saisie autorisée.
type	chaîne	Pour les champs de saisie, vous pouvez spécifier le type de saisie attendu (text, email, date, number, url, tel, color

Ajout de modèles de formulaire à une catégorie

Après avoir créé un modèle :

1. Accédez à la catégorie où vous souhaitez utiliser le modèle.
2. Cliquez sur le bouton pour modifier la catégorie.

3. Activez le bouton Paramètres avancés (si vous utilisez la nouvelle conception simplifiée des catégories).
4. Allez à l’onglet Modèle.
5. Activez le bouton à bascule Modèle de formulaire.
6. Sélectionnez le modèle de formulaire dans le menu déroulant.
7. Cliquez sur Enregistrer la catégorie.

Lorsque plusieurs modèles sont attribués à une catégorie, les utilisateurs verront un sélecteur de modèle lors de la création de sujets.

Expérience des membres

Création de sujets avec des modèles de formulaire

Lorsqu’un membre crée un sujet dans une catégorie avec des modèles de formulaire, le formulaire apparaît automatiquement dans le compositeur. Si plusieurs modèles sont appliqués à la même catégorie, les membres peuvent choisir le bon modèle dans un menu déroulant. Si les utilisateurs tentent de créer un sujet sans remplir correctement chaque champ, ils verront une erreur de validation.

Pré-remplissage des valeurs du formulaire

Les champs de formulaire peuvent être pré-remplis à l’aide de paramètres d’URL correspondant aux ID de champ. Par exemple : /new-topic?software-version=2.4.1&severity=Critical

Ceci est utile pour créer des liens vers la création de sujets avec certains champs déjà remplis.