Creazione di link con messaggio personale precompilato

[Discourse]

Questa guida descrive come creare un link per avviare un nuovo messaggio personale con informazioni precompilate, comprese le best practice.

Livello utente richiesto: Tutti gli utenti

Discourse consente di comporre un nuovo messaggio personale con informazioni precompilate tramite parametri URL. Ciò può far risparmiare tempo e garantire coerenza per i messaggi comuni.

Struttura dell’URL

Per creare un nuovo messaggio precompilato, formatta il tuo URL in questo modo:

https://discourse.example.com/new-message?username=techapj&title=message%20title&body=message%20body

Scomponendo, i parametri dell’URL includono:

• URL di base: https://discourse.example.com/new-message
• Nome utente: username=techapj
• Titolo: title=message%20title
• Corpo: body=message%20body
• L’operatore URL ? per aggiungere le diverse opzioni

Puoi provarlo su try.discourse.org:

https://try.discourse.org/new-message?username=rudy&title=message%20title&body=message%20body

Puoi anche comporre un messaggio precompilato per un gruppo tramite URL:

https://meta.discourse.org/new-message?groupname=team&title=topic%20title&body=topic%20body

Nota il parametro groupname nell’URL sopra, questo significa che vuoi creare un nuovo messaggio precompilato per un gruppo (al contrario di username per comporre un messaggio per un utente). Puoi anche usare group_name come alternativa a groupname.

Tag

Puoi precompilare i tag in un messaggio personale aggiungendo il parametro tags:

https://discourse.example.com/new-message?username=techapj&title=Bug%20Report&body=Details&tags=tag1,tag2

Ciò richiede che l’impostazione del sito pm_tags_allowed_for_groups includa i gruppi a cui appartiene l’utente. Se il tagging PM non è abilitato per l’utente, il parametro tags verrà ignorato silenziosamente.

Best practice

• Puoi inviare messaggi a più utenti separando i nomi utente con una virgola. Per esempio

  https://meta.discourse.org/new-message?username=foo,bar
  

• Non è necessario compilare tutti i parametri. Ad esempio, uno qualsiasi dei seguenti funzionerebbe:

  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=
  

• Puoi aggiungere spazi di riga usando i codici %0A e %0A%0D per dare una certa struttura al corpo del messaggio:

  https://yoursite.discourse.org/new-message?username=test_user&title=Bug%20Report&body=Please%20include%20all%20relevant%20details.%0A%0DCPU:%0AMemory:%0A%0DDescribe%20Issue:
  

• Se hai DiscourseConnect (SSO), puoi collegarti a example.com/session/sso e quindi impostare il percorso di ritorno per creare il messaggio personale. Se l’utente ha già effettuato l’accesso, verrà reindirizzato automaticamente all’URL fornito dal percorso di ritorno. Se non ha effettuato l’accesso, verrà indirizzato alla pagina di accesso di DiscourseConnect e quindi reindirizzato all’URL del percorso di ritorno. Il percorso di ritorno dovrà essere codificato in 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">
  

Attualmente non supportato

• Utilizzare l’URL precompilato per comporre un messaggio a più gruppi.
• Utilizzare l’URL precompilato per aprire il compositore nella pagina di riepilogo di un utente.
• Usare l’email invece del nome utente per precompilare un messaggio personale.

Risorse aggiuntive

• Comporre un nuovo argomento precompilato tramite URL