 |
Summary | Discourse Yearly Review creates a topic on January 1st that summarizes the previous year’s forum activity. (See our examples here on Meta - year-in-review) |
 |
Repository Link | https://github.com/discourse/discourse-yearly-review |
 |
Install Guide | How to install plugins in Discourse |
Initial Setup
Head to your /admin/plugins page to click the discourse-yearly-review 
Settings button:
-
Enter categories to pull data from into the
yearly review categoriessetting. If left blank, it will default to the top 5 public categories. -
Using the
yearly review publish categorysetting, choose a destination category for the review to be posted.
It is highly recommended to set the yearly review publish categoryto the staff or other private category so that you can view the topic before making it public. You might also like to edit it first. -
Then, enable the plugin using the
yearly review enabledsetting.
Features
As you can see at 2022: The Year in Review, data is displayed in two sections - users and topics.
The users section includes:
- Most Time Reading
- Most Topics Created
- Most Replies Created
- Most Replied to
- Most Likes Given
- Most Likes Received
- Most Visits
- Users who have been granted a featured badge (the badge is set by the
yearly review featured badgeSite Setting
The topics section includes:
- Most Read
- Most Liked
- Most Replied to
- Most Popular
- Most Bookmarked
Generating the Yearly Review
The plugin sets thresholds for deciding which topics to display. There need to be a minimum of 10 likes or replies, 5 bookmarks, a score of 10, or one hour’s read time before a topic will be displayed. The topic is published automatically through a background job. The job checks that the plugin is enabled and that it is within the first 31 days of the first month of the year. It then checks to see if a topic with the title yearly_review.topic_title has already been published by the system user. If all checks pass, the topic is published to the category set in the yearly review publish category setting. If this is not configured, the topic will be published to the Uncategorized category.
Extra Options
Yearly review categories
Categories used in this section are those set in the yearly review categories Site Setting. If this setting is not configured, the 5 best public categories from the forum will be chosen. “Best” is determined by the category topics_year count.
Sub-categories of any categories specified in the yearly review categories Site Setting will not be included in the yearly review report. If you want sub-categories to be included in the yearly review report, you will need to explicitly specify them in the yearly review categories Site Setting.
Yearly review exclude staff
The plugin has a yearly review exclude staff setting. It is enabled by default so that staff members are excluded from the users section and topics created by staff are excluded from the topics section.
Yearly review featured badge
A featured badge can be set via the yearly review featured badge setting. A maximum of 15 badge users are displayed. If more than 15 users have been granted this badge, a link to the badge’s page is displayed. If the yearly review featured badge is not configured, this section will not be displayed.
Running the Yearly Review manually
If you don’t want to wait for the background job, you can publish the topic from the rails console with:
Jobs::YearlyReview.new.execute(force: true)
If you want to generate a report for a specific year just add review_year: 'year', e.g.:
Jobs::YearlyReview.new.execute(force: true, review_year: '2021')
Settings
| Name | Description |
|---|---|
| yearly review enabled | Enable the yearly review. |
| yearly review categories | Public categories to pull topics from. The top 5 categories from this group will be selected. If left blank will default to the top 5 public categories. |
| yearly review exclude staff | Exclude Staff from user stats. |
| yearly review include user stats | Add user-identifying stats to the first post of the review topic. |
| yearly review include private categories | Include user activity from private or read-restricted categories in the review. |
| yearly review publish category | The category the review will be published in. |
| yearly review featured badge | Enter the full badge name. Can be left blank. |
Known Issues
-
The data is displayed in HTML tables. Tables are wrapped in
divtags that havedata-review-topic-users="true'anddata-review-featured-topics="true"attributes. This allows the tables to be styled when they are displayed on Discourse. The styles are not copied when emails for the topics are created. Emails sent out for the topic don’t look great. -
The first post in the generated topic is ≈ 40,000 characters due to using HTML. As a result, it cannot be edited unless you first increase the body character limit above this (see Body is limited to 32000 characters; you entered 43659)
-
emojis in titles are not rendered in the featured topic links
Last edited by @nathank 2025-01-06T21:23:15Z
Check document
Perform check on document:
)
ما مدى استمراريته؟ إذا واصلت حذفه، فهل سنظل نرقص في يونيو؟ 