Badges & leaderboard
Badges
Section titled “Badges”Badges are awards displayed on user profiles. They can be awarded automatically when a user meets a threshold, or manually by an admin.
Badges are managed at Admin → Badges.
Badge fields
Section titled “Badge fields”| Field | Description |
|---|---|
| Name | The badge’s display name |
| Description | Shown on the badge card — what it’s awarded for |
| Icon | A Font Awesome solid icon class, e.g. fa-medal, fa-star |
| Color | Hex color for the badge icon and accent |
| Rarity | common, rare, epic, or legendary — cosmetic only, affects visual styling |
| Award type | auto (awarded automatically) or manual (admin awards only) |
Auto badges
Section titled “Auto badges”When Award type is auto, two additional fields appear:
- Trigger type — the activity metric that qualifies the user
- Trigger threshold — the value the metric must reach for the badge to be awarded
Available trigger types:
| Trigger | Metric |
|---|---|
| Posts created | Total posts by the user |
| Replies posted | Total replies by the user |
| Reactions received | Total reactions received on their content |
| Reactions given | Total reactions they have given |
| Consecutive login days | Current login streak |
| Account age (days) | Days since account creation |
| Distinct spaces posted in | Number of different spaces they’ve posted in |
Auto badges are awarded automatically when the trigger threshold is crossed. The badge is awarded once per user — it cannot be awarded multiple times for the same badge.
Manual badges
Section titled “Manual badges”When Award type is manual, the badge is never awarded automatically. From the badge list, click Award to grant it to a specific user by username.
Revoking badges
Section titled “Revoking badges”From the badge management panel, expand a badge to see its holders. Click the revoke button next to any user to remove the badge from them.
Deleting badges
Section titled “Deleting badges”Deleting a badge removes it from all users who currently hold it. This cannot be undone.
Leaderboard
Section titled “Leaderboard”The leaderboard ranks members by points earned through forum activity. Settings are at Admin → Leaderboard.
Enabling or disabling
Section titled “Enabling or disabling”The leaderboard can be toggled on or off. When disabled, the leaderboard page and rank stats are hidden from all members.
Exclude admins & moderators
Section titled “Exclude admins & moderators”When enabled, admins and moderators are removed from the public rankings so members compete on equal footing. Staff scores are still tracked — only their visibility on the leaderboard is affected.
Points currency name
Section titled “Points currency name”The label shown next to point totals throughout the forum. Default: points. Can be changed to anything — kudos, karma, stars, etc.
Points per action
Section titled “Points per action”Each action earns a configurable number of points:
| Action | Default |
|---|---|
| Post created | 1 |
| Reply posted | 1 |
| Reaction given | 1 |
| Reaction received | 1 |
| Daily login | 1 |
| Badge earned | 5 |
| Post pinned | 3 |
| Mention received | 1 |
Set any value to 0 to award no points for that action.
Login streak multiplier
Section titled “Login streak multiplier”Daily login points are multiplied by a streak bonus based on consecutive login days:
multiplier = 1 + (streak_days × streak_multiplier)The result is capped at the maximum multiplier value.
Defaults:
- Streak multiplier per day:
0.1(10% bonus per consecutive day) - Maximum multiplier:
3.0(up to 3× base login points)
For example, at defaults: a 7-day streak gives 1 + (7 × 0.1) = 1.7×, a 20-day streak gives 1 + (20 × 0.1) = 3.0× (capped).
Recalculate all scores
Section titled “Recalculate all scores”The Recalculate all scores button recomputes the entire leaderboard from scratch based on current point values. Use this after changing point values to bring existing scores in line with the new configuration.