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 que vous puissiez vous assurer que les utilisateurs fournissent toutes les informations que vous souhaitez ou dont vous avez besoin pour les assister, comme pour les rapports de bogues, les demandes de fonctionnalités, etc.

Remarque : Pour les modèles qui fonctionnent davantage comme des directives plutôt que comme un formulaire structuré, pensez à 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 les différents champs de votre formulaire et mettez à jour les attributs de champ (détaillés ci-dessous). Beaucoup d’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 de balises : Les utilisateurs peuvent sélectionner une ou plusieurs balises 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 enrichi.

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

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

6. Cliquez sur Enregistrer.

Attributs de champ

Attributs courants pour tous les types de champs :

• label : Le nom de 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 fichier 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

Attributs du sélecteur de groupe de balises :

• tag_group : (propriété de champ de niveau supérieur) Le nom du groupe de balises à partir duquel peupler les choix
• none_label : Texte affiché lorsqu’aucune option n’est sélectionnée
• multiple : Booléen indiquant si les utilisateurs peuvent sélectionner plusieurs balises (le squelette par défaut le définit sur true)

Options de validation

Clé	Type	Description
required	boolean	Exige que le champ soit rempli pour soumettre le formulaire.
minimum	integer	Pour les champs de texte, spécifie le nombre minimum de caractères autorisés.
maximum	integer	Pour les champs de texte, spécifie le nombre maximum de caractères autorisés.
pattern	regex; string	Pour les champs de texte, une expression régulière spécifiant l’entrée autorisée.
type	string	Pour les champs de saisie, vous pouvez spécifier le type de saisie attendu (text, email, date, number, url, tel, color, password)

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

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

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

3. Basculez le bouton Paramètres avancés (si vous utilisez la nouvelle configuration de catégorie simplifiée).
4. Accédez à 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 affecté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 dotée de 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 modèle approprié 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 de formulaire

Les champs de formulaire peuvent être pré-remplis à l’aide de paramètres d’URL correspondant aux identifiants 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.

[Eingang]

À quoi ressemblent les modèles regex et quel dialecte regex est attendu ? J’ai essayé les suivants et ils sont tous passés, mais je ne m’y attendais pas :

• 2[6-9][0-1][0-9][0-3][0-9] avec une entrée de 180918 ;
• /2[6-9][0-1][0-9][0-3][0-9]/ avec une entrée de 180918 ;
• /2[6-9][0-1][0-9][0-3][0-9]/ avec une entrée de 12 ;