A points-based leaderboard extension for Flarum forums. Award points for community activity, display rankings with a beautiful podium, and motivate engagement through configurable point sources and time-based filters.
Screenshots
Podium & Rankings
Top Contenders & Honorable Mentions
Admin General Settings
Admin Points Settings
Admin Exclusions Settings
Admin Maintenance Settings
Admin Recalculate Modal
Features
🏆 Podium Display — Top 3 users shown in a gold/silver/bronze podium with avatars and stats
🔥 Top Contenders — Ranks #4–#10 displayed in a responsive card grid
📋 Honorable Mentions — Compact two-column list for remaining users with infinite scroll
⏰ Period Filters — Daily, Weekly, Monthly, Quarterly, Yearly, and All-time rankings
⭐ Configurable Points — Set point values for each activity type independently
🎯 11 Point Sources — Discussions, posts, daily login, likes (given/received), reactions (given/received), best answers, badges, and votes
🏷️ Tag Exclusions — Exclude discussions with specific tags from earning points
👥 Group Exclusions — Hide users in selected groups from the leaderboard
🔄 Maintenance Tools — Full recalculation and lightweight sync for point adjustments
🦴 Skeleton Loading — Smooth loading experience with animated placeholders
📱 Responsive Design — Optimized layout for mobile, tablet, and desktop
🃏 User Card Integration — Show leaderboard points on user cards throughout the forum
Installation
composer require huseyinfiliz/leaderboard:"*"
You can also install it via Extension Manager: search for huseyinfiliz/leaderboard.
After installing, run:
php flarum migrate
php flarum cache:clear
Updating
composer update huseyinfiliz/leaderboard
php flarum migrate
php flarum cache:clear
To remove the extension:
composer remove huseyinfiliz/leaderboard
Quick Start
For Users
- Navigate to the Leaderboard page from the sidebar
- Use the period pills to filter rankings (Daily, Weekly, Monthly, etc.)
- Click on any user card to visit their profile
- Your points are visible on your user card across the forum
For Admins
Navigate to Admin → Leaderboard to configure the extension. The panel has four tabs:
General — Set the leaderboard page title and the label shown next to point values (e.g., "Points", "XP", "Karma")
Points — Configure point values per activity, organized in collapsible sections:
- Core: Discussion started, Post created, Daily login (default: 1 each)
- Likes: Like received (1), Like given (0)
- Reactions: Reaction received (1), Reaction given (0)
- Best Answer: Best answer selected (2)
- Badges: Badge earned (3)
- Gamification: Upvote received (1), Downvote received (−1)
Set any value to 0 to disable that source. Negative values (e.g., downvotes) deduct points.
Exclusions — Select user groups or discussion tags to exclude from point earning
Maintenance — Two tools available:
- Recalculate All Activity — Full rescan of all source data. Re-creates point records from scratch. Use after changing tag exclusions or if data seems out of sync. Do not close the page while this runs.
- Sync Points — Lightweight recalculation of totals using current point values. Use after changing point values.
Optional Integrations
The extension automatically integrates with these extensions when they are enabled — no configuration needed:
Advanced: Point Lifecycle
Points are awarded and revoked automatically based on user activity:
Action performed → Points awarded → Totals updated
Action undone → Points revoked → Totals updated
Some examples:
- Starting a discussion awards
discussion_started points; hiding or deleting it revokes them
- A daily login awards
daily_login once per day
- Receiving a like awards
like_received; unliking or hiding the post revokes it
- A best answer selection awards
best_answer; unsetting it revokes it
Data integrity highlights:
- Atomic operations with row locking prevent partial updates
- Discussion deletion properly cascades and revokes all post-level points
- Hidden/moderated content has points revoked; restored content re-awards them
- Duplicate point records are prevented with existence checks
- Database fallback prevents double-awarding daily login points after cache clears
Advanced: Period Filtering
Rankings are filtered by the created_at timestamp of each point record:
- Daily — Last 24 hours
- Weekly — Last 7 days
- Monthly — Last 30 days
- Quarterly — Last 90 days
- Yearly — Last 365 days
- All Time — No filter
Translations
The extension ships with English translations. Community translations are very welcome!
Translate: Leaderboard at Weblate
Links
Support & Contributing
If you find this extension useful:
- ⭐ Star the repository on GitHub
- 🌐 Contribute translations
