Ce guide décrit comment créer un lien pour démarrer un nouveau message personnel avec des informations pré-remplies, y compris les meilleures pratiques.
Niveau d’utilisateur requis : Tous les utilisateurs
Discourse vous permet de composer un nouveau message personnel avec des informations pré-remplies via des paramètres d’URL. Cela peut vous faire gagner du temps et assurer la cohérence pour les messages courants.
Structure de l’URL
Pour créer un nouveau message pré-rempli, formatez votre URL comme suit :
https://discourse.example.com/new-message?username=techapj&title=message%20title&body=message%20body
Décomposée, les paramètres de l’URL comprennent :
- URL de base :
https://discourse.example.com/new-message - Nom d’utilisateur :
username=techapj - Titre :
title=message%20title - Corps :
body=message%20body - L’opérateur d’URL
?pour ajouter les différentes options
Vous pouvez essayer ceci sur try.discourse.org :
https://try.discourse.org/new-message?username=rudy&title=message%20title&body=message%20body
Vous pouvez également composer un message pré-rempli pour un groupe via l’URL :
https://meta.discourse.org/new-message?groupname=team&title=topic%20title&body=topic%20body
Remarquez le paramètre groupname dans l’URL ci-dessus, cela signifie que vous voulez créer un nouveau message pré-rempli pour un groupe (par opposition à username pour composer un message pour un utilisateur). Vous pouvez également utiliser group_name comme alternative à groupname.
Étiquettes (Tags)
Vous pouvez pré-remplir les étiquettes sur un message personnel en ajoutant le paramètre tags :
https://discourse.example.com/new-message?username=techapj&title=Bug%20Report&body=Details&tags=tag1,tag2
Ceci nécessite que le paramètre du site pm_tags_allowed_for_groups inclue les groupes auxquels appartient l’utilisateur. Si l’étiquetage des messages privés n’est pas activé pour l’utilisateur, le paramètre tags sera silencieusement ignoré.
Meilleures pratiques
-
Vous pouvez envoyer un message à plusieurs utilisateurs en séparant les noms d’utilisateur par des virgules. Par exemple
https://meta.discourse.org/new-message?username=foo,bar -
Vous n’avez pas besoin de remplir tous les paramètres. Par exemple, n’importe lequel des suivants fonctionnerait :
https://meta.discourse.org/new-message https://meta.discourse.org/new-message?username= https://meta.discourse.org/new-message?title=foo&body=bar https://meta.discourse.org/new-message?groupname= -
Vous pouvez ajouter des sauts de ligne en utilisant les codes %0A et %0A%0D pour donner une certaine structure au corps du message :
https://yoursite.discourse.org/new-message?username=test_user&title=Bug%20Report&body=Please%20include%20all%20relevant%20details.%0A%0DCPU:%0AMemory:%0A%0DDescribe%20Issue: -
Si vous avez DiscourseConnect (SSO), vous pouvez créer un lien vers
example.com/session/ssopuis définir le chemin de retour pour créer le message personnel. Si l’utilisateur est déjà connecté, il sera automatiquement redirigé vers l’URL fournie par le chemin de retour. S’il n’est pas connecté, il sera dirigé vers la page de connexion DiscourseConnect puis redirigé vers l’URL du chemin de retour. Le chemin de retour devra être encodé en URL.href="http://localhost:3000/session/sso?return_path=http%3A%2F%2Flocalhost%3A3000%2Fnew-message%3Fusername%3Dscossar%26title%3DInformation+requested+about+gentle+yoga+classes">
Actuellement non pris en charge
- Utiliser l’URL pré-remplie pour composer un message à plusieurs groupes.
- Utiliser l’URL pré-remplie pour ouvrir le compositeur sur la page de résumé d’un utilisateur.
- Utiliser l’e-mail au lieu du nom d’utilisateur pour pré-remplir un message personnel.