Modèles de discussion

[Discourse]

	Résumé	Discourse Templates permet de créer des modèles de contenu pour une utilisation répétée. Les modèles sont stockés sous forme de sujets dans une catégorie spéciale, où ils peuvent être modifiés et discutés selon les besoins.
	Guide d’installation	Ce plugin est intégré au noyau de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

Étant donné qu’il s’agit d’un plugin official maintenu par l’équipe Discourse, les demandes de Support, Contribute > Bug, Contribute > UX et Contribute > Feature peuvent être formulées dans les catégories respectives sur Meta, en utilisant les balises appropriées du plugin. Cliquez sur un lien ci-dessous pour en créer un.

 Support  Bug  UX  Feature

Ce plugin est essentiellement une nouvelle version de Discourse Canned Replies, mais il est plus flexible et stocke les modèles différemment.

Fonctionnalités

Ce plugin utilise une ou plusieurs catégories pour stocker les modèles en vue d’une utilisation ultérieure. Le premier message de chaque sujet dans ces catégories sera utilisé comme modèle pour les réponses.

Cette approche offre beaucoup plus de fonctionnalités que ce qui était disponible auparavant avec discourse-canned-replies, car chaque modèle aura un historique de modifications, pourra avoir des balises associées, et les messages suivants pourront être utilisés pour discuter du contenu du modèle si nécessaire.

Seuls les sujets visibles seront utilisés comme modèles, donc les sujets non répertoriés et archivés ne seront pas listés.

Le plugin exploite également les paramètres de sécurité des catégories pour vérifier quels utilisateurs peuvent utiliser les modèles. Si l’utilisateur peut lire les sujets de la catégorie, l’option « insérer des modèles » dans l’éditeur de texte sera disponible. L’utilisateur ne pourra voir que les modèles/sujets des catégories auxquelles il a accès.

Plusieurs catégories parentes et/ou sous-catégories peuvent être utilisées pour fournir différents ensembles de modèles à différents groupes d’utilisateurs et organiser les modèles.

Modèles privés

Le plugin prend également en charge les modèles privés. Les modèles privés sont des messages privés marqués comme modèles. Ces messages seront disponibles en tant que modèles uniquement pour l’auteur du message.

Les messages archivés ne seront pas listés comme modèles.

Vous pouvez trouver tous vos modèles privés à l’adresse :
/u/{NOM-UTILISATEUR}/messages/tags/{BALISE-MODELE-PRIVE}

Paramètres :

• discourse templates enabled : Active le plugin
• discourse templates categories : Catégories utilisées pour stocker les modèles. Chaque sujet dans ces catégories et leurs sous-catégories sera utilisé comme modèle et sera disponible pour les utilisateurs qui peuvent les voir dans leurs catégories d’origine.
• discourse templates enable private templates : Active l’utilisation des modèles privés.
• discourse templates groups allowed private templates : Groupes d’utilisateurs autorisés à utiliser les modèles privés.

Les membres du personnel sont toujours autorisés.

• discourse templates private templates tags : Balises qui seront utilisées pour marquer les messages privés comme modèles.

Comment l’utiliser

Après l’installation du plugin, vous devrez créer au moins une catégorie pour stocker les modèles.

Remarque : tout utilisateur ayant accès en lecture aux sujets de cette catégorie pourra utiliser les fonctionnalités du plugin dans l’éditeur de texte.

Conseil : Les mêmes paramètres d’édition des sujets s’appliqueront aux sujets « modèle ». Si vous souhaitez que toute personne ayant un accès en écriture à la catégorie puisse modifier les modèles existants, vous devez activer l’option Make new topics wikis by default dans les paramètres de la catégorie.

Ensuite, spécifiez la catégorie dans les paramètres du plugin.

C’est tout. Il vous suffit maintenant de créer quelques sujets dans la catégorie spécifiée et ils seront disponibles pour être utilisés comme modèles.

Si vous le souhaitez, vous pouvez créer des sous-catégories pour mieux organiser les modèles ou pour fournir différents ensembles de réponses à plusieurs groupes d’utilisateurs.

Pour insérer des modèles, vous devez d’abord ouvrir l’éditeur de réponse et cliquer sur le bouton « extras », puis sélectionner l’option « Insérer un modèle ».

Sélectionnez le modèle souhaité, vous pouvez rechercher par texte ou par balises, puis cliquez sur l’icône « coller ».

Raccourci clavier
Vous pouvez utiliser Ctrl+Shift+I sur les PC ou ⌘+Shift+I sur les Macs pour insérer des modèles.

Le raccourci clavier fonctionnera dans n’importe quel champ de texte de Discourse.

Modèles privés

Les modèles privés ne fonctionneront que sur les instances où les messages privés et les balises sont activés.

Vous devez configurer les paramètres suivants de Discourse pour que cela fonctionne :

• tagging enabled : doit être activé.
• enable personal messages : doit être activé si vous souhaitez rendre cette fonctionnalité disponible pour les utilisateurs non membres du personnel.
• pm tags allowed for groups : vous devrez autoriser les groupes qui utiliseront les modèles privés à baliser les messages privés.

Pour utiliser les modèles privés, vous devez d’abord les activer dans les paramètres, attribuer les groupes d’utilisateurs qui peuvent les utiliser et attribuer au moins une balise pour marquer les MP comme modèles.

Pour créer un modèle personnel, les utilisateurs doivent :

• envoyer un message personnel non chiffré à eux-mêmes, balisé avec l’une des balises configurées dans les paramètres du plugin. Seul l’auteur du message le verra comme un modèle privé.

Les messages privés envoyés à d’autres utilisateurs peuvent également être balisés, mais seul l’auteur du message pourra les utiliser comme modèle.

Variables pré-remplies

Le plugin prend en charge les variables suivantes dans les modèles :

• my_username
• my_name
• topic_title
• topic_url
• original_poster_username
• original_poster_name
• reply_to_username
• reply_to_name
• last_poster_username
• reply_to_or_last_poster_username.

Toutes les variables ci-dessus prennent en charge le texte de repli (fallback) et supprimeront la variable si le repli n’est pas spécifié et que la variable ne peut pas être remplacée.

Le titre et le corps du message prennent tous deux en charge le remplacement des variables.

Exemple :

Bonjour %{reply_to_username,fallback:monsieur/madame},

...

Cordialement,
%{my_name}

Si le reply_to_username n’est pas disponible, le modèle sera :

Bonjour monsieur/madame,

...

Cordialement,
Arpit Jalan

---

Migration depuis discourse-canned-replies

Il existe une tâche Rake pour migrer les réponses préenregistrées existantes vers des modèles :

rake "discourse-templates:migrate-from-canned-replies"

Cela n’a pris que quelques secondes pour exécuter la migration sur Meta pour 47 réponses préenregistrées, il devrait donc être sûr de l’utiliser, sauf si vous avez un nombre démentiel de réponses préenregistrées.

TODO

• étendre la fonctionnalité à d’autres endroits au-delà de l’éditeur de texte
• permettre l’utilisation de plus d’une catégorie parente comme source de modèles

Journal des modifications

• 2022-07-14T03:00:00Z : Ajout de la possibilité d’utiliser plusieurs catégories parentes comme source de modèles
• 2022-07-18T03:00:00Z : Modèles privés
• 2022-08-10T03:00:00Z : Raccourci clavier global