Modèles de discussion

[Discourse]

|||
|—|—|—|
|:discourse2: | Résumé | Discourse Templates permet la création de 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 au besoin.|
|:open_book: | Guide d’installation | Ce plugin est inclus dans le cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

Comme il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, Bug, UX et Feature peuvent être faites dans les catégories respectives ici sur Meta, et taguées avec le tag de plugin approprié. Cliquez sur un lien ci-dessous pour en démarrer une.

 Support  Bug  UX  Fonctionnalité

Ce plugin est en quelque sorte une nouvelle version de Discourse Canned Replies mais il est plus flexible et stocke les modèles d’une manière différente.

Fonctionnalités

Ce plugin utilise une ou plusieurs catégories pour stocker les modèles pour 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 qu’auparavant avec discourse-canned-replies, car chaque modèle aura un historique de modification, pourra avoir des tags associés, 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 listé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 le compositeur sera disponible. L’utilisateur ne pourra voir que les modèles/sujets dans les 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 à utiliser par différents groupes d’utilisateurs et pour 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 tagués comme modèles. Ces messages seront disponibles comme 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 à :
/u/{NOM-UTILISATEUR}/messages/tags/{TAG-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: Tags qui seront utilisés pour marquer les messages privés comme modèles.

Comment l’utiliser

Après avoir installé le plugin, vous devrez créer au moins une catégorie pour stocker les modèles.

Notez que chaque utilisateur ayant accès pour lire les sujets de cette catégorie pourra utiliser la fonctionnalité du plugin dans le compositeur.

Astuce de pro : Les mêmes paramètres pour modifier les sujets s’appliqueront aux sujets “modèles”. Si vous souhaitez que toute personne ayant un accès en écriture dans la catégorie puisse modifier les modèles existants, vous devriez activer Rendre les nouveaux sujets des wikis par défaut dans les paramètres de la catégorie.

Après cela, spécifiez la catégorie dans les paramètres du plugin.

C’est tout. Maintenant, il vous suffit 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 le compositeur de réponse et cliquer sur le bouton des extras, puis sélectionner l’option “Insérer un modèle”

Sélectionnez le modèle désiré, vous pouvez rechercher par texte ou par tags et cliquer sur l’icône “coller”.

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

Le raccourci clavier fonctionnera dans n’importe quelle zone de texte sur Discourse

Modèles privés

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

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

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

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

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

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

Les messages personnels envoyés à d’autres utilisateurs peuvent également être tagués, mais seul l’auteur du message pourra l’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 un texte de repli 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 prennent en charge le remplacement de variables.

Exemple :

Salut %{reply_to_username,fallback:là},

...

Cordialement,
%{my_name}

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

Salut là,

...

Cordialement,
Arpit Jalan

---

Migration depuis discourse-canned-replies

Il existe une tâche rake pour migrer les réponses prédéfinies existantes vers des modèles :

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

Cela n’a pris que quelques secondes pour s’exécuter sur Meta afin de migrer 47 réponses prédéfinies, il devrait donc être sûr de l’utiliser, sauf si vous avez une quantité astronomique de réponses prédéfinies.

À FAIRE

• étendre la fonctionnalité à d’autres endroits au-delà du compositeur
• autoriser l’utilisation de plus d’une catégorie parente comme sources 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

[BryanV (Bryan Van de ven)]

Où est l’endroit approprié pour demander une fonctionnalité ? Je vois que le traqueur de problèmes pour le dépôt GH associé est désactivé. J’aimerais avoir la possibilité de coller des réponses « en ligne », c’est-à-dire au milieu d’une phrase. J’avais demandé cela pour le plugin précédent, et il y avait eu une discussion (apparemment positive) à ce sujet, mais je n’ai pas pu la retrouver.

J’ai très souvent besoin de rédiger des réponses qui contiennent par exemple GitHub Issue au milieu d’une phrase :

• Si vous souhaitez demander [chose] comme nouvelle fonctionnalité, veuillez ouvrir un GitHub Issue
• [Fonctionnalité] est sous-documentée, un GitHub Issue serait approprié pour augmenter la visibilité.
• [Comportement] semble être un bug, veuillez ouvrir un GitHub Issue avec tous les détails.

J’ai beaucoup de ces types d’extraits, et je les utilise constamment sur notre forum de support utilisateur.

De manière générale, j’aimerais pouvoir insérer des modèles exactement à la position actuelle du curseur. C’est vraiment agaçant que le modèle soit inséré sur une nouvelle ligne avec une autre nouvelle ligne au-dessus, et que je doive manuellement supprimer tout cet espace blanc juste pour le ramener à la position précédente du curseur, plusieurs fois par jour. Je veux juste taper ma réponse le plus rapidement possible.

Encore mieux serait un moyen texte uniquement pour insérer ces éléments sans avoir à utiliser la souris ou les menus.

[not-ethan (Ethan)]

Vous pouvez créer un sujet dans Feature avec le tag templates

@saquetim

Comme il s’agit d’un plugin official maintenu par l’équipe Discourse, les demandes de Support, Bug, UX et Feature peuvent être faites dans les catégories respectives ici sur Meta, et taguées avec le tag de plugin approprié. Cliquez sur un lien ci-dessous pour en démarrer une.

Support Bug UX Feature

[david (David Taylor)]

Ce plugin est maintenant inclus dans le cœur de Discourse dans le cadre de Bundling more popular plugins with Discourse core. Si vous auto-hébergez et utilisez le plugin, vous devez le supprimer de votre app.yml avant votre prochaine mise à niveau.

[Paul_King]

Les modèles peuvent-ils aider à créer une liste de réponses types par e-mail aux candidats qui essaient de s’inscrire à mon forum ? Je dois souvent rejeter des candidats en fonction des informations fournies lors de l’inscription et expliquer pourquoi, avec des suggestions sur ce qui devrait changer s’ils souhaitent postuler à nouveau. Je recherche une sélection déroulante de réponses types à insérer dans le champ « raison du rejet ». Je n’ai pas trouvé de moyen d’utiliser des modèles à cette fin.

[HAWK]

Envoyez-vous et recevez-vous les réponses via Discourse ?

[Moin]

Vous pouvez utiliser des modèles dans de nombreux champs de saisie où la barre d’outils n’est pas affichée en utilisant le raccourci clavier \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003eshift\u003c/kbd\u003e + \u003ckbd\u003ei\u003c/kbd\u003e

[Paul_King]

Oui, envoi via le champ « pourquoi rejetez-vous cet utilisateur » lors de la suppression de l’utilisateur qui n’a pas été approuvé.

[Paul_King]

C’est bien !
Ce serait encore mieux que d’avoir à se souvenir d’un raccourci clavier (qui, dans mon cas, serait utilisé peut-être une fois par mois et donc oublié) qu’un petit bouton associé à chaque champ vide, pour déclencher la boîte de dialogue secondaire des modèles.

[Moin]

Oui, ce bouton serait également utile pour créer des avis officiels, des notes utilisateur, etc.

J’utilise habituellement l’aide des raccourcis clavier dans la barre latérale ou j’appuie sur ? pour découvrir que c’est “i”. (J’ai essayé de me souvenir de « insérer modèle », mais cela n’a pas très bien fonctionné pour moi, car je n’ai pas trouvé de formulation allemande commençant par « i »)