Awards

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 ✨

🗳️ Voting Interface

📊 Results & Winners

✅ My Votes Dashboard

⚙️ Admin Management

Features

• 🏆 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

Installation

composer require huseyinfiliz/awards

You can also install with Extension Manager: huseyinfiliz/awards

Updating

composer update huseyinfiliz/awards

To remove simply run composer remove huseyinfiliz/awards

Quick Start

For Users

1. Navigate to the Awards page from the sidebar
2. Browse categories and click on a nominee card to vote
3. Visit My Votes tab to track your voting progress
4. Use Suggest Other option where the category allows it
5. View Results after voting ends to see winners and your prediction score

For Admins

Navigate to Admin → Awards to configure the system. The admin panel is divided into tabs for easy management:

Awards Tab

• 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

Categories Tab

• 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

Nominees Tab

• 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

Suggestions Tab

• 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)

Settings Tab

• Navigation Title: Customize sidebar text
• Navigation Icon: Set FontAwesome icon class
• Votes Per Category: 0 = unlimited, 1 = single vote (replace), N = max N votes

🎯 Use Cases

Gaming Communities

• Annual Game Awards (GOTY, Best Indie, Best Soundtrack)
• Community Choice awards for favorite content creators
• Seasonal tournament MVP voting

Entertainment Forums

• Best TV Series / Movie of the year
• Music awards (Best Album, Best Artist)
• Book of the month/year voting

Community Recognition

• Member of the Year awards
• Best Thread / Best Post awards
• Contributor recognition programs

🔧 Advanced Details

Award Status Flow

Draft → Active → Ended → Published

Voting Modes

Note: Pending suggestions count toward the vote quota in limited modes.

Scoring System (Prediction Summary)

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 Voted categories

Permissions

Automated Features

• 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

🌍 Translations

This extension comes with English translations. Community translations are welcome!

💖 Support & Contributing

If you find this extension useful, consider:

• ⭐ Starring the repository on GitHub
• 💬 Leaving feedback on the Flarum discussion
• 🐛 Reporting issues on GitHub
• 🌐 Contributing translations

License

MIT License - see LICENSE.md

Developed with ❤️ by Hüseyin Filiz