|||
-|-|-|
| Résumé | Discourse Authentication Validations permet d’ajouter des validations personnalisées à un champ utilisateur pour basculer l’affichage des champs utilisateur sur la modale d’inscription.
| Lien du dépôt | \u003chttps://github.com/discourse/discourse-authentication-validations\u003e
| Guide d’installation | Comment installer des plugins dans Discourse
À propos
Discourse Authentication Validations ajoute la possibilité d’ajouter des validations personnalisées à un champ utilisateur.
Les champs utilisateur personnalisés n’ont aucun type de validation fourni par le cœur, en dehors de la détection d’une valeur vide pour un champ requis. Ce plugin ajoute la possibilité de définir une expression régulière, par champ utilisateur, qui sera ensuite vérifiée par rapport à la valeur d’entrée fournie.
De plus, ce plugin ajoute la possibilité de basculer l’affichage des champs utilisateur sur la modale d’inscription. Cela vous permet de « chaîner » les champs utilisateur, de sorte qu’un champ utilisateur ne s’affiche que si un champ utilisateur précédent a une valeur spécifique.
Configuration de base
1. Activer le plugin
Le plugin Discourse Authentication Validations peut être activé soit par le basculeur, soit à partir de ses paramètres, tous deux accessibles depuis votre page admin/plugins.
2. Ajouter une validation personnalisée à un champ utilisateur
Une fois le plugin Discourse Authentication Validations activé, vous verrez une case à cocher \u003ckbd\u003eInclure des validations personnalisées\u003c/kbd\u003e en bas de votre formulaire de champ utilisateur.
Lorsqu’elle est cochée, elle affichera trois champs supplémentaires :
- Expression régulière de validation de la valeur
- Valeurs d’affichage
- Champs utilisateur cibles
Ajout d’une validation personnalisée
Incluez une expression régulière valide dans le champ Expression régulière de validation de la valeur :
\u003cimg width="729" alt="Screenshot 2024-06-05 at 11 18 20 PM" src="upload://sf3eZUtDLXlzXP9vw3HqCAmoZbQ.png"\u003e
La valeur du champ utilisateur dans le formulaire d’inscription sera désormais testée par rapport à l’expression régulière que vous avez incluse. Si l’entrée ne répond pas aux normes de votre expression régulière personnalisée, le formulaire d’inscription ne sera pas soumis.
\u003csmall\u003eAucune valeur (repose sur la validation de formulaire par défaut)\u003c/small\u003e
\u003cimg width="291" alt="Screenshot 2024-06-05 at 11 07 04 PM" src="upload://xQTYDASgAsmIE0nTlO0vGh5CFL3.png"\u003e
\u003csmall\u003eValeur incorrecte\u003c/small\u003e
\u003cimg width="282" alt="Screenshot 2024-06-05 at 11 07 40 PM" src="upload://yomkBUMLdjFPjdHFTJCpchPV1jq.png"\u003e
\u003csmall\u003eValeur correcte\u003c/small\u003e
\u003cimg width="293" alt="Screenshot 2024-06-05 at 11 08 02 PM" src="upload://jv23nMcMYIaAI4B4MJAcZUlF6V1.png"\u003e
Chaînage des champs utilisateur
Premièrement, incluez une valeur Valeurs d'affichage sur un champ utilisateur.
Lorsqu’un champ utilisateur a une valeur Valeurs d'affichage incluse, il surveillera la valeur de l’entrée attachée jusqu’à ce que la valeur de l’entrée corresponde à N’IMPORTE QUELLE des Valeurs d'affichage. Il basculera alors la visibilité de tous les Champs utilisateur cibles inclus, les rendant visibles.
Deuxièmement, ajoutez une valeur Champs utilisateur cibles.
Dans la liste déroulante Champs utilisateur cibles, vous verrez une liste de tous les champs utilisateur disponibles. Tout champ utilisateur que vous sélectionnez verra sa visibilité basculée par les valeurs correspondantes dans Valeurs d'affichage.
Chaînage avancé
Vous pouvez chaîner les champs utilisateur en ajoutant des validations personnalisées à plusieurs champs utilisateur.
Par exemple, supposons que nous ayons trois champs utilisateur avec les valeurs données :
| Nom | Validation personnalisée activée | Valeurs d’affichage | Champs utilisateur cibles |
|---|---|---|---|
| Entrée Un | true | afficher-deuxieme-entree | Entrée Deux |
| Entrée Deux | true | afficher-troisieme-entree | Entrée Trois |
| Entrée Trois | false |
L’Entrée Deux et l’Entrée Trois seront masquées par défaut car elles sont des « enfants » de l’Entrée Un. Lorsque la valeur d'affichage de afficher-deuxieme-entree est ajoutée à l’Entrée Un, l’Entrée Deux sera affichée, mais l’Entrée Trois restera masquée. Elle restera masquée jusqu’à ce que l’Entrée Deux ait la valeur de afficher-troisieme-entree.
Avec la bonne combinaison de Valeurs d’affichage et de Classes cibles, vous pouvez imbriquer infiniment des champs utilisateur les uns sous les autres.






