PHPackages                             huseyinfiliz/pickem - 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/pickem

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

huseyinfiliz/pickem
===================

Pick'em game extension for Flarum

1.5(7mo ago)34331MITTypeScript

Since Nov 20Pushed 7mo agoCompare

[ Source](https://github.com/huseyinfiliz/pickem)[ Packagist](https://packagist.org/packages/huseyinfiliz/pickem)[ Docs](https://github.com/huseyinfiliz/pickem)[ Fund](https://github.com/huseyinfiliz)[ RSS](/packages/huseyinfiliz-pickem/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

[![](https://camo.githubusercontent.com/0d9105f78a7560a9922140d819467a025c82f2696ac19ddda6c1759989b911eb/68747470733a2f2f692e6962622e636f2f35585972344c78372f7069636b656d2e676966)](https://camo.githubusercontent.com/0d9105f78a7560a9922140d819467a025c82f2696ac19ddda6c1759989b911eb/68747470733a2f2f692e6962622e636f2f35585972344c78372f7069636b656d2e676966)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/a068657e7112d695e7b6f29b8e7749e478b7a389c96dac3498c1f7bfa5b31699/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6875736579696e66696c697a2f7069636b656d2e737667)](https://packagist.org/packages/huseyinfiliz/pickem) [![Total Downloads](https://camo.githubusercontent.com/078e9ec48c77d10ab84fb1161b9e7f113b3b0780366b84ef1e402c4f964b42fe/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6875736579696e66696c697a2f7069636b656d2e737667)](https://packagist.org/packages/huseyinfiliz/pickem)

Pick'em
=======

[](#pickem)

A comprehensive sports prediction game extension for [Flarum](https://flarum.org) forums. Engage your community by allowing users to predict match outcomes, compete on a global leaderboard, and track their statistics.

**Credits:** This extension sponsored by [@ernestdefoe ](https://discuss.flarum.org/u/ernestdefoe)&amp; [@KBExit ](https://discuss.flarum.org/u/KBExit)✨

### ⚽ Matches &amp; Predictions

[](#-matches--predictions)

[![Matches Demo](https://camo.githubusercontent.com/5b9e990bf80ae8c967114af535ebae546b9931796538720d55897c271cee42a7/68747470733a2f2f692e6962622e636f2f466b714b54397a4a2f696d6167652e706e67)](https://camo.githubusercontent.com/5b9e990bf80ae8c967114af535ebae546b9931796538720d55897c271cee42a7/68747470733a2f2f692e6962622e636f2f466b714b54397a4a2f696d6167652e706e67)

### 🏆 Leaderboard System

[](#-leaderboard-system)

[![Leaderboard Demo](https://camo.githubusercontent.com/e7c7007bf16c53db05acb8cc4ea3719ee2c9c7c3d1947724826e1ad0cd720cf5/68747470733a2f2f692e6962622e636f2f575770574b4770762f696d6167652e706e67)](https://camo.githubusercontent.com/e7c7007bf16c53db05acb8cc4ea3719ee2c9c7c3d1947724826e1ad0cd720cf5/68747470733a2f2f692e6962622e636f2f575770574b4770762f696d6167652e706e67)

### 📝 My Picks Dashboard

[](#-my-picks-dashboard)

[![My Picks Demo](https://camo.githubusercontent.com/dc2598eac2b54d7e777e3c98590528b7757d652afa9c02c8a58a66cdc7b1e4fa/68747470733a2f2f692e6962622e636f2f714d47506b336b432f696d6167652e706e67)](https://camo.githubusercontent.com/dc2598eac2b54d7e777e3c98590528b7757d652afa9c02c8a58a66cdc7b1e4fa/68747470733a2f2f692e6962622e636f2f714d47506b336b432f696d6167652e706e67)

### ⚙️ Admin Management

[](#️-admin-management)

[![Admin Demo](https://camo.githubusercontent.com/e09c0253eb05b905a2ebf60c54fa0bd187e3bd4f52de0ca2a6ee1008065f03f9/68747470733a2f2f692e6962622e636f2f317766366d62342f696d6167652e706e67)](https://camo.githubusercontent.com/e09c0253eb05b905a2ebf60c54fa0bd187e3bd4f52de0ca2a6ee1008065f03f9/68747470733a2f2f692e6962622e636f2f317766366d62342f696d6167652e706e67)

Features
--------

[](#features)

- 🎯 **Match Predictions**: Users can predict Home Win, Away Win, or Draw results
- 🏆 **Leaderboard**: Automatic global ranking system based on correct predictions
- 📊 **User Statistics**: Track accuracy rates, total points, and correct pick counts
- ⚡ **Live Status**: Real-time match status (Scheduled, Closed, Finished)
- ⏰ **Cutoff Control**: Automatic locking of picks when the match start time is reached
- 📱 **Responsive Design**: Fully optimized card-based layout for mobile devices
- 🔔 **Notifications**: Users receive alerts when match results are announced
- 🛡️ **Admin Panel**: Complete management system for Teams, Seasons, Weeks, and Events
- 🖼️ **Team Logos**: Visual team identity with logo support (URL or Upload)

### Installation

[](#installation)

```
composer require huseyinfiliz/pickem
```

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

### Updating

[](#updating)

```
composer update huseyinfiliz/pickem
```

To remove simply run `composer remove huseyinfiliz/pickem`

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

[](#quick-start)

### For Users

[](#for-users)

1. Navigate to the **Pick'em** page from the sidebar
2. Browse the **Matches** tab to see upcoming events
3. Click on **Home**, **Draw**, or **Away** buttons to make your prediction
4. Visit **My Picks** to track your history and **Leaderboard** to see your ranking

### For Admins

[](#for-admins)

Navigate to **Admin → Pick'em** to configure the system. The admin panel is divided into tabs for easy management:

#### Teams Tab

[](#teams-tab)

- Create teams with **Name**, **Slug**, and **Logo**
- Supports direct image upload (requires FoF Upload) or external image URLs

#### Seasons Tab

[](#seasons-tab)

- Create seasons (e.g., "2024-2025 Season")
- Define start and end dates for organizational purposes

#### Weeks Tab

[](#weeks-tab)

- Group matches into weeks (e.g., "Week 1", "Playoffs")
- Link weeks to specific seasons

#### Matches Tab

[](#matches-tab)

- Create matches by selecting Home and Away teams
- **Match Date**: When the game actually starts
- **Cutoff Date**: The deadline for users to make picks (usually match start time)
- **Allow Draw**: Toggle whether a "Draw" option is available for prediction
- **Status**: Manually manage statuses (Scheduled, Closed, Finished)
- **Enter Results**: Input scores after the match to automatically calculate points

#### Settings Tab

[](#settings-tab)

- **Recalculate Scores**: A utility tool to recalculate all user scores and rankings from scratch if needed

### 🎯 Use Cases

[](#-use-cases)

#### Sports Communities

[](#sports-communities)

- Football/Soccer leagues (Premier League, La Liga, etc.)
- Basketball tournaments (NBA, EuroLeague)
- Weekly NFL pick'em pools

#### E-Sports Forums

[](#e-sports-forums)

- Tournament prediction brackets for games like LoL, CS:GO, or Valorant
- Team performance tracking

### TV &amp; Events

[](#tv--events)

- Reality show elimination predictions
- Award show winners (Oscars, Grammys) pools

### 🔧 Advanced Details

[](#-advanced-details)

#### Scoring System

[](#scoring-system)

- **Points**: Users earn **1 point** for every correct prediction.
- **Accuracy**: Calculated as `(Correct Picks / Total Picks) * 100`.
- **Ranking**: The leaderboard is sorted by Total Points (primary) and Correct Pick count (secondary).

#### Permissions

[](#permissions)

You can configure permissions via the Flarum Permission grid:

- **Manage pick'em system**: Allows full access to the admin panel (create/edit/delete data).
- **Make picks**: Allows users to participate in the game.
- **View Pick'em page**: Controls visibility of the extension page.

#### Automated Logic

[](#automated-logic)

- **Result Calculation**: When an admin enters the score, the system automatically determines the winner (Home/Away/Draw).
- **Status Updates**: Matches are automatically marked as "Finished" when results are saved.
- **Notifications**: Users who predicted a match receive a notification when the result is entered.

#### 🌍 Translations

[](#-translations)

This extension comes with English translations. Community translations are welcome! [![Translate](https://camo.githubusercontent.com/bea4455070a9f6e489a8e61e5336bc1ea3384908f04c545e5feef908d51369b3/68747470733a2f2f7765626c6174652e726f623030362e6e65742f776964676574732f666c6172756d2f2d2f6875736579696e66696c697a2d7069636b656d2f6d756c74692d6175746f2e737667)](https://weblate.rob006.net/projects/flarum/huseyinfiliz-pickem/)

#### 💖 Support &amp; Contributing

[](#-support--contributing)

If you find this extension useful, consider:

- ⭐ Starring the repository on GitHub
- 💬 Leaving feedback on the [Flarum discussion](https://discuss.flarum.org/d/38433-pickem-match-prediction-extension)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance63

Regular maintenance activity

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 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 ~3 days

Total

2

Last Release

223d ago

### 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 (29 commits)")

---

Tags

extensionflarumsportspredictionspickem

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

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

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

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[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/masquerade

User profile builder extension for your Flarum forum.

2025.4k5](/packages/fof-masquerade)[fof/sitemap

Generate a sitemap

1899.7k2](/packages/fof-sitemap)[flarum/gdpr

Features for GDPR, PII management

1338.8k22](/packages/flarum-gdpr)[fof/discussion-language

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

1034.8k4](/packages/fof-discussion-language)

PHPackages © 2026

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