Discourse Jahresrückblick

[Discourse]

	Zusammenfassung	Discourse Jahresrückblick erstellt am 1. Januar ein Thema, das die Forumaktivitäten des vergangenen 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-, #contribute:bug-, #contribute:ux- und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie unten auf einen Link, um eines zu starten.

 Support  Fehler  UX  Funktion

Erste Einrichtung

Gehen Sie zu Ihrer /admin/plugins-Seite und klicken Sie auf den Button „discourse-yearly-review Einstellungen“:

1. Geben Sie im Einstellungsfeld yearly review categories die Kategorien ein, aus denen Daten extrahiert werden sollen. Wenn dieses Feld leer bleibt, werden standardmäßig die 5 öffentlichsten Kategorien verwendet.

2. Wählen Sie mithilfe der Einstellung yearly review publish category eine Zielkategorie aus, in der der Rückblick veröffentlicht werden soll.

   Es wird dringend empfohlen, die Einstellung yearly review publish category auf eine Mitarbeiter- oder andere private Kategorie festzulegen, damit Sie das Thema vor der Veröffentlichung prüfen und ggf. bearbeiten können.

3. Aktivieren Sie anschließend das Plugin über die Einstellung yearly review enabled.

Funktionen

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

Der Abschnitt „Benutzer“ umfasst:

• Meiste Lesezeit
• Meiste erstellte Themen
• Meiste erstellte Antworten
• Meiste beantwortete Themen
• Meiste gegebene Likes
• Meiste erhaltene Likes
• Meiste Besuche
• Benutzer, die ein hervorgehobenes Abzeichen erhalten haben (das Abzeichen wird über die Site-Einstellung yearly review featured badge festgelegt)

Der Abschnitt „Themen“ umfasst:

• Meist gelesen
• Meist geliked
• Meist beantwortet
• Beliebtestes
• Meist gebookmarkt

Erstellen des Jahresrückblicks

Das Plugin legt Schwellenwerte fest, um zu entscheiden, welche Themen angezeigt werden sollen. Ein Thema wird nur angezeigt, wenn mindestens 10 Likes oder Antworten, 5 Bookmarks, ein Score von 10 oder eine Lesezeit von einer Stunde vorliegen. Das Thema wird automatisch über einen Hintergrundjob veröffentlicht. Der Job prüft, ob das Plugin aktiviert ist und ob wir uns innerhalb der ersten 31 Tage des ersten Monats des Jahres befinden. 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 über die Einstellung yearly review publish category festgelegten Kategorie veröffentlicht. Ist diese nicht konfiguriert, wird das Thema in der Kategorie „Nicht kategorisiert“ veröffentlicht.

Zusätzliche Optionen

Jahresrückblick-Kategorien

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

Unter-Kategorien beliebiger in der Site-Einstellung yearly review categories angegebener Kategorien werden nicht im Jahresrückblicksbericht berücksichtigt. Wenn Sie möchten, dass Unter-Kategorien im Bericht enthalten sind, müssen Sie diese explizit in der Site-Einstellung yearly review categories angeben.

Jahresrückblick – 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.

Jahresrückblick – Hervorgehobenes Abzeichen

Ein hervorgehobenes Abzeichen kann über die Einstellung yearly review featured badge festgelegt werden. Es werden maximal 15 Benutzer mit diesem Abzeichen angezeigt. Wenn mehr als 15 Benutzer dieses Abzeichen erhalten haben, wird ein Link zur Seite des Abzeichens angezeigt. Ist die Einstellung yearly review featured badge nicht konfiguriert, wird dieser Abschnitt nicht angezeigt.

Jahresrückblick 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 den Jahresrückblick manuell ausführen möchten, kontaktieren Sie uns bitte unter team@discourse.org. Wir helfen Ihnen gerne dabei.

Einstellungen

Name	Beschreibung
yearly review enabled	Jahresrückblick aktivieren.
yearly review categories	Öffentliche Kategorien, aus denen Themen extrahiert werden sollen. Aus dieser Gruppe werden die Top-5-Kategorien ausgewählt. Wenn leer gelassen, werden standardmäßig die Top-5-öffentlichen Kategorien verwendet.
yearly review exclude staff	Mitarbeiter von der Benutzerstatistik ausschließen.
yearly review include user stats	Benutzeridentifizierende Statistiken zum ersten Beitrag des Rückblick-Themas hinzufügen.
yearly review include private categories	Benutzeraktivitäten aus privaten oder lesebeschränkten Kategorien im Rückblick berücksichtigen.
yearly review publish category	Die Kategorie, in der der Rückblick veröffentlicht wird.
yearly review featured badge	Geben Sie den vollständigen Abzeichennamen ein. Kann leer gelassen werden.

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

---

Bekannte Probleme

• Die Daten werden in HTML-Tabellen angezeigt. Tabellen sind in div-Tags mit den Attributen data-review-topic-users="true" und data-review-featured-topics="true" eingewickelt. Dies ermöglicht das Styling der Tabellen, wenn sie in Discourse angezeigt werden. Die Stile werden jedoch nicht in E-Mails übernommen, die für die Themen erstellt werden. Die für das Thema versendeten E-Mails sehen nicht besonders gut aus.

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

• Emojis in Titeln werden in den Links zu hervorgehobenen 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