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.