Discourse Gamification

:discourse2: Summary Discourse Gamification adds customizable scoring (karma, kudos, points) and leaderboards to your instance.
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-gamification
:open_book: Install Guide How to install plugins in Discourse
:test_tube: Demo Leaderboard

Features

While Discourse ships, out of the box, with gamification features (badges, trust levels) some communities want to take it to another level. Thatā€™s where GitHub - discourse/discourse-gamification comes in.

This plugin allows admins to easily create and tweak community scoring contests, where points are awarded by participating in the community.

Points are automatically updated every 5 minutes for events of the day, and we re-calculate scores from the last 10 days once a day.

Cheers

Users are awarded ā€œcheersā€ by performing certain actions on the community. Each user cheer score appear on their user card, user profile and can be enabled on the user directory.

user card example with cheers

Like the plugin but the name cheers isnā€™t the best for your community? You can rename it to anything using Customize all text in Discourse.

Leaderboards

Admins can create multiple leaderboards, and each one can have a custom:

  • start date
  • end date
  • Competing users
  • Leaderboard privacy

By default, we ship with a default leaderboard at /leaderboard that will list all users from the first day where scores started to be awarded.

You can see a demo of it at Discourse Meta

Scorables

Currently, the following events award cheers:

See roadmap for upcoming scorables.

Score backfill

You can run a backfill to calculate the historical scores through the UI using the ā€˜Recalculate Scoresā€™ button on your /admin/plugins/gamification page:

This can also be used to recalculate the leaderboard if you make any changes to your scorables or eligible scoring categories. You can generate a rescore up to 5 times a day, and can select a range of time frames (or set a custom one):

select timeframe timefarne options

Configuration

Global customizations are:

  • each action score multiplier
  • Restrict categories where points can be earned
  • enable and disable the plugin

Those plugin-level settings live at /admin/site_settings/category/plugins?filter=plugin%3Adiscourse-gamification.

To create, delete and update leaderboards, admins can visit /admin/plugins/gamification.

Use as widget

This can also be displayed as a widget in a smaller format, inside the Right Sidebar Blocks theme component. More info to be found there.

Badges based on score

You can have automatic badges based on the gamification score using Enable Badge SQL

Here is an example badge when a user has over 9000 cheers:

SELECT user_id, current_timestamp AS granted_at 
FROM gamification_scores
WHERE (:backfill OR user_id IN (:user_ids))
GROUP BY 1
HAVING SUM(score) > 9000

Changelog

  • 2022-05-02T03:00:00Z - Public Release
  • 2022-05-10T05:00:00Z - Update roadmap with recent changes

Roadmap

(roughly ordered)

  • Make leaderboard respect prioritize usernames in ux being disabled

  • Use higher resolutions avatars in leaderboard podium

  • Add custom per-badge scoring

  • Add per-reaction score awarding (requires Discourse Reactions)

  • Add chat-events scoring (requires Discourse Chat)

  • Add poll events scoring (created poll, voted in poll)

  • Add media events scoring (posted image, posted video, posted onebox)

Implemented:

  • Fix i18n table title in custom score column on user directory
  • Ignore staged users
  • Ignore anonymized users (email match @anonymized.invalid)
  • Style leaderboard edit form
  • Leaderboard ā€œyouā€ link needs a larger offset to accommodate floating headerā€¦
  • Fix highlight of own user on the leaderboard not working if own user position is > 100
  • Add i18n thousands separator to user card / profile cheer score
  • Add time period filters to leaderboards
  • Add default time period filter to leaderboard settings
  • Add excluded_groups_ids to leaderboard settings
  • Allow admins to award/remove arbitrary points to users to allow integration with out-of-Discourse scorable events
  • Make scores click link to leaderboard (both in user profile and user card)

:discourse2: Hosted by us? This plugin is available on our Business and Enterprise plans Gamification | Discourse - Civilized Discussion

Last edited by @JammyDodger 2024-07-04T11:44:13Z

Check documentPerform check on document:
103 Likes

A post was split to a new topic: Choose leaderboard linked in profile

A post was split to a new topic: Subtract points based on certain reactions

2 posts were split to a new topic: Creating a Top 20 leaderboard for a specific date range

Just a note to say the gamification scoring for posts_created has been adjusted to account for a few extra things:

6 Likes

This is great. A feature suggestion is to allow different scorable settings for each board so every board could be used for a separate community-driven competition.

For example, a board for most posts this month would have the post created score value set to 1 while all others are 0. Where a best like of the month board would have like given score value set to 1 and all others set to 0.

1 Like

Like this /u?order=likes_given&period=monthly?

Yes, that is a similar idea but as part of the Gamification board, not the default user listing layout.

The discourse user list (/u) can be displayed in different ways, such as the user card directory theme component which is good for the global site user list but does not look as good for a user ranking page. So the suggestion to have each gamification board use a separate setting is valid and makes more sense than using the discourse user list in this situation.

1 Like

A post was split to a new topic: Gamefication scoring for portugese forum?

How do I remove this leaderboard link from my sidebar? It seems to be automatically added, since it isnā€™t in the custom section links settings where Iā€™d like it to be in order to move it to the More menu.

I see Meta has figured this out, but I donā€™t see a configurable setting anywhere on my end.