PHPackages                             huseyinfiliz/awards - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. huseyinfiliz/awards

ActiveFlarum-extension[Utility &amp; Helpers](/categories/utility)

huseyinfiliz/awards
===================

Community awards and voting extension for Flarum

1.1(5mo ago)0651—3.6%[1 issues](https://github.com/huseyinfiliz/awards/issues)MITTypeScriptCI passing

Since Jan 19Pushed 3mo agoCompare

[ Source](https://github.com/huseyinfiliz/awards)[ Packagist](https://packagist.org/packages/huseyinfiliz/awards)[ Docs](https://github.com/huseyinfiliz/awards)[ Fund](https://github.com/huseyinfiliz)[ RSS](/packages/huseyinfiliz-awards/feed)WikiDiscussions 2.x Synced yesterday

READMEChangelog (4)Dependencies (5)Versions (9)Used By (0)

[![](https://camo.githubusercontent.com/77b8693cf6a9e3af7a61f72ed6f2ce7b7115821152963340b8fd76b4ae33ba57/68747470733a2f2f692e6962622e636f2f39336e6d567173442f6177617264732e6a7067)](https://camo.githubusercontent.com/77b8693cf6a9e3af7a61f72ed6f2ce7b7115821152963340b8fd76b4ae33ba57/68747470733a2f2f692e6962622e636f2f39336e6d567173442f6177617264732e6a7067)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/f1bf9c0094dc97df884eb21359926a309e681855c496bceedbec81593178b109/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6875736579696e66696c697a2f6177617264732e737667)](https://packagist.org/packages/huseyinfiliz/awards) [![Total Downloads](https://camo.githubusercontent.com/2f64ee729b5bcb7fbc2adb454c8d15553a308e31a73a3a33d96fef07a8f8fda0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6875736579696e66696c697a2f6177617264732e737667)](https://packagist.org/packages/huseyinfiliz/awards)

Awards
======

[](#awards)

A comprehensive community awards and voting extension for [Flarum](https://flarum.org) 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](https://discuss.flarum.org/u/stryguardian)

### Voting Interface

[](#voting-interface)

[![Voting Demo](https://camo.githubusercontent.com/024fa357d861c9372bd8a41cc26853e6ebfaf2fe84f63f6d4a81274bf69b6a8e/68747470733a2f2f692e6962622e636f2f3166364e68707a6d2f696d6167652e706e67)](https://camo.githubusercontent.com/024fa357d861c9372bd8a41cc26853e6ebfaf2fe84f63f6d4a81274bf69b6a8e/68747470733a2f2f692e6962622e636f2f3166364e68707a6d2f696d6167652e706e67)

### Results &amp; Winners

[](#results--winners)

[![Results Demo](https://camo.githubusercontent.com/6efbf569f9058fc9ef5dbd83f6b447980887e0a614e04250081b5450296d7482/68747470733a2f2f692e6962622e636f2f53347a384a6d4c512f696d6167652e706e67)](https://camo.githubusercontent.com/6efbf569f9058fc9ef5dbd83f6b447980887e0a614e04250081b5450296d7482/68747470733a2f2f692e6962622e636f2f53347a384a6d4c512f696d6167652e706e67)

### My Votes Dashboard

[](#my-votes-dashboard)

[![My Votes Demo](https://camo.githubusercontent.com/ce1fa165070cbf147a710c168fd3f7a16fe89b83c89571fe9897658f8c55ed71/68747470733a2f2f692e6962622e636f2f7247724c484a4a672f696d6167652e706e67)](https://camo.githubusercontent.com/ce1fa165070cbf147a710c168fd3f7a16fe89b83c89571fe9897658f8c55ed71/68747470733a2f2f692e6962622e636f2f7247724c484a4a672f696d6167652e706e67)

### Admin Management

[](#admin-management)

[![Admin Demo](https://camo.githubusercontent.com/c938f1d2771ae3f8b8cebe3854a74828979998403960a9511d69edb3eaa79636/68747470733a2f2f692e6962622e636f2f48707434313133472f696d6167652e706e67)](https://camo.githubusercontent.com/c938f1d2771ae3f8b8cebe3854a74828979998403960a9511d69edb3eaa79636/68747470733a2f2f692e6962622e636f2f48707434313133472f696d6167652e706e67)

Features
--------

[](#features)

- **Award Ceremonies**: Create annual or event-based awards (e.g., "Game Awards 2025", "Community Choice")
- **Categories &amp; 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

Compatibility
-------------

[](#compatibility)

Extension VersionFlarum Version^2.0.0^2.0.0^1.0.0^1.8.0Installation
------------

[](#installation)

```
composer require huseyinfiliz/awards:"*"
```

You can also install with Extension Manager: `huseyinfiliz/awards`

Updating
--------

[](#updating)

```
composer update huseyinfiliz/awards
php flarum migrate
php flarum cache:clear
```

Quick Start
-----------

[](#quick-start)

### For Users

[](#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

[](#for-admins)

Navigate to **Admin &gt; Awards** to configure the system. The admin panel is divided into tabs for easy management:

#### Awards Tab

[](#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 &gt; Active &gt; Ended &gt; Published
- Toggle **Show Live Votes** for real-time vote counts during voting
- **Publish Results** to notify all voters when ready

#### Categories Tab

[](#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

[](#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

[](#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

[](#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

Award Status Flow
-----------------

[](#award-status-flow)

```
Draft > Active > Ended > Published

```

StatusDescription**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 notifiedVoting Modes
------------

[](#voting-modes)

ModeSettingBehavior**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.

Permissions
-----------

[](#permissions)

PermissionDescription**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/deleteTranslations
------------

[](#translations)

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

Support &amp; Contributing
--------------------------

[](#support--contributing)

- Leaving feedback on the [Flarum discussion](https://discuss.flarum.org/d/38654-awards-community-voting-extension)
- Reporting issues on [GitHub](https://github.com/huseyinfiliz/awards/issues)
- Contributing translations

License
-------

[](#license)

MIT License - see [LICENSE.md](LICENSE.md)

---

Developed by [Huseyin Filiz](https://github.com/huseyinfiliz)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance76

Regular maintenance activity

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Total

6

Last Release

112d ago

Major Versions

1.x-dev → 2.0.0-beta.12026-03-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/09c355d62c7dcfc040309947946c06155947883a72b6b0c7a354c7d93453fad1?d=identicon)[huseyinfiliz](/maintainers/huseyinfiliz)

---

Top Contributors

[![huseyinfiliz](https://avatars.githubusercontent.com/u/37220000?v=4)](https://github.com/huseyinfiliz "huseyinfiliz (19 commits)")

---

Tags

communityvotingflarumawardspolls

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/huseyinfiliz-awards/health.svg)

```
[![Health](https://phpackages.com/badges/huseyinfiliz-awards/health.svg)](https://phpackages.com/packages/huseyinfiliz-awards)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in &amp; sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/gamification

Upvotes and downvotes for your Flarum community

4066.1k8](/packages/fof-gamification)[fof/best-answer

Mark a post as the best answer in a discussion

25154.0k20](/packages/fof-best-answer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
