discourse/plugins/discourse-topic-voting
Régis Hanol 5cef23ef63
FEATURE: award badges based on topic votes received (#39493)
Adds four tiered badges to discourse-topic-voting so topic authors are
recognized when their ideas get traction:

- Daydreamer (Bronze, 1 vote)
- Brainstormer (Silver, 5 votes)
- Innovator (Silver, 15 votes)
- Visionary (Gold, 25 votes)

Badges are multi-grant and tied to the qualifying topic's first post, so
a user earns each tier once per topic that reaches the threshold.
Self-votes (voting on your own topic) are excluded. All badges are
disabled by default; the Silver and Gold tiers (Brainstormer, Innovator,
Visionary) allow the badge to be used as a title when enabled.

<img width="287" height="216" alt="image"
src="https://github.com/user-attachments/assets/3a84c2b2-6157-4504-b5a5-45e7c660e90c"
/>


### How it is wired

- `Votes::Cast` enqueues a `BackfillBadges` job after a vote is cast.
- `TopicMerger.merge` and `VoteReclaim` also enqueue the job so merged
or reclaimed topics are re-evaluated immediately rather than having to
wait for the daily consistency pass.
- The job calls `BadgeGranter.backfill` scoped to the topic's first
post. Queries join `badge_posts`, which already filters out deleted and
unlisted topics, read-restricted categories, and categories with
`allow_badges` disabled.
- Each query returns `granted_at` as the timestamp of the Nth qualifying
vote (via `ROW_NUMBER()`), so every tier reflects when that threshold
was actually crossed rather than when the most recent vote landed.
- Revocation (vote removed, topic deleted, category changed) runs on the
daily full backfill via `auto_revoke`, consistent with how
discourse-solved handles the same pattern.

### Notification handling

To avoid "granted badge" notification avalanches when the feature is
first enabled on a community with years of existing votes, core now
exposes a `:badge_granter_suppress_notification` modifier. The plugin
registers it and suppresses notifications for its four badges when the
qualifying vote is older than 2 weeks. Combined with the per-tier
`granted_at`, this means only the tier the author just crossed produces
a notification; lower tiers whose threshold was reached long ago stay
silent.

Ref - t/182304
2026-04-28 10:53:06 +10:00
..
app FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
assets DEV: Improve vote queries (#39394) 2026-04-21 16:10:28 +10:00
config FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
db FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
lib/discourse_topic_voting FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
spec FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
svg-icons FEATURE: restyle topic voting component, add voting to docked header (#39234) 2026-04-14 12:50:52 -04:00
test/javascripts/acceptance FIX: Remove topic voting custom field from category logs when there is no change (#36832) 2025-12-22 21:29:32 +08:00
package.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00
plugin.rb FEATURE: award badges based on topic votes received (#39493) 2026-04-28 10:53:06 +10:00
README.md
tsconfig.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00

Discourse Topic Voting

Adds the ability for voting on a topic within a specified category.

Topic discussing the plugin itself can be found here: https://meta.discourse.org/t/discourse-voting/40121