🏆 Awards

huseyinfiliz

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 @KBExit @Wlork ✨

🗳️ Voting Interface

Voting Demo

🥇 Results & Winners

Results Demo

✅ My Votes Dashboard

My Votes Demo

⚙️ Admin Management

Admin Demo

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
🛡️ Admin Panel: Complete management system for Awards, Categories, Nominees, and Suggestions

Demo

Try it: https://flarum1.huseyinfiliz.com/awards

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

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

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
Publish Results to notify all voters

Categories Tab

Add categories to awards (e.g., "Best RPG", "Game of the Year")
Enable Allow User Suggestions for community input
Reorder categories with sort controls

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 when needed

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

Settings Tab

Navigation Title: Customize sidebar text
Navigation Icon: Set FontAwesome icon class
Votes Per Category: 0 = unlimited, 1 = single vote, 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

Draft: Setting up (only visible to admins)
Active: Voting is open between start and end dates
Ended: Voting closed, admin reviews before publishing
Published: Results visible, all voters notified

Voting Modes

Single Vote (1): One vote per category, replaces previous
Multi-Vote (2-99): Up to N votes per category
Unlimited (0): No limit on votes

Permissions

You can configure permissions via the Flarum Permission grid:

Manage Awards: Full access to admin panel (create/edit/delete)
Vote in Awards: Allows users to cast votes
View Awards: Controls visibility of the extension page
View Results Early: See results before publishing (for moderators)

Automated Logic

Rate Limiting: 10 votes per minute to prevent abuse
Quota System: Pending suggestions count toward vote limits
Notifications: All voters receive alerts when results are published
Auto Status: Active awards with passed end dates show as "ended"

🔗 Links

🌍 Translations

Turkish language support has been added. Please contribute by translating it into your local language!
https://weblate.rob006.net/projects/flarum/huseyinfiliz-awards/

💖 Support & Contributing

If you find this extension useful, consider:

⭐ Starring the repository on GitHub
💬 Leaving feedback

vimo

Thank you for this amazing extension. I will use it for a fan community from a pro soccer team!

vimo

Picture problem:

When i upload a image, the file doens't show up (broken image). i also can't find the directory on my server.
When i use a link for photo/image it doens's show up (broken image).

What are the best specifications for images? (size, ..)

huseyinfiliz

vimo It integrates with the fof/upload extension. If the upload functionality works within discussions but not in Awards, I can look into the issue. Please ensure that the upload extension is functioning correctly first.

vimo

huseyinfiliz Yes, i have no problems with fof/upload. I can upload images

This is the file name when i use the upload in the award extension: websiteurl/upload/assets/files/2026-01-19/filename.jpg

But i can't find the assets folder in upload directory

huseyinfiliz

vimo I installed fof/upload on flarum1.huseyinfiliz.com and didn't change any settings. I successfully uploaded photos for both awards and nominees within the Awards extension, and the URL was generated as: https://flarum1.huseyinfiliz.com/assets/files/2026-01-19/1768821374-461144-awards.jpg

Have you made any changes to your upload extension settings, and which adapter are you using (local, Imgur, etc.)?

vimo

huseyinfiliz II have no special changes in the upload extension. Files goes on my server in the upload folder

huseyinfiliz

vimo When you upload a photo, upload/assets/files/ is added to your file path, but on my end, it appears as assets/files/

I did some testing and found that when I entered https://flarum1.huseyinfiliz.com into the Local storage settings of the FoF Upload extension (without a trailing slash), the URL was generated without the extra upload directory. I suspect the issue stems from this upload prefix being added to the URL.

Could you try entering your site’s URL in that setting without the / at the end and see if the 'upload' directory still appears in the link?

As I mentioned, the photo upload feature is not part of my extension. Everything, including the upload button, belongs to the FoF Upload extension. I have no control over its logic. I believe this issue can only be resolved through the FoF Upload settings.

vimo

I tested without the / and upload folder still appears.
It's probably a upload directory problem and not your extension, sorry about that.
Now i have to find out where my uploads are, because it's not in the upload folder.

huseyinfiliz

vimo Does it fix the issue if you delete 'upload/' from the text box on the left after uploading the file? You can try this as a temporary workaround.

vimo

huseyinfiliz I found a stupid fault from my side. A little mistake in my URL settings.
Working good now!

stryguardian

huseyinfiliz Fantastic work!

Capybara

As always, great cover and great work! I don’t currently have a 1.x forum at hand, and when translating I’m used to working with extensions in action to better understand how to translate different entities. I’ll be setting up a test forum on 1.x soon and will translate this extension and Pick'em 👀

huseyinfiliz

vimo It happens sometimes, haha! I’m glad the issue is resolved.

stryguardian Thank you, it’s all thanks to you guys! I really appreciate your donation.

@KBExit I just saw your donation and have added you as well. @Wlork since you pledged to donate, I’m adding you too. Thank you!

Capybara I’ve granted admin permissions to your account at flarum.huseyinfiliz.com/u/Capybara. Please use the extension manager to install Russian and continue your testing! Thank you.

🌍 Translations

Turkish language support has been added. Please contribute by translating it into your local language!
https://weblate.rob006.net/projects/flarum/huseyinfiliz-awards/

stryguardian

@huseyinfiliz I'm unable to send a private message to you here, so I sent one on your test site.

KBExit

stryguardian have you tried "Private Discussion?"
Private Message in the user profile seems broken at the moment.

huseyinfiliz

stryguardian I replied, thank you.

stryguardian

When setting a start date and time for the awards voting, will it automatically move the awards to Active or do I need to do that manually?

huseyinfiliz

stryguardian Once the award is activated, it remains visible to users until the start date, but voting is disabled. This is similar to a draft state but visible to members. After the end date, it behaves as 'ended' for members; they can no longer vote or view results (unless live voting is enabled).

If the status is set to 'Draft,' it will not automatically activate when the start date arrives. Instead, you must set a start date and manually switch the status to 'Active.' This allows administrators to make experimental adjustments freely while in the draft stage. Furthermore, managing scheduled tasks is challenging in Flarum 1.x, whereas it is much more streamlined in 2.x.

stryguardian

I've noticed that if I set a start time and end time and save, once I click edit again on the awards, it is showing 6 hours later. Is this a timezone issue?