Discourse Jahresrückblick

[Discourse]

	Zusammenfassung	Discourse Yearly Review erstellt am 1. Januar ein Thema, das die Forenaktivitäten des vorherigen Jahres zusammenfasst. (Siehe unsere Beispiele hier auf Meta - year-in-review)
	Repository-Link	https://github.com/discourse/discourse-yearly-review
	Installationsanleitung	So installieren Sie Plugins in Discourse

Da dies ein official Plugin ist, das vom Discourse-Team gepflegt wird, können #support-, #bug-, #ux- und #feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie auf einen der untenstehenden Links, um eines zu erstellen.

 Support  Fehler  UX  Funktion

Erste Einrichtung

Gehen Sie zu Ihrer /admin/plugins-Seite, um auf die Schaltfläche discourse-yearly-review Einstellungen zu klicken:

1. Geben Sie Kategorien ein, aus denen Daten gezogen werden sollen, in die Einstellung yearly review categories. Wenn dies leer gelassen wird, werden standardmäßig die 5 öffentlichsten Kategorien verwendet.

2. Wählen Sie mit der Einstellung yearly review publish category eine Zielkategorie aus, in der die Zusammenfassung veröffentlicht werden soll.

   Es wird dringend empfohlen, die Einstellung yearly review publish category auf eine Mitarbeiter- oder andere private Kategorie zu setzen, damit Sie das Thema vor der Veröffentlichung für die Öffentlichkeit einsehen können. Möglicherweise möchten Sie es auch zuerst bearbeiten.

3. Aktivieren Sie dann das Plugin mit der Einstellung yearly review enabled.

Funktionen

Wie Sie unter 2022: The Year in Review sehen können, werden die Daten in zwei Abschnitten angezeigt – Benutzer und Themen.

Der Benutzerabschnitt umfasst:

• Meiste Lesezeit
• Meiste erstellten Themen
• Meiste erstellten Antworten
• Meiste beantwortet
• Meiste gegebene Likes
• Meiste erhaltene Likes
• Meiste Besuche
• Benutzer, die ein herausragendes Badge erhalten haben (das Badge wird durch die Site-Einstellung yearly review featured badge festgelegt)

Der Themenabschnitt umfasst:

• Meist gelesen
• Meist geliked
• Meist beantwortet
• Beliebt
• Meist gebookmarkt

Erstellen der Jahreszusammenfassung

Das Plugin legt Schwellenwerte fest, um zu entscheiden, welche Themen angezeigt werden sollen. Ein Thema wird nur angezeigt, wenn es mindestens 10 Likes oder Antworten, 5 Bookmarks, eine Punktzahl von 10 oder eine Lesezeit von einer Stunde gibt. Das Thema wird automatisch über einen Hintergrundjob veröffentlicht. Der Job prüft, ob das Plugin aktiviert ist und ob es sich innerhalb der ersten 31 Tage des ersten Monats des Jahres befindet. Anschließend wird geprüft, ob bereits ein Thema mit dem Titel yearly_review.topic_title vom Systembenutzer veröffentlicht wurde. Wenn alle Prüfungen bestehen, wird das Thema in der Kategorie veröffentlicht, die in der Einstellung yearly review publish category festgelegt ist. Wenn dies nicht konfiguriert ist, wird das Thema in der Kategorie „Nicht kategorisiert" veröffentlicht.

Zusätzliche Optionen

Jahreszusammenfassungs-Kategorien

Die in diesem Abschnitt verwendeten Kategorien sind diejenigen, die in der Site-Einstellung yearly review categories festgelegt sind. Wenn diese Einstellung nicht konfiguriert ist, werden die 5 besten öffentlichen Kategorien des Forums ausgewählt. „Beste" wird anhand der Anzahl der topics_year in der Kategorie bestimmt.

Unterkategorien von Kategorien, die in der Site-Einstellung yearly review categories angegeben sind, werden nicht in den Jahreszusammenfassungsbericht aufgenommen. Wenn Sie möchten, dass Unterkategorien im Jahreszusammenfassungsbericht enthalten sind, müssen Sie diese explizit in der Site-Einstellung yearly review categories angeben.

Jahreszusammenfassung Mitarbeiter ausschließen

Das Plugin verfügt über eine Einstellung yearly review exclude staff. Sie ist standardmäßig aktiviert, sodass Mitarbeiter aus dem Benutzerabschnitt ausgeschlossen werden und von Mitarbeitern erstellte Themen aus dem Themenabschnitt ausgeschlossen werden.

Herausragendes Badge der Jahreszusammenfassung

Ein herausragendes Badge kann über die Einstellung yearly review featured badge festgelegt werden. Es werden maximal 15 Badge-Nutzer angezeigt. Wenn mehr als 15 Benutzer dieses Badge erhalten haben, wird ein Link zur Seite des Badges angezeigt. Wenn die Einstellung yearly review featured badge nicht konfiguriert ist, wird dieser Abschnitt nicht angezeigt.

Jahreszusammenfassung manuell ausführen

Wenn Sie nicht auf den Hintergrundjob warten möchten, können Sie das Thema über die Rails-Konsole mit folgendem Befehl veröffentlichen:

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

Wenn Sie einen Bericht für ein bestimmtes Jahr erstellen möchten, fügen Sie einfach review_year: 'Jahr' hinzu, z. B.:

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

Von uns gehostet? Wenn Sie die Jahreszusammenfassung manuell ausführen möchten, können Sie uns unter team@discourse.org kontaktieren. Wir helfen Ihnen gerne dabei.

Einstellungen

Name	Beschreibung
yearly review enabled	Jahreszusammenfassung aktivieren.
yearly review categories	Öffentliche Kategorien, aus denen Themen gezogen werden sollen. Aus dieser Gruppe werden die 5 besten Kategorien ausgewählt. Wenn leer gelassen, werden standardmäßig die 5 öffentlichsten Kategorien verwendet.
yearly review exclude staff	Mitarbeiter von den Benutzerstatistiken ausschließen.
yearly review include user stats	Benutzeridentifizierende Statistiken zum ersten Beitrag des Zusammenfassungsthemas hinzufügen.
yearly review include private categories	Benutzeraktivitäten aus privaten oder lesebeschränkten Kategorien in der Zusammenfassung einschließen.
yearly review publish category	Die Kategorie, in der die Zusammenfassung veröffentlicht wird.
yearly review featured badge	Geben Sie den vollständigen Badge-Namen ein. Kann leer gelassen werden.

Von uns gehostet? Dieses Plugin ist in allen unseren Hosting-Stufen verfügbar: Yearly Review | Discourse - Civilized Discussion

---

Bekannte Probleme

• Die Daten werden in HTML-Tabellen angezeigt. Tabellen sind in div-Tags eingewickelt, die die Attribute data-review-topic-users="true" und data-review-featured-topics="true" haben. Dies ermöglicht es, die Tabellen zu formatieren, wenn sie in Discourse angezeigt werden. Die Stile werden nicht kopiert, wenn E-Mails für die Themen erstellt werden. E-Mails, die für das Thema gesendet werden, sehen nicht gut aus.

• Der erste Beitrag im generierten Thema hat ≈ 40.000 Zeichen aufgrund der Verwendung von HTML. Daher kann er nicht bearbeitet werden, es sei denn, Sie erhöhen zuerst das Zeichenlimit für den Textkörper über diesen Wert hinaus (siehe Body is limited to 32000 characters; you entered 43659).

• Emojis in Titeln werden in den Links zu herausragenden Themen nicht gerendert.

[Samantha_O]

Ein paar nette Verbesserungen, die an diesem Plugin vorgenommen werden könnten. Ich hoffe, ich teile dies am richtigen Ort? Lassen Sie es mich wissen, wenn nicht.

• Möglichkeit, Mitarbeiter von der Benutzerliste auszuschließen, aber dennoch die von ihnen erstellten Themen einzubeziehen
• Möglichkeit, TL4 von der Benutzerliste auszuschließen (und wie oben erwähnt, dennoch die von ihnen erstellten Themen einzubeziehen)
• Möglichkeit, mehrere Überprüfungsposts zu erstellen, damit wir einen für TL4 (wir verwenden dies für Mitarbeiter) und Mitarbeiter haben und dann einen reinen Community-Mitglieder-Post haben können.

[Ayelen_Rives (Aye Rives)]

Hallo!
Ich habe das Plugin dieses Jahr installiert, aber obwohl es aktiviert ist, weiß ich nicht, wann die Bewertung veröffentlicht wird oder ob ich noch etwas anderes tun muss, um sie zu veröffentlichen.

Kann mir jemand Bescheid geben?
Vielen Dank!!

[Aaron_Walsh]

Hallo @Ayelen_Rives,

Bei der Überprüfung der Admin-Konsole wird Ihnen die folgende visuelle Hilfe präsentiert:

Eine weitere Untersuchung des Plugins mit dem Titel „plugin:discourse-yearly-review“ zeigt ein weiteres illustratives Beispiel:

Es ist unerlässlich, dass Sie bei der Konfiguration der Einstellungen die Kategorie für die Veröffentlichung der Jahresrückblick entweder auf das Personal oder eine andere eingeschränkte Kategorie festlegen. Dies gewährleistet eine vorläufige Überprüfung, bevor eine breitere Sichtbarkeit zugelassen wird.

[Ayelen_Rives (Aye Rives)]

Vielen Dank, Aaron!

Unerwarteterweise sehe ich diese Nachrichten weder in der administrativen Konsole noch in den Einstellungen:

Die Kategorie „Veröffentlichen“ ist „Mitarbeiter“, daher werde ich am 1. Januar herausfinden, ob sie erstellt wurde.

Nochmals vielen Dank und frohe Feiertage!

[Roi]

Frohes neues Jahr!

Das Plugin lief hier in zwei Foren nicht. Und jetzt wird die Nachricht für den 1. Januar 2025 angezeigt. Seltsam.

Ich habe es manuell in der Rails-Konsole in einem Forum ausgeführt und es kam auf Englisch zurück, nicht auf Deutsch, der Sprache des Forums.

Hier ist etwas schiefgelaufen/schiefgelaufen.

[JammyDodger]

Es ist auch hier auf Meta noch nicht angekommen. Ich habe den Rat befolgt und es so eingestellt, dass es zuerst auf #staff veröffentlicht wird, was, glaube ich, der einzige Unterschied zum letzten Jahr ist?

Ich hatte gehofft, dass es mit etwas Geduld wie von Zauberhand auftauchen würde, aber vielleicht bin ich optimistisch.

[Roi]

Ich habe nichts an der Konfiguration geändert, nicht einmal das Forum, um es zuerst als Mitarbeiter zu überprüfen und es dann zu verschieben.

In meinem zweiten Forum ist immer noch nichts. Und es ist hier 11:24 Uhr.

Es sieht so aus, als ob etwas kaputt ist.

Wird eine Sprachflagge benötigt, wenn es manuell ausgeführt wird? Ich möchte nicht alles im zweiten Forum auch übersetzen.

[JammyDodger]

Ich wäre versucht, es noch etwas länger zu lassen, um zu sehen, ob es eine Verzögerung im Hintergrundauftrag gibt, aber ich bin mir auch nicht sicher, warum das manuelle Auslösen ein anderes Ergebnis liefern würde als das automatische Ausführen des Hintergrundauftrags?\n\nWir brauchen vielleicht jemanden mit mehr Wissen, der sich einbringt.

[packman (Chris McMahon)]

Er lief bei mir nicht automatisch, aber ich habe ihn gerade manuell ausgeführt und es scheint funktioniert zu haben, obwohl ich ihn nicht in einer anderen Sprache haben wollte.

[Jagster (Jakke Flemming)]

Heute Morgen sagte mir Sidekiq, dass die jährliche Überprüfung in 50 Minuten geplant sei, was zu dieser Zeit etwa 11 Uhr Ortszeit wäre. Ich habe jedoch nicht gewartet, sondern es manuell erledigt. Keine Probleme und die Sprache war auch richtig.

Danach war ich gezwungen, meine Moderatoren herabzustufen und Sidekiq erneut auszuführen, da sie sehr verärgert waren – ich hatte das Personal ausgeschlossen… Ich konnte das Personal nicht zulassen, weil ich als wirklich aktiver Administrator die Listen total dominieren würde, also wählte ich den schnellsten Weg.

Nun, das ist eine andere Geschichte, aber könnten wir etwas mehr freie Hand beim Einbeziehen oder Ausschließen von Gruppen haben?

[Roi]

Heilige Schei… Im anderen Forum gibt es den Thread von 2023… 14:31 Uhr Ortszeit. Und auf Deutsch. Also, immer noch mysteriös…

[JammyDodger]

Ich habe unseres am Ende von Sidekiq ausgelöst.

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]

Auf meinen Websites wurde das Thema generiert, ohne dass ich es manuell in Sidekiq ausführen musste.

@Samantha_O

• Möglichkeit, Mitarbeiter von der Benutzerliste auszuschließen, aber dennoch die von ihnen erstellten Themen einzuschließen
• Möglichkeit, TL4 von der Benutzerliste auszuschließen (und wie oben, dennoch die von ihnen erstellten Themen einzuschließen)
• Möglichkeit, mehrere Überprüfungsposts zu erstellen, damit wir einen für TL4 (wir verwenden dies für Mitarbeiter) und Mitarbeiter und dann einen Post für Community-Mitglieder haben könnten

Das sind großartige Vorschläge. Danke! Es ist interessant, mehr Anwendungsfälle für dieses Plugin zu hören. Wir werden uns dies bald genauer ansehen, basierend auf den Erfahrungen dieses Jahres, um zu sehen, was wir verbessern können, bevor das nächste Jahr kommt!

In der Zwischenzeit können Sie für diese Runde den Beitrag bearbeiten, sobald er veröffentlicht wurde, wie Sie es für richtig halten.

Ein interessantes Verhalten, das ich bemerkt habe, ist, dass, wenn Sie das generierte Thema löschen, es am nächsten Tag ein neues erstellt, solange das Plugin aktiviert ist. Sie könnten also mit den Einstellungen herumspielen und mehrere Versionen des jährlichen Überprüfungsthemas generieren, den Text daraus kopieren und dann selbst neue Themen veröffentlichen, wie Sie es für richtig halten. Wenn Sie Zugriff auf /sidekiq haben, finden Sie den Job dort und können ihn sofort ausführen.

[Jagster (Jakke Flemming)]

@tobiaseigen

wenn man das generierte Thema löscht

Und deshalb ist der Tipp, die Rezension zuerst in einer privateren Kategorie, z. B. „Mitarbeiter“, zu veröffentlichen und dann öffentlich zu verschieben, eigentlich kein guter Rat Es sei denn, ein Administrator möchte zwei Versionen behalten.

Aber keine große Sache.

[Ayelen_Rives (Aye Rives)]

@Ayelen_Rives

Ich werde am 1. Januar herausfinden, ob es erstellt wurde.

Hallo! Glücklicherweise hat das Plugin am 1. Januar ohne Probleme selbst ausgelöst!

Ich habe jetzt einige Fragen dazu, wie es funktioniert, da einige Berichte (wie „Meiste Themen“ und „Meiste vergebene Likes“) für denselben Zeitraum andere Ergebnisse als die Benutzerseite anzeigen.

Zum Beispiel zeigt die Benutzerseite für Meiste Themen zuerst den Benutzer „S“:

Und die Jahresübersicht zeigt zuerst den Benutzer „C“ und zeigt den Benutzer „S“ nie in der Tabelle an:

(Entschuldigung, ich musste die Bilder aus Gründen der Unternehmensvertraulichkeit unkenntlich machen, aber ich denke, es ist klarer, wenn ich sie hinzufüge. Außerdem ist die Tabelle kaputt, Sie können sie ignorieren )

Weiß jemand, warum das passieren könnte? Andere Berichte zeigen genau die gleichen Informationen an, aber „Meiste Themen“ und „Meiste Likes vergeben“ zeigen unterschiedliche Benutzer an.

Vielen Dank für Ihre Hilfe!

[tobiaseigen]

@Jagster

Und deshalb ist der Tipp, die Überprüfung zuerst in einer privateren Kategorie, d. h. „Mitarbeiter“, zu veröffentlichen und sie dann öffentlich zu machen, eigentlich kein guter Rat Es sei denn, ein Administrator möchte zwei Versionen behalten.

Wow, das war mir nicht bewusst, dass das passiert. Ich habe es gerade getestet und du hast Recht! Das ist ein Fehler. Es sollte kein zweites jährliches Überprüfungsthema erstellt werden, wenn bereits eines vorhanden ist.

Schritte zur Reproduktion:

1. Sobald ein jährliches Überprüfungsthema erstellt wurde, verschieben Sie es in eine andere Kategorie
2. Auslösen der Erstellung eines jährlichen Überprüfungsthemas über /sidekiq
3. Ein zweites jährliches Überprüfungsthema wird erstellt.

Wenn Sie von diesem Problem betroffen sind, empfehle ich Ihnen, das Plugin zu deaktivieren. Wir werden uns dieses Plugin bald ansehen, um Fehler zu beheben und es für das nächste Jahr zu verbessern.

[ganncamp (G Ann Campbell)]

@tobiaseigen

Ein interessantes Verhalten, das ich bemerkt habe, ist, dass, wenn Sie das generierte Thema löschen, es am nächsten Tag ein neues erstellt, solange das Plugin aktiviert ist.

wie hartnäckig ist es? Wenn ich es weiter lösche, werden wir dann im Juni noch tanzen?

Und bedeutet das, dass ich mich nicht an den Support wenden muss, um den Beitrag für meine Website nachträglich zu generieren? Er wird einfach morgen erscheinen?

[Jagster (Jakke Flemming)]

@ganncamp

Wie hartnäckig ist es?

Wirklich. Es funktioniert jeden Tag über Sidekiq.

[Moin]

@ganncamp

Wenn ich es weiter lösche, tanzen wir dann im Juni noch?

Ich hoffe, es wird Ende Januar aufhören.

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