Modelli di Discourse

[Discourse]

	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.

Essendo un plugin official mantenuto dal team di Discourse, le richieste di Support, Contribute > Bug, Contribute > UX e Contribute > Feature possono essere inviate nelle rispettive categorie qui su Meta, taggando con l’apposito tag del plugin. Clicca su un link qui sotto per iniziare.

 Supporto  Bug  UX  Funzionalità

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

Consiglio: Le stesse impostazioni per la modifica dei topic si applicheranno ai topic “modello”. Se desideri che chiunque abbia accesso in scrittura nella categoria possa modificare i modelli esistenti, dovresti attivare Crea nuovi topic come wiki di default nelle 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.

La scorciatoia da tastiera funzionerà all’interno di qualsiasi textarea su Discourse.

Modelli privati

I modelli privati funzioneranno solo sulle istanze in cui sono abilitati sia i messaggi privati che i tag.

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.

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