PHPackages                             fof/badges - 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. fof/badges

ActiveFlarum-extension

fof/badges
==========

A comprehensive badge and achievement system for Flarum with conditional triggers, automatic awarding, and manual assignment.

1.0.5(2mo ago)31.7k↓46.1%11MITPHPPHP ^8.1CI passing

Since Feb 12Pushed 1mo agoCompare

[ Source](https://github.com/FriendsOfFlarum/badges)[ Packagist](https://packagist.org/packages/fof/badges)[ Docs](https://friendsofflarum.org)[ Fund](https://opencollective.com/fof/donate)[ RSS](/packages/fof-badges/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (5)Dependencies (26)Versions (12)Used By (1)

Badges by FriendsOfFlarum
=========================

[](#badges-by-friendsofflarum)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/3b8f9475eca9829ec721a98dccb4c457c65eaee66da6d648733335146a54c112/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f6261646765732e737667)](https://packagist.org/packages/fof/badges) [![Total Downloads](https://camo.githubusercontent.com/1ea947ac4c062951dce55d1f53a01b96c9790bdb1106268dd31303611cdf545c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f662f6261646765732e737667)](https://packagist.org/packages/fof/badges) [![OpenCollective](https://camo.githubusercontent.com/1903c197bb0307e60d6328653532b8a6b9890b898fbc92e314ab39d699491e74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e636f6c6c6563746976652d666f662d626c75652e737667)](https://opencollective.com/fof/donate)

A [Flarum](https://flarum.org/) extension. A comprehensive badge and achievement system with conditional triggers, automatic awarding, and manual assignment.

- Create badges with custom icons, colors, and descriptions
- Organize badges into categories
- Automatic awarding based on configurable trigger conditions (post count, likes, member days, etc.)
- AND/OR logic, date ranges, and tag filtering for triggers
- Manual badge assignment by moderators
- Notifications and automatic group assignment on badge earned
- Badge list page, profile tab, rarity tiers, and user card integration
- Built-in integration with many FoF and Flarum extensions

[![](https://camo.githubusercontent.com/88b7df4082719f2c3938780d281f0606c06841c55b2766600768dd1790de4ac1/68747470733a2f2f692e6962622e636f2f6353773044644a462f696d6167652e706e67)](https://camo.githubusercontent.com/88b7df4082719f2c3938780d281f0606c06841c55b2766600768dd1790de4ac1/68747470733a2f2f692e6962622e636f2f6353773044644a462f696d6167652e706e67)

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

[](#installation)

Install manually with composer:

```
composer require fof/badges:"*"
```

Updating
--------

[](#updating)

```
composer update fof/badges
php flarum migrate
php flarum cache:clear
```

Optional Dependencies
---------------------

[](#optional-dependencies)

This extension integrates with the following extensions to provide additional badge metrics:

- [`flarum/likes`](https://github.com/flarum/likes) — Likes Received / Given
- [`flarum/tags`](https://github.com/flarum/tags) — Posts in Tag
- [`flarum/nicknames`](https://github.com/flarum/nicknames) — Has Nickname
- [`fof/user-bio`](https://github.com/FriendsOfFlarum/user-bio) — Has Bio
- [`fof/best-answer`](https://github.com/FriendsOfFlarum/best-answer) — Best Answers Received
- [`fof/upload`](https://github.com/FriendsOfFlarum/upload) — Files Uploaded
- [`fof/polls`](https://github.com/FriendsOfFlarum/polls) — Polls Created / Voted
- [`fof/byobu`](https://github.com/FriendsOfFlarum/byobu) — Private Discussions Created
- [`fof/reactions`](https://github.com/FriendsOfFlarum/reactions) — Reactions Received / Given
- [`fof/gamification`](https://github.com/FriendsOfFlarum/gamification) — Upvotes / Downvotes Received / Given

Links
-----

[](#links)

[![OpenCollective](https://camo.githubusercontent.com/8ea53c451470d1a72789d650c77e2b22eee915f7fbf2cbeeeeaa25f47301efe2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d667269656e64736f66666c6172756d2d3434414545353f7374796c653d666f722d7468652d6261646765266c6f676f3d6f70656e2d636f6c6c656374697665)](https://opencollective.com/fof/donate)

- [Packagist](https://packagist.org/packages/fof/badges)
- [GitHub](https://github.com/FriendsOfFlarum/badges)
- [Discuss](https://discuss.flarum.org/d/38762-fof-badges)
- [Issues](https://github.com/FriendsOfFlarum/badges/issues)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum).

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance88

Actively maintained with recent releases

Popularity26

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.8% 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

8

Last Release

55d ago

Major Versions

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

PHP version history (2 changes)1.0.0PHP ^8.1

2.0.0-beta.1PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16573496?v=4)[IanM](/maintainers/imorland)[@imorland](https://github.com/imorland)

![](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 (30 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (8 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (4 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (1 commits)")

---

Tags

flarumbadgesGamificationachievementsawards

### Embed Badge

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

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

###  Alternatives

[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[fof/gamification

Upvotes and downvotes for your Flarum community

4157.1k6](/packages/fof-gamification)[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[tehwave/laravel-achievements

Simple, elegant Achievements the Laravel way

7012.8k](/packages/tehwave-laravel-achievements)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[flarum-lang/russian

Russian language pack for Flarum.

13126.1k](/packages/flarum-lang-russian)

PHPackages © 2026

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