fof/badges

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

1.0.1 2026-02-12 15:41 UTC

Requires

• php: ^8.1
• flarum/core: ^1.8.0

Requires (Dev)

• flarum/likes: *
• flarum/nicknames: *
• flarum/phpstan: ^1.8
• flarum/tags: *
• flarum/testing: ^1.0.0
• fof/best-answer: *
• fof/byobu: *
• fof/gamification: *
• fof/polls: *
• fof/reactions: *
• fof/upload: *
• fof/user-bio: *

Suggests

• flarum/likes: Required for likes received/given metrics
• flarum/nicknames: Required for has nickname metric
• flarum/tags: Required for posts in tag metric
• fof/best-answer: Required for best answers received metric
• fof/byobu: Required for private discussions created metric
• fof/gamification: Required for upvotes/downvotes received/given metrics
• fof/polls: Required for polls created/voted metrics
• fof/reactions: Required for reactions received/given metrics
• fof/upload: Required for files uploaded metric
• fof/user-bio: Required for has bio metric

Replaces

• huseyinfiliz/badges: *

MIT

• Hüseyin Filiz
• FoF Team

• Gamification
• achievements
• badges
• flarum
• awards

README

A Flarum 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

Installation

Install manually with composer:

composer require fof/badges:"*"

Updating

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

Optional Dependencies

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

• flarum/likes — Likes Received / Given
• flarum/tags — Posts in Tag
• flarum/nicknames — Has Nickname
• fof/user-bio — Has Bio
• fof/best-answer — Best Answers Received
• fof/upload — Files Uploaded
• fof/polls — Polls Created / Voted
• fof/byobu — Private Discussions Created
• fof/reactions — Reactions Received / Given
• fof/gamification — Upvotes / Downvotes Received / Given

Links

• Packagist
• GitHub
• Discuss
• Issues

An extension by FriendsOfFlarum.