Template Discourse

Plugin
, ,
1

|||
|— | — | —|
|:discourse2: | Riepilogo | Discourse Templates consente la creazione di modelli di contenuto per un uso ripetuto. I modelli vengono archiviati come argomenti in una categoria speciale, dove possono essere modificati e discussi secondo necessità.|
|:open_book: | Guida all’installazione | Questo plugin è incluso nel core di Discourse. Non è necessario installare il plugin separatamente.

:information_source: Questo plugin è praticamente una nuova versione di Discourse Canned Replies ma è più flessibile e archivia i modelli in modo diverso.

Funzionalità

Questo plugin utilizza una o più categorie per archiviare i modelli per un uso futuro. Il primo post di ogni argomento in queste categorie verrà utilizzato come modello per le risposte.

Questo approccio fornisce molta più funzionalità rispetto a quella disponibile in precedenza con discourse-canned-replies, poiché ogni modello avrà una cronologia delle modifiche, potrà avere tag associati e i post successivi potranno essere utilizzati per discutere il contenuto del modello, se necessario.

Verranno utilizzati come modelli solo gli argomenti visibili, quindi gli argomenti non elencati e archiviati non verranno visualizzati.

Il plugin sfrutta anche le impostazioni di sicurezza delle categorie per verificare quali utenti possono utilizzare i modelli. Se l’utente può leggere gli argomenti nella categoria, l’opzione “inserisci modelli” nell’editor sarà disponibile per l’uso. L’utente sarà in grado di vedere solo i modelli/argomenti nelle categorie a cui ha accesso.

È possibile utilizzare più categorie padre e/o sottocategorie per fornire diversi set di modelli da utilizzare per diversi gruppi di utenti e per organizzare i modelli.

Modelli privati

Il plugin supporta anche i modelli privati. I modelli privati sono messaggi privati taggati come modelli. Questi messaggi saranno disponibili come modelli solo per l’autore del messaggio.

I messaggi archiviati non verranno visualizzati come modelli.

:bulb: Puoi trovare tutti i tuoi modelli privati su:
/u/{NOMEUTENTE}/messages/tags/{TAGMODELLOPRIVATO}

Impostazioni:

  • discourse templates enabled: Attiva il plugin
  • discourse templates categories: Categorie utilizzate per archiviare i modelli. Ogni argomento in queste categorie e nelle loro sottocategorie verrà utilizzato come modello e sarà disponibile per gli utenti che possono vederli nelle loro categorie originali.
  • discourse templates enable private templates: Abilita l’uso di modelli privati.
  • discourse templates groups allowed private templates: Gruppi di utenti autorizzati a utilizzare modelli privati.

:warning: I membri dello staff sono sempre autorizzati.

  • discourse templates private templates tags: Tag che verranno utilizzati per contrassegnare i messaggi privati come modelli.

Come usarlo

Dopo aver installato il plugin, dovrai creare almeno una categoria per archiviare i modelli.

Nota che ogni utente che ha accesso alla lettura degli argomenti in questa categoria sarà in grado di utilizzare la funzionalità del plugin nell’editor.

:bulb: Suggerimento: Le stesse impostazioni per modificare gli argomenti verranno applicate agli argomenti “modello”. Se desideri che chiunque abbia accesso in scrittura nella categoria possa modificare i modelli esistenti, dovresti attivare Rendi i nuovi argomenti wiki per impostazione predefinita nelle impostazioni della categoria.

image
image736×402 27.6 KB

Dopo di che, specifica la categoria nelle impostazioni del plugin.

Questo è tutto. Ora devi solo creare alcuni argomenti nella categoria specificata e saranno disponibili per essere utilizzati come modelli.

Se vuoi, puoi creare sottocategorie per organizzare meglio i modelli o per fornire diversi set di risposte a più gruppi di utenti.

Per inserire i modelli devi prima aprire l’editor di risposte e fare clic sul pulsante extra, quindi selezionare l’opzione “Inserisci modello”

image
image724×346 41.2 KB

Seleziona il modello desiderato, puoi cercare per testo o tag e fare clic sull’icona “incolla”.

image
image1062×403 22.2 KB

Scorciatoia da tastiera
Puoi usare Ctrl+Shift+I su PC o ⌘+Shift+I su Mac per inserire modelli.

:bulb: La scorciatoia da tastiera funzionerà all’interno di qualsiasi area di testo su Discourse

Modelli privati

:warning: I modelli privati funzioneranno solo in istanze con messaggi privati e tag abilitati.

Devi configurare le seguenti impostazioni di Discourse affinché funzioni:

  • tagging enabled: deve essere abilitato.
  • enable personal messages: dovrebbe essere abilitato se vuoi rendere la funzionalità disponibile per gli utenti non staff.
  • pm tags allowed for groups: dovrai consentire ai gruppi che utilizzeranno i modelli privati di taggare i messaggi privati.

Per utilizzare i modelli privati devi prima abilitarlo nelle impostazioni, assegnare i gruppi di utenti che possono utilizzarlo e assegnare almeno un tag per contrassegnare i PM come modello.

Per creare un modello personale gli utenti devono:

  • inviare un messaggio privato non crittografato a se stessi taggato con uno dei tag configurati nelle impostazioni del plugin. Solo l’autore del messaggio lo visualizzerà come modello privato.

:bulb: I messaggi privati inviati ad altri utenti possono anche essere taggati, ma solo l’autore del messaggio potrà utilizzarlo come modello.

Variabili precompilate

Il plugin supporta le seguenti variabili nei modelli:

  • 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.

Tutte le variabili sopra supportano testo di fallback e rimuoveranno la variabile se il fallback non è specificato e la variabile non può essere sostituita.

Sia il titolo che il corpo supportano la sostituzione delle variabili.

Esempio:

Ciao %{reply_to_username,fallback:lì},

...

Saluti,
%{my_name}

Se reply_to_username non è disponibile, il modello sarà:

Ciao lì,

...

Saluti,
Arpit Jalan

Migrazione da discourse-canned-replies

Esiste un task rake per migrare le risposte predefinite esistenti in modelli:

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

Ci sono voluti solo pochi secondi per eseguirlo su Meta per migrare 47 risposte predefinite, quindi dovrebbe essere sicuro da usare a meno che tu non abbia una quantità enorme di risposte predefinite.

TODO

  • estendere la funzionalità ad altri luoghi oltre all’editor :white_check_mark:
  • consentire l’uso di più di una categoria padre come origine dei modelli :white_check_mark:

Changelog

  • 2022-07-14T03:00:00Z: Aggiunta la possibilità di utilizzare più categorie padre come origine per i modelli
  • 2022-07-18T03:00:00Z: Modelli privati
  • 2022-08-10T03:00:00Z: Scorciatoia da tastiera globale
44 Mi Piace