[XB] Badges 2.4.0

Create collectible XenForo badges and award them automatically through user criteria or manually through staff tools.

Organize achievements into categories and tiers, build visual progression with badge stacks, and let members feature their favorite awards across profiles, member cards, tooltips, and posts.

---

Features:​

Badge Creation & Design​

• Flexible Badge Icons: Use Font Awesome, Material Design Icons, uploaded assets, external images with high-resolution variants, or custom HTML.
• Categories & Display Order: Organize badges into ordered categories with their own icons and styling.
• Badge Tiers: Create color-coded tiers with optional custom CSS for clear achievement levels.
• Badge Stacks: Group related badges into visual progression stacks and optionally show stacked counters.
• Custom Badge Links: Send members to a relevant page when they click a badge and configure additional link attributes.
• Configurable Badge Grids: Choose how badges appear on the help page and member badge tab.

Awarding & Management​

• Automatic Badge Awards: Award and revoke badges according to XenForo user criteria on a scheduled or session-based update cycle.
• Manual Awards: Allow authorized staff to award or take away eligible badges from member profiles, with an optional award reason.
• Repeatable Awards: Let members earn selected badges more than once, with an optional delay between awards.
• Batch Operations: Award, revoke, activate, deactivate, or update badges and user awards in bulk.
• Award Notifications: Notify recipients through XenForo alerts and optional email notifications.
• Export & Import: Export badges to XML, import badge collections, and retain categories, tiers, icons, links, and active states.

Member Experience​

• Featured Badges: Let members feature their preferred awards, subject to configurable limits and permissions.
• Profile Badge Collection: Display earned badges, award dates, reasons, categories, and stacks on a dedicated member profile tab.
• Forum-Wide Display: Show featured badges in posts, member profiles, member cards, and member tooltips with responsive style controls.
• Badge Directory: Provide a categorized help page where members can browse available achievements and see which badges they have earned.
• Badge Counts: Display each member's collected badge total in profile statistics.

Administration & Integrations​

• Member Search Criteria: Find users by awarded badges or by the number of badges they have collected.
• Ban Workflow: Optionally remove all badges while banning a member.
• Granular Permissions: Control who can view badge tabs and recipient lists, award or take away badges, and manage featured badges.
• REST API: Read badges, categories, tiers, and user awards; authorized API clients can also award, edit, feature, remove, or delete supported records.
• DBTech Credits Integration: Use badge awards as an event trigger when DragonByte Credits is installed.

---

Permissions:​

• View Member Badges: Choose who can view another member's badge tab.
• View Awarded Members: Control access to the list of members who received a badge.
• Award Badges: Allow selected staff or user groups to award manually available badges.
• Take Away Badges: Allow selected staff or user groups to revoke eligible awards.
• Manage Featured Badges: Let members manage their own featured awards or allow staff to manage them for any member.
• Featured Badge Limit: Set the maximum number of badges a member may feature.

---

Requirements:​

• XenForo 2.2.0+
• PHP 7.0+
• [XB] Core Library 1.0.0+

---

Installation:​

Upload the .zip file using Install/upgrade from archive in Admin control panel → Add-ons.

---

Importing From Another Badge Add-on:​

1. Disable the old add-on ([VersoBit] Badges or [bd] Metals).
2. Install [XB] Badges.
3. Go to Admin control panel → Tools → Import data.
4. Select [XB] Badges: [VersoBit] Badges or [bd] Metals and complete the importer.
5. Verify the imported badges and member awards, then uninstall the old add-on if it is no longer needed.

---

Useful for:​

• Community Engagement: Reward meaningful participation, milestones, and valuable contributions.
• Learning Communities: Represent courses, skills, certifications, and progressive achievement levels.
• Gamification: Build collectible achievements, repeatable challenges, and visible progression paths.
• Recognition Programs: Highlight staff picks, event participation, supporter status, or community service.
• Member Identity: Give users a curated set of featured awards to display throughout the forum.

---

Recommended Extensions:​

• [XB] Badges Alternative Icon — adds an alternative presentation for badge icons.
• [XB] Badges Award Post — extends the badge award workflow with forum posts.

---

Credits:​

This project is derived from Badges by @CMTV and @VersoBit.