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.