PHPackages                             ernestdefoe/favorite-team - 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. ernestdefoe/favorite-team

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

ernestdefoe/favorite-team
=========================

Let members pick a favorite FBS college-football team; show its logo under their avatar.

2.0.4(1mo ago)021MITJavaScriptPHP ^8.3

Since May 30Pushed 1mo agoCompare

[ Source](https://github.com/ernestdefoe/favorite-team)[ Packagist](https://packagist.org/packages/ernestdefoe/favorite-team)[ RSS](/packages/ernestdefoe-favorite-team/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

Favorite Team
=============

[](#favorite-team)

[![Floxum](https://camo.githubusercontent.com/38543bc090c7fd65fa58e086d395320eab75b9726dcf8388b98ac12a30d3d7dc/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f6661766f726974652d7465616d2f62616467652f6e616d65)](https://floxum.com/extension/ernestdefoe/favorite-team)[![Version](https://camo.githubusercontent.com/0248c6db3317e4c2ddff5f368f767fb55225abaf9bc6fe510ce30dea9d8ea47f/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f6661766f726974652d7465616d2f62616467652f686967686573742d76657273696f6e)](https://floxum.com/extension/ernestdefoe/favorite-team)[![Downloads](https://camo.githubusercontent.com/62376e065c67d3e14ff1f110579f5e920643c28bbfd76ecd93b6b864044ee8d0/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f6661766f726974652d7465616d2f62616467652f646f776e6c6f616473)](https://floxum.com/extension/ernestdefoe/favorite-team)[![Review](https://camo.githubusercontent.com/b3a6091b05ea71afbd8dd97d4fc478384549ac326f1d75edcdccb4edfda74b43/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f6661766f726974652d7465616d2f62616467652f726576696577)](https://floxum.com/extension/ernestdefoe/favorite-team)[![License](https://camo.githubusercontent.com/bf2db47f607e3717cbee418302d90462a2daf04ec387d61ce8e0aa4c97d905fb/68747470733a2f2f666c6f78756d2e636f6d2f657874656e73696f6e2f65726e6573746465666f652f6661766f726974652d7465616d2f62616467652f6c6963656e7365)](https://floxum.com/extension/ernestdefoe/favorite-team)

A [Flarum](https://flarum.org) 2.x extension that lets members pick a favorite FBS (NCAA Division I-A) college-football team. The team's logo is displayed under the member's avatar on posts and on their profile.

Features
--------

[](#features)

- **Team picker** — a searchable grid of all 136 FBS teams (logo + name) in the member's account settings.
- **Avatar badge** — the chosen team's logo overlays the bottom-left corner of the avatar on posts (with the team name on hover), and on the profile / user card.
- **Require at registration (optional)** — an admin toggle that forces new members to pick a team before they can use the forum. It shows a non-dismissible picker on the next page load for any logged-in member who hasn't chosen yet (works with normal, social, and SSO sign-ups).
- **No database migration** — the choice is stored in the member's existing preferences, so it loads with the user row (no extra query when rendering the badge across a page of posts).
- **Logos via the ESPN CDN** — no images are bundled or hosted by the extension.

Installation
------------

[](#installation)

```
composer require ernestdefoe/favorite-team
php flarum cache:clear
```

Then enable **Favorite Team** in the admin panel under Extensions.

Usage
-----

[](#usage)

### For members

[](#for-members)

Go to **Settings** → **Favorite Team** → **Choose your team**, search or scroll the grid, pick a team, and save. The logo then shows under your avatar.

### For admins

[](#for-admins)

Open the **Favorite Team** extension page in the admin panel and toggle **Require members to pick a team** to force the choice at registration. It's off by default.

How it works
------------

[](#how-it-works)

- The FBS team list is bundled as static reference data in [`resources/teams.json`](resources/teams.json) (id, name, abbreviation, color, and ESPN logo URL per team).
- The chosen team id is stored in the member's `preferences`(`ernestdefoe-favorite-team.team`).
- The core `UserResource` is extended with two fields:
    - `favoriteTeamId` — writable by the member themselves (or an admin), validated against the bundled team list.
    - `favoriteTeam` — a read-only resolved object (`id`, `name`, `logo`, …) used to render the badge; readable by everyone.
- `GET /api/fbs-teams` returns the full team list for the picker.

API
---

[](#api)

MethodEndpointNotes`GET``/api/fbs-teams`Full FBS team list (registered users).`PATCH``/api/users/{id}`Set `favoriteTeamId` (self or admin).Configuration
-------------

[](#configuration)

Admin settingDefaultEffectRequire members to pick a teamoffBlocks members without a team until they choose.Notes
-----

[](#notes)

Team names and logos are the property of their respective institutions and are served from ESPN's public logo CDN. This is an unofficial fan tool and is not affiliated with or endorsed by the NCAA, ESPN, or any team.

Support
-------

[](#support)

Questions, bug reports, and feature requests:

- **Support forum:**
- **Issues:**

License
-------

[](#license)

MIT

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance93

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

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

Total

5

Last Release

33d ago

PHP version history (2 changes)2.0.0PHP ^8.2

2.0.4PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9978664264055711c21fbcf73c937f758df771d9cb40f6a25370b10123e7abc?d=identicon)[ernestdefoe](/maintainers/ernestdefoe)

---

Top Contributors

[![ernestdefoe](https://avatars.githubusercontent.com/u/24905286?v=4)](https://github.com/ernestdefoe "ernestdefoe (10 commits)")

### Embed Badge

![Health badge](/badges/ernestdefoe-favorite-team/health.svg)

```
[![Health](https://phpackages.com/badges/ernestdefoe-favorite-team/health.svg)](https://phpackages.com/packages/ernestdefoe-favorite-team)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

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

Well integrated, advanced private discussions.

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

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

1034.8k7](/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/masquerade

User profile builder extension for your Flarum forum.

2025.4k6](/packages/fof-masquerade)[michaelbelgium/mybb-to-flarum

Migrate a MyBB Forum to a fresh Flarum instance

261.1k](/packages/michaelbelgium-mybb-to-flarum)

PHPackages © 2026

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