 |
Riepilogo | Discourse Templates consente di creare modelli di contenuto da utilizzare ripetutamente. I modelli vengono salvati come discussioni in una categoria speciale, dove possono essere modificati e discussi secondo necessità. |
 |
Guida all’installazione | Questo plugin è integrato nel nucleo di Discourse. Non è necessario installare il plugin separatamente. |
Questo plugin è essenzialmente una nuova versione di Discourse Canned Replies, ma è più flessibile e memorizza i modelli in modo diverso.
Funzionalità
Questo plugin utilizza una o più categorie per memorizzare i modelli da utilizzare in seguito. Il primo post di ogni discussione in queste categorie verrà utilizzato come modello per le risposte.
Questo approccio offre molte più funzionalità rispetto a quanto disponibile precedentemente 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 solo i topic visibili come modelli, quindi i topic non elencati e archiviati non verranno elencati.
Il plugin sfrutta anche le impostazioni di sicurezza delle categorie per verificare quali utenti possono utilizzare i modelli. Se l’utente può leggere i topic nella categoria, l’opzione “inserisci modelli” nel composer sarà disponibile per l’uso. L’utente potrà vedere solo i modelli/topic nelle categorie a cui ha accesso.
È possibile utilizzare più categorie principali e/o sottocategorie per fornire diversi set di modelli da utilizzare a diversi gruppi di utenti e organizzare i modelli.
Modelli privati
Il plugin supporta anche 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 elencati come modelli.
Puoi trovare tutti i tuoi modelli privati qui:
/u/{NOME-UTENTE}/messages/tags/{TAG-MODELLO-PRIVATO}
Impostazioni:
discourse templates enabled: Attiva il plugindiscourse templates categories: Categorie utilizzate per memorizzare i modelli. Ogni topic 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 i modelli privati.
I membri dello staff sono sempre autorizzati.
discourse templates private templates tags: Tag che verranno utilizzati per contrassegnare i messaggi privati come modelli.
Come utilizzarlo
Dopo aver installato il plugin, dovrai creare almeno una categoria per memorizzare i modelli.
Nota bene: ogni utente che ha accesso in lettura ai topic di questa categoria potrà utilizzare le funzionalità del plugin nel composer.
Crea nuovi topic come wiki di defaultnelle impostazioni della categoria.
Successivamente, specifica la categoria nelle impostazioni del plugin.
Fatto. Ora devi solo creare alcuni topic nella categoria specificata e saranno disponibili per l’uso come modelli.
Se vuoi, puoi creare sottocategorie per organizzare meglio i modelli o per fornire diversi set di risposte a diversi gruppi di utenti.
Per inserire i modelli, devi prima aprire il composer delle risposte e cliccare sul pulsante “extra”, quindi selezionare l’opzione “Inserisci modello”.
Seleziona il modello desiderato, puoi cercare per testo o tag e clicca sull’icona “incolla”.
Scorciatoia da tastiera
Puoi usare Ctrl+Shift+I su PC o ⌘+Shift+I su Mac per inserire i modelli.
Modelli privati
Devi configurare le seguenti impostazioni di Discourse affinché funzioni:
tagging enabled: deve essere abilitato.enable personal messages: dovrebbe essere abilitato se desideri 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 abilitarli nelle impostazioni, assegnare i gruppi di utenti che possono utilizzarli e assegnare almeno un tag per contrassegnare i messaggi privati come modello.
Per creare un modello personale gli utenti devono:
- inviare un messaggio personale non crittografato a se stessi taggato con uno dei tag configurati nelle impostazioni del plugin. Solo l’autore del messaggio lo vedrà come un modello privato.
Variabili precompilate
Il plugin supporta le seguenti variabili nei modelli:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
Tutte le variabili sopra elencate supportano il testo di fallback e rimuoveranno la variabile se non è specificato il fallback e la variabile non può essere sostituita.
Sia il titolo che il corpo supportano la sostituzione delle variabili.
Esempio:
Ciao %{reply_to_username,fallback:qualcuno},
...
Cordiali saluti,
%{my_name}
Se reply_to_username non è disponibile, il modello sarà:
Ciao qualcuno,
...
Cordiali saluti,
Arpit Jalan
Migrazione da discourse-canned-replies
Esiste un task rake per migrare le risposte predefinite esistenti ai modelli:
rake "discourse-templates:migrate-from-canned-replies"
Questa operazione ha richiesto solo pochi secondi su Meta per migrare 47 risposte predefinite, quindi dovrebbe essere sicuro utilizzarla a meno che tu non abbia una quantità spropositata di risposte predefinite.
TODO
estendi la funzionalità ad altre aree oltre al composer
consenti l’uso di più categorie principali come fonti di modello
Changelog
- 2022-07-14T03:00:00Z: Aggiunta la possibilità di utilizzare più categorie principali come fonte per i modelli
- 2022-07-18T03:00:00Z: Modelli privati
- 2022-08-10T03:00:00Z: Scorciatoia da tastiera globale
Questo plugin è ora incluso nel core di Discourse come parte di