A comprehensive community awards and voting extension for Flarum forums. Create annual awards, organize categories with nominees, let your community vote, and publish results with beautiful winner badges.
Credits: This extension sponsored by @StryGuardian ✨
- 🏆 Award Ceremonies: Create annual or event-based awards (e.g., "Game Awards 2025", "Community Choice")
- 📂 Categories & Nominees: Organize awards into categories with images and descriptions
- 🗳️ Flexible Voting: Single vote (replace), multiple votes per category, or unlimited voting
- 💡 User Suggestions: Let users suggest nominees with admin approval workflow
- 📊 Live Vote Counts: Optionally show real-time vote counts during voting period
- 🔔 Notifications: Automatic alerts when results are published to all voters
- 🥇 Winner Badges: Gold, silver, and bronze badges for top 3 nominees
- 🖼️ Hero Section: Beautiful cover images with countdown timer
- 📱 Responsive Design: Card-based layout optimized for all devices
- 🎯 Prediction Summary: Track your prediction accuracy after results are published
- ⏰ Auto-End Voting: Automatic status updates based on start/end dates
- 🔧 Vote Adjustment: Admin can adjust displayed vote counts when needed
composer require huseyinfiliz/awardsYou can also install with Extension Manager: huseyinfiliz/awards
composer update huseyinfiliz/awardsTo remove simply run composer remove huseyinfiliz/awards
- Navigate to the Awards page from the sidebar
- Browse categories and click on a nominee card to vote
- Visit My Votes tab to track your voting progress
- Use Suggest Other option where the category allows it
- View Results after voting ends to see winners and your prediction score
Navigate to Admin → Awards to configure the system. The admin panel is divided into tabs for easy management:
- Create awards with Name, Year, and Voting Period
- Set cover images for the hero section (URL or upload via FoF Upload)
- Control award status: Draft → Active → Ended → Published
- Toggle Show Live Votes for real-time vote counts during voting
- Publish Results to notify all voters when ready
- Add categories to awards (e.g., "Best RPG", "Game of the Year")
- Enable Allow User Suggestions for community input
- Reorder categories with drag controls
- Set descriptions to guide voters
- Add nominees with Name, Description, and Image
- Supports image upload (requires FoF Upload) or external URLs
- Vote Adjustment: Manually adjust displayed vote counts (+/-)
- Reorder nominees within categories
- Review pending user suggestions
- Approve: Create as new nominee (user automatically votes for it)
- Reject: Decline the suggestion
- Merge: Combine with existing nominee (user's vote transfers)
- Navigation Title: Customize sidebar text
- Navigation Icon: Set FontAwesome icon class
- Votes Per Category:
0= unlimited,1= single vote (replace),N= max N votes
- Annual Game Awards (GOTY, Best Indie, Best Soundtrack)
- Community Choice awards for favorite content creators
- Seasonal tournament MVP voting
- Best TV Series / Movie of the year
- Music awards (Best Album, Best Artist)
- Book of the month/year voting
- Member of the Year awards
- Best Thread / Best Post awards
- Contributor recognition programs
Draft → Active → Ended → Published
| Status | Description |
|---|---|
| Draft | Setting up the award (only visible to admins for preview) |
| Active | Voting is open between start and end dates |
| Ended | Voting closed, admin reviews before publishing |
| Published | Results visible to everyone, all voters notified |
| Mode | Setting | Behavior |
|---|---|---|
| Single Vote | 1 |
One vote per category, voting again replaces previous vote |
| Multi-Vote | 2-99 |
Up to N votes per category, cannot change after voting |
| Unlimited | 0 |
No limit on votes per category |
Note: Pending suggestions count toward the vote quota in limited modes.
After results are published, users can see their prediction accuracy:
- Correct: Your vote matched the winner
- Wrong: Your vote didn't match the winner
- Score:
Correct / Total Votedcategories
| Permission | Description |
|---|---|
| View Awards | Access the awards page |
| Vote in Awards | Cast votes for nominees |
| View Results Early | See results before publishing (for moderators) |
| Manage Awards | Full admin access to create/edit/delete |
- Auto Status: Active awards with passed end dates show as "ended" automatically
- Rate Limiting: 10 votes per minute to prevent abuse
- Unique Slugs: Award slugs include year for uniqueness (e.g.,
game-awards-2025) - Vote Replacement: In single-vote mode, previous vote is automatically removed
This extension comes with English translations. Community translations are welcome!
If you find this extension useful, consider:
- ⭐ Starring the repository on GitHub
- 💬 Leaving feedback on the Flarum discussion
- 🐛 Reporting issues on GitHub
- 🌐 Contributing translations
MIT License - see LICENSE.md
Developed with ❤️ by Hüseyin Filiz