Recensione annuale di Discourse

[Discourse]

	Riepilogo	Discourse Yearly Review crea un argomento il 1° gennaio che riassume l’attività del forum dell’anno precedente. (Vedi i nostri esempi qui su Meta - year-in-review)
	Link al Repository	https://github.com/discourse/discourse-yearly-review
	Guida all’installazione	Come installare i plugin in Discourse

Poiché questo è un plugin #ufficiale mantenuto dal team di Discourse, le richieste di #supporto, segnalazioni di bug, problemi di ux e richieste di #funzionalità possono essere inviate nelle rispettive categorie qui su Meta, contrassegnate con l’etichetta del plugin appropriata. Clicca su un link qui sotto per iniziarne uno.

 Supporto  Bug  UX  Funzionalità

Configurazione Iniziale

Vai alla pagina /admin/plugins e clicca sul pulsante delle impostazioni di discourse-yearly-review Impostazioni:

1. Inserisci le categorie da cui estrarre i dati nell’impostazione yearly review categories. Se lasciata vuota, predefinitamente verranno selezionate le prime 5 categorie pubbliche.

2. Utilizzando l’impostazione yearly review publish category, scegli una categoria di destinazione dove pubblicare il riepilogo.

   È altamente consigliato impostare yearly review publish category su una categoria riservata allo staff o privata, in modo da poter visualizzare l’argomento prima di renderlo pubblico. Potresti anche volerlo modificare prima.

3. Quindi, abilita il plugin utilizzando l’impostazione yearly review enabled.

Funzionalità

Come puoi vedere su 2022: The Year in Review, i dati sono visualizzati in due sezioni: utenti e argomenti.

La sezione utenti include:

• Più tempo di lettura
• Più argomenti creati
• Più risposte create
• Più risposte ricevute
• Più “Mi piace” dati
• Più “Mi piace” ricevuti
• Più visite
• Utenti a cui è stata assegnata una badge in evidenza (la badge è impostata dall’impostazione del sito yearly review featured badge)

La sezione argomenti include:

• Più letti
• Più apprezzati
• Più discussi
• Più popolari
• Più segnalati

Generazione del Riepilogo Annuale

Il plugin stabilisce delle soglie per decidere quali argomenti visualizzare. È necessario avere un minimo di 10 “Mi piace” o risposte, 5 segnalazioni, un punteggio di 10 o un’ora di tempo di lettura affinché un argomento venga visualizzato. L’argomento viene pubblicato automaticamente tramite un’attività in background. L’attività verifica che il plugin sia abilitato e che ci si trovi entro i primi 31 giorni del primo mese dell’anno. Successivamente, verifica se è già stato pubblicato un argomento con il titolo yearly_review.topic_title dall’utente di sistema. Se tutti i controlli superano, l’argomento viene pubblicato nella categoria impostata in yearly review publish category. Se questa non è configurata, l’argomento verrà pubblicato nella categoria Non classificata.

Opzioni Aggiuntive

Categorie del riepilogo annuale

Le categorie utilizzate in questa sezione sono quelle impostate nell’impostazione del sito yearly review categories. Se questa impostazione non è configurata, verranno scelte le 5 migliori categorie pubbliche del forum. “Migliori” è determinato dal conteggio topics_year della categoria.

Le sottocategorie di qualsiasi categoria specificata nell’impostazione del sito yearly review categories non saranno incluse nel rapporto del riepilogo annuale. Se desideri includere le sottocategorie nel rapporto del riepilogo annuale, dovrai specificarle esplicitamente nell’impostazione del sito yearly review categories.

Escludere lo staff dal riepilogo annuale

Il plugin dispone di un’impostazione yearly review exclude staff. È abilitata per impostazione predefinita in modo che i membri dello staff siano esclusi dalla sezione utenti e gli argomenti creati dallo staff siano esclusi dalla sezione argomenti.

Badge in evidenza del riepilogo annuale

Un badge in evidenza può essere impostato tramite l’impostazione yearly review featured badge. Vengono visualizzati al massimo 15 utenti con il badge. Se più di 15 utenti hanno ricevuto questo badge, viene visualizzato un link alla pagina del badge. Se yearly review featured badge non è configurato, questa sezione non verrà visualizzata.

Esecuzione manuale del Riepilogo Annuale

Se non vuoi attendere l’attività in background, puoi pubblicare l’argomento dalla console rails con:

Jobs::YearlyReview.new.execute(force: true)

Se desideri generare un rapporto per un anno specifico, aggiungi semplicemente review_year: 'anno', ad esempio:

Jobs::YearlyReview.new.execute(force: true, review_year: '2021')

Ospitato da noi? Se desideri eseguire il Riepilogo Annuale manualmente, puoi contattarci a team@discourse.org e saremo lieti di organizzarlo per te.

Impostazioni

Nome	Descrizione
yearly review enabled	Abilita il riepilogo annuale.
yearly review categories	Categorie pubbliche da cui estrarre gli argomenti. Verranno selezionate le prime 5 categorie da questo gruppo. Se lasciata vuota, predefinitamente verranno selezionate le prime 5 categorie pubbliche.
yearly review exclude staff	Escludi lo staff dalle statistiche degli utenti.
yearly review include user stats	Aggiungi statistiche identificative degli utenti al primo post dell’argomento del riepilogo.
yearly review include private categories	Includi l’attività degli utenti da categorie private o con restrizioni di lettura nel riepilogo.
yearly review publish category	La categoria in cui verrà pubblicato il riepilogo.
yearly review featured badge	Inserisci il nome completo del badge. Può essere lasciato vuoto.

Ospitato da noi? Questo plugin è disponibile su tutti i nostri livelli di hosting Yearly Review | Discourse - Civilized Discussion

---

Problemi Noti

• I dati sono visualizzati in tabelle HTML. Le tabelle sono racchiuse in tag div che hanno gli attributi data-review-topic-users="true' e data-review-featured-topics="true". Questo permette di applicare stili alle tabelle quando vengono visualizzate su Discourse. Gli stili non vengono copiati quando vengono creati gli email per gli argomenti. Gli email inviati per l’argomento non hanno un aspetto ottimale.

• Il primo post nell’argomento generato è di circa 40.000 caratteri a causa dell’uso di HTML. Di conseguenza, non può essere modificato a meno che non si aumenti prima il limite di caratteri del corpo oltre questo valore (vedi Body is limited to 32000 characters; you entered 43659)

• Gli emoji nei titoli non vengono visualizzati nei link degli argomenti in evidenza

[Samantha_O]

Alcuni bei miglioramenti che potrebbero essere apportati a questo plugin, spero di condividerlo nel posto giusto? Fatemi sapere se non è così.

• Possibilità di escludere lo staff dall’elenco degli utenti, ma includere comunque gli argomenti che creano
• Possibilità di escludere TL4 dall’elenco degli utenti (e come sopra, includere comunque gli argomenti che creano)
• Possibilità di creare più post di revisione in modo da poterne avere uno per i membri TL4 (lo usiamo per i dipendenti) e per i membri dello staff, e poi avere un post solo per i membri della community

[Ayelen_Rives (Aye Rives)]

Ciao!
Ho installato il plugin quest’anno, ma anche se è abilitato, non so quando viene pubblicata la recensione, o se devo fare qualcos’altro per pubblicarla.

Qualcuno può farmelo sapere?
Grazie mille!!

[Aaron_Walsh]

Saluti @Ayelen_Rives,

Ispezionando la console amministrativa, ti verrà presentato il seguente ausilio visivo:

Ulteriori esami all’interno del plugin intitolato ‘plugin:discourse-yearly-review’ rivelano un altro esempio illustrativo:

È imperativo che durante la configurazione delle impostazioni, si designi la categoria di pubblicazione della revisione annuale allo staff o a un’altra categoria ristretta. Ciò garantisce una revisione preliminare prima di consentire una visibilità più ampia.

[Ayelen_Rives (Aye Rives)]

Grazie mille, Aaron!

Inaspettatamente, non vedo quei messaggi nella console amministrativa, né nelle impostazioni:

La categoria di pubblicazione è Staff, quindi scoprirò il 1° gennaio se è stata creata.

Grazie ancora e buone feste!

[Roi]

Buon anno!

Il plugin non è stato eseguito qui in due forum. E ora mostra il messaggio per il 1° gennaio 2025. Strano.

L’ho eseguito manualmente nella console rails in un forum ed è tornato in inglese, non in tedesco, la lingua del forum.

Qualcosa non va/non andava qui.

[JammyDodger]

Non è ancora arrivato nemmeno qui su meta. Ho seguito il consiglio e l’ho impostato per pubblicarlo prima su #staff, che penso sia l’unica differenza rispetto all’anno scorso?

Speravo che apparisse magicamente con un po’ di pazienza, ma potrei essere ottimista.

[Roi]

Non ho cambiato nulla nella configurazione, nemmeno il forum per controllarlo prima come membro dello staff e poi spostarlo,

Nel mio secondo forum non c’è ancora nulla. E qui sono le 11:24.

Sembra che qualcosa sia rotto.

È necessaria una bandiera linguistica quando lo si esegue manualmente? Non voglio tradurre tutto anche nel secondo forum.

[JammyDodger]

Sarei tentato di lasciarlo un po’ più a lungo per vedere se c’è un ritardo nel processo in background, ma non sono nemmeno sicuro del perché l’attivazione manuale dovrebbe dare un risultato diverso rispetto all’esecuzione automatica del processo in background?

Potremmo aver bisogno di qualcuno più esperto che intervenga.

[packman (Chris McMahon)]

Non è partito automaticamente, ma l’ho eseguito manualmente e sembra aver funzionato bene, anche se non volevo che fosse in una lingua diversa.

[Jagster (Jakke Flemming)]

La mattina di oggi, più o meno, sidekiq mi ha detto che la revisione annuale sarebbe stata programmata tra 50 minuti e, al momento, sarebbero state circa le 11 ora locale. Non ho aspettato, però, ma l’ho fatta manualmente. Nessun problema e anche la lingua era corretta.

Dopo di che sono stato costretto a declassare i miei moderatori e a rifare sidekiq perché erano molto turbati: ho escluso lo staff… Non potevo permettere lo staff perché altrimenti io, come amministratore molto attivo, avrei dominato completamente le liste, quindi ho scelto la strada più veloce.

Beh, questa è un’altra storia, ma potremmo avere un po’ più di libertà per includere o escludere gruppi?

[Roi]

Santo c… Nell’altro forum c’è il thread del 2023… 14:31 ora locale. E in tedesco. Quindi, ancora misterioso…

[JammyDodger]

Alla fine ho attivato il nostro da Sidekiq.

2023: The Year in Review

2023's Top Users Most Time Reading User Hours Read [avatar] @Canapin 294 [avatar] @Don 233 [avatar] @Moin 186 [avatar] @merefield 158 [avatar] @pfaffman 139 [avatar] @simon 127 [avatar] @Arkshine 118 [avatar] @Jagster 117 [avatar] @ClawdiaWolf 82 [avatar] @Heliosurge 69 Most Topics User Topics [avatar] @twofoursixeight 84 [avatar] @jordan-violet 69 [avatar] @Don 67 [avatar] @danielabc 65 [avatar] @Jagster 62 [avatar] @jidanni 62 [avatar] @Cana…

[tobiaseigen]

Sui miei siti l’argomento è stato generato senza che dovessi eseguirlo manualmente in sidekiq.

@Samantha_O

• Possibilità di escludere lo staff dall’elenco degli utenti, ma includere comunque gli argomenti che creano
• Possibilità di escludere TL4 dall’elenco degli utenti (e come sopra, includere comunque gli argomenti che creano)
• Possibilità di creare più post di revisione in modo da poterne avere uno per TL4 (lo usiamo per i dipendenti) e per i membri dello staff, e poi avere un post solo per i membri della community

Questi sono ottimi suggerimenti. Grazie! È interessante sentire altri casi d’uso per questo plugin. Lo esamineremo più attentamente presto, basandoci sull’esperienza di quest’anno, per vedere cosa potremmo fare per migliorarlo prima del prossimo anno!

Nel frattempo, per questa volta, puoi modificare il post una volta pubblicato come ritieni opportuno.

Un comportamento interessante che ho notato è che se elimini l’argomento generato, ne creerà uno nuovo il giorno successivo, finché il plugin è abilitato. Quindi potresti giocare con le impostazioni e generare più versioni dell’argomento di revisione annuale, copiare il testo da esse ed quindi pubblicare nuovi argomenti tu stesso come ritieni opportuno. Se hai accesso a /sidekiq, puoi trovare il job lì ed eseguirlo immediatamente.

[Jagster (Jakke Flemming)]

@tobiaseigen

se elimini l’argomento generato

E questo è il motivo per cui un consiglio di pubblicare prima la recensione in una categoria più privata, cioè Staff, e poi spostarla in pubblico, in realtà non è un buon consiglio A meno che un amministratore non voglia mantenere due versioni.

Non è un grosso problema, comunque.

[Ayelen_Rives (Aye Rives)]

@Ayelen_Rives

Lo scoprirò il 1° gennaio se è stato creato.

Ciao! Fortunatamente il plugin si è attivato il 1° gennaio senza alcun problema!

Ora ho alcune domande su come funziona perché alcuni report (come “Most Topics” e “Most likes given”) mostrano risultati diversi rispetto alla pagina “Users” per lo stesso periodo.

Ad esempio, per Most topics, la pagina “Users” mostra per prima l’utente “S”:

E la revisione annuale mostra per prima l’utente “C” e non mostra mai l’utente “S” nella tabella:

(Mi dispiace, devo sfocare le immagini per motivi di riservatezza aziendale, ma penso sia più chiaro se le aggiungo. Inoltre, la tabella è rotta, puoi ignorarla )

Qualcuno sa perché questo potrebbe accadere? Altri report mostrano esattamente le stesse informazioni, ma “Most topics” e “Most likes given” mostrano utenti diversi.

Grazie mille per il tuo aiuto!

[tobiaseigen]

@Jagster

E questo è il motivo per cui un consiglio per pubblicare prima la recensione in una categoria più privata, cioè Staff, e poi spostarla al pubblico, non è in realtà un consiglio così buono A meno che un amministratore non voglia mantenere due versioni.

Whoa, non ero a conoscenza del fatto che questo fosse ciò che accade. L’ho appena testato e hai ragione! Questo è un bug. Non dovrebbe creare un secondo argomento di revisione annuale se ne esiste già uno.

Passaggi per la replica:

1. una volta creato l’argomento di revisione annuale, spostalo in una categoria diversa
2. attiva la creazione dell’argomento di revisione annuale tramite /sidekiq
3. viene creato un secondo argomento di revisione annuale.

Se ti imbatti in questo problema, ti suggerisco di disabilitare il plugin. Esamineremo presto questo plugin per correggere i bug e migliorarlo prima del prossimo anno.

[ganncamp (G Ann Campbell)]

@tobiaseigen

Un comportamento interessante che ho notato è che se elimini l’argomento generato, ne creerà uno nuovo il giorno successivo, a condizione che il plugin sia abilitato.

quanto è persistente? Se continuo a eliminarlo, continueremo a fare il balletto a giugno?

E questo significa che non ho bisogno di contattare il supporto per generare retroattivamente il post per il mio sito? Apparirà domani?

[Jagster (Jakke Flemming)]

@ganncamp

quanto è persistente?

Davvero. Funziona tramite sidekiq ogni giorno.

[Moin]

@ganncamp

Se continuo a cancellarlo, faremo ancora la danza a giugno?

Spero che finisca a fine gennaio.

The Yearly Review plugin keeps creating new topics

Thanks for following up on this. Relying on the topic’s title to prevent creating multiple review topics is a really flaky approach (that’s my fault.) Once January ends, the issue won’t come up again until next year. @JammyDodger, maybe you could pass a note to the Discourse team to look into coming up with a better way of preventing multiple topics from being created. That should get done before January 2024. Time sure flies