|||
|— | — | —|
|: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.
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.
Puoi trovare tutti i tuoi modelli privati su:
/u/{NOMEUTENTE}/messages/tags/{TAGMODELLOPRIVATO}
Impostazioni:
discourse templates enabled: Attiva il plugindiscourse 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.
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.
Rendi i nuovi argomenti wiki per impostazione predefinitanelle impostazioni della categoria.
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”
Seleziona il modello desiderato, puoi cercare per testo o tag e fare clic sull’icona “incolla”.
Scorciatoia da tastiera
Puoi usare Ctrl+Shift+I su PC o ⌘+Shift+I su Mac per inserire modelli.
Modelli privati
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.
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 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
consentire l’uso di più di una categoria padre come origine dei modelli
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
Questo plugin è ora incluso nel core di Discourse come parte di