PHPackages ernestdefoe/picks - 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 & Helpers](/categories/utility) 4. / 5. ernestdefoe/picks ActiveFlarum-extension[Utility & Helpers](/categories/utility) ernestdefoe/picks ================= College football pick'em game for Flarum. 2.1.3(1mo ago)020↓88.9%MITPHPCI passing Since May 3Pushed 1mo agoCompare [ Source](https://github.com/ernestdefoe/picks)[ Packagist](https://packagist.org/packages/ernestdefoe/picks)[ RSS](/packages/ernestdefoe-picks/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (6)Versions (13)Used By (0) Picks ===== [](#picks) [![Floxum](https://camo.githubusercontent.com/9744e294cd2c3af2f13d7b4d4b34312ea211dc6b633f9a61a082e522b4eb5fb1/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f7069636b732f62616467652f6e616d65)](https://floxum.com/extension/ernestdefoe/picks)[![Version](https://camo.githubusercontent.com/003b1f4f25d90189eab1e50c530a8c507cc2c008f34b9e931ab34d4aca4eeff7/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f7069636b732f62616467652f686967686573742d76657273696f6e)](https://floxum.com/extension/ernestdefoe/picks)[![Downloads](https://camo.githubusercontent.com/5b6a68841971ba959bd6aaa579b022548ae0e2f6c1381533b32d259b4f187d35/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f7069636b732f62616467652f646f776e6c6f616473)](https://floxum.com/extension/ernestdefoe/picks)[![Review](https://camo.githubusercontent.com/c351873853bed1f3b593ea48176c31fc4275cca73b1510ae4ff7538e1a6eefbe/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f7069636b732f62616467652f726576696577)](https://floxum.com/extension/ernestdefoe/picks)[![License](https://camo.githubusercontent.com/0226e9775b0396b76779489c04163268dfa62c5966250fbbf056e53bd51c58c0/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f7069636b732f62616467652f6c6963656e7365)](https://floxum.com/extension/ernestdefoe/picks) A [Flarum](https://flarum.org) 2.x extension that adds a college-football **pick'em** game to your forum. Members predict the winners of each week's games, earn points, and compete on a season leaderboard. Schedules and teams are synced from [CollegeFootballData](https://collegefootballdata.com) (CFBD), and team logos / live scores come from ESPN. Features -------- [](#features) - **Weekly picks** — members pick winners for each game in a week; picks lock at kickoff (with an optional offset). - **Live scoring** — a scheduled task polls ESPN for in-progress scores and grades picks automatically as games finish. - **Leaderboard** — season standings with per-week history and per-user pick history (`/u/{username}/picks-history`). - **Confidence mode (optional)** — members rank their picks by confidence for weighted scoring, with a configurable penalty for missed high-confidence picks. - **Admin management** — sync teams/schedule/scores, open/unlock weeks, enter or override results, refresh team logos, and reset data, all from the admin panel. - **Per-permission access** — separate abilities for viewing, making picks, viewing history, and managing. Requirements ------------ [](#requirements) - Flarum `^2.0` - A free **CollegeFootballData API key** — get one at (used for team and schedule syncing). Installation ------------ [](#installation) ``` composer require ernestdefoe/picks php flarum cache:clear ``` Then enable **Picks** in the admin panel under Extensions. Setup ----- [](#setup) 1. Open the **Picks** page in the admin panel. 2. Paste your **CFBD API key** and set the **season year** (and optionally a conference filter). 3. **Sync Teams**, then **Sync Schedule** to pull the season's games. 4. **Open** the week(s) you want members to pick. 5. Grant the picks permissions to the appropriate groups (see below). To keep live scores updating, make sure Flarum's scheduler is running (see **Scheduler** below) and enable **ESPN polling** in the settings. Permissions ----------- [](#permissions) Set these under **Admin → Permissions**: AbilityLets a user…`picks.view`See the Picks page and leaderboard.`picks.makePicks`Submit and change their own picks.`picks.viewHistory`View pick history for users.`picks.manage`Manage the game (sync, results, weeks, settings). Admins always have this.Settings -------- [](#settings) Configured on the admin **Picks** page (stored under the `ernestdefoe-picks.*`namespace): - **CFBD API key**, **season year**, **conference filter** - **Sync regular season / postseason**, **auto-sync** - **Picks lock offset** (minutes before kickoff) - **Confidence mode** + **confidence penalty** (`none` / `half` / `full`) - **Auto-unlock weeks**, **default week view** - **ESPN polling** + **poll interval** - **Nav label** (the forum nav link text) Scheduler --------- [](#scheduler) Live-score polling runs as a scheduled command (`PollLiveScoresCommand`, every 5 minutes). For it to fire, Flarum's scheduler must be invoked once a minute by cron: ``` * * * * * cd /path/to/forum && php flarum schedule:run >> /dev/null 2>&1 ``` You can also run syncs manually: ``` php flarum picks:sync-teams # sync the FBS team list from CFBD php flarum picks:poll-scores # poll ESPN for live scores once ``` Data sources ------------ [](#data-sources) - **CollegeFootballData (CFBD)** — teams and game schedules (API key required). - **ESPN** — team logos and live in-game scores (public endpoints, no key). Team names, logos, and data are the property of their respective owners and the providers above. This is an unofficial fan tool and is not affiliated with or endorsed by the NCAA, CFBD, ESPN, or any team. Credits ------- [](#credits) Based on [huseyinfiliz/pickem](https://github.com/huseyinfiliz/pickem) by Hüseyin Filiz. Subsequently forked by [resofire](https://github.com/resofire) and now maintained by [ernestdefoe](https://github.com/ernestdefoe) as `ernestdefoe/picks`. Support ------- [](#support) Questions, bug reports, and feature requests: - **Support forum:** - **Issues:** License ------- [](#license) MIT ### Health Score 39 — LowBetter than 84% of packages Maintenance93 Actively maintained with recent releases Popularity6 Limited adoption so far Community8 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.1% 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 ~4 days Total 12 Last Release 33d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c9978664264055711c21fbcf73c937f758df771d9cb40f6a25370b10123e7abc?d=identicon)[ernestdefoe](/maintainers/ernestdefoe) --- Top Contributors [![ResofireV2](https://avatars.githubusercontent.com/u/266603343?v=4)](https://github.com/ResofireV2 "ResofireV2 (64 commits)")[![ernestdefoe](https://avatars.githubusercontent.com/u/24905286?v=4)](https://github.com/ernestdefoe "ernestdefoe (19 commits)") --- Tags extensionflarumsportspickemCFBcollege football ### Embed Badge ![Health badge](/badges/ernestdefoe-picks/health.svg) ``` [![Health](https://phpackages.com/badges/ernestdefoe-picks/health.svg)](https://phpackages.com/packages/ernestdefoe-picks) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 10.5k2.4k](/packages/unopim-unopim)[flarum-lang/russian Russian language pack for Flarum. 12128.3k](/packages/flarum-lang-russian)[flarum/core Delightfully simple forum software. 211.4M2.4k](/packages/flarum-core)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 293.1k](/packages/eslazarev-wildberries-sdk)[fof/sitemap Generate a sitemap 1799.7k2](/packages/fof-sitemap)[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) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)