[XB] Verification Badges: User Roles & Achievements 2.1.0

Add multiple badges next to XenForo usernames to highlight verified members, achievements, roles, memberships, and community status.

Verification Badges provides a complete user badge and recognition system with automatic awards, badge requests, expiration and renewal, badge owners, categories, progress tracking, a public badge directory, moderation tools, and extensive appearance customization.

---

Features:​

User Badges & Display​

• Multiple User Badges: Display one or more verification, achievement, role, or membership badges next to usernames throughout XenForo.
• Badge Tooltips: Show additional badge information when members hover over or interact with a badge.
• Custom Badge Appearance: Configure icons, colors, images, descriptions, custom CSS, and other visual properties.
• Badge Visibility: Control who can see individual badges using configurable visibility criteria.
• Badge Display Order: Control the order of multiple badges through the ACP with predictable ordering for badges sharing the same position.
• Live ACP Preview: Preview unsaved badge icons, colors, images, descriptions, and custom CSS beside a sample username, inside a message, or in a tooltip before saving.

Badge Categories & Catalog​

• Badge Categories: Organize verification and achievement badges into manageable categories.
• Public Badge Catalog: Display active badges by category through XenForo Help.
• Catalog Layouts: Choose from four public badge catalog display layouts.
• Badge Recipient Counts: Show how many members currently hold each badge.
• Badge Recipient Lists: Allow permitted members to browse users who have received a specific badge.
• Category Visibility: Respect category visibility criteria throughout the public badge catalog.

Automatic Badge Awards​

• Automatic Awarding: Automatically grant badges when members satisfy configured XenForo user criteria.
• Conditional Award Retention: Remove automatically awarded badges when a member no longer satisfies their criteria.
• Permanent Achievements: Optionally keep automatically earned badges permanently after their requirements have been met.
• Personal Badge Progress: Show members measurable progress toward supported automatically awarded badges.
• Portable Award Rules: Preserve automatic criteria, retention behavior, validity periods, and renewal settings when badge definitions are exported to XML.

Manual Badge Management​

• Manual Badge Awards: Assign badges directly to individual members.
• Bulk Badge Assignment: Add or remove badges for multiple users at once.
• Badge Owners: Assign multiple managers to manually awarded badges.
• Owner Badge Management: Let badge owners add and remove recipients from their account area without requiring administrator access.
• Administrator-Controlled Ownership: Administrators determine badge owners while existing awards remain unchanged when ownership changes.

Badge Requests & Approval​

• Badge Requests: Allow members to request eligible badges.
• Request Information: Collect messages, attachments, and custom field information with badge requests.
• Approval Queue Integration: Review, approve, or reject badge requests through XenForo's approval queue.
• Request Criteria: Control which members are eligible to request individual badges.
• Available Badges: Show members badges they are currently eligible to request.
• Pending Requests: Display outstanding badge requests from the member's personal badge page.

Expiration & Renewal​

• Badge Validity Periods: Configure manually awarded badges to expire after a specified period or remain valid indefinitely.
• Individual Expiry Overrides: Allow administrators and authorized moderators to change a specific member's badge expiration date.
• Badge Renewals: Let permitted members request renewal during the configured renewal window or after expiration.
• Owner Renewals: Allow badge owners to renew recipients directly using the badge's configured validity period.
• Expiry Reminders: Send one reminder during each badge term before expiration.
• Expiry Notifications: Notify members when their badge expires.
• Immediate Expiry: Expired badges stop displaying as active as soon as their term ends.
• Renewal Workflow: Process renewal requests using the existing message, attachment, custom field, and approval workflow.
• Safe Renewal Dates: Preserve remaining valid time when appropriate or begin a new term when an already expired badge is renewed.

Badge History​

• Badge History: Record badge awards and removals for administrative review.
• History Filters: Filter records by member, badge, actor, action, source, and date.
• Historical Context: Preserve badge names, reasons, and related request references in history entries.
• History Permission: Control access to badge history with a dedicated administrator permission.
• Automatic History Control: Independently enable logging for automatic criteria changes and badge expiration.
• History Retention: Automatically prune eligible automatic history entries after a configurable period while preserving manual history.
• Renewal-Aware History: Renewing an active badge does not create an unnecessary duplicate award event.

---

Useful for:​

• Verified Members: Display verification badges for trusted or confirmed users.
• Member Recognition: Highlight notable, trusted, experienced, or valuable community members.
• Achievement Badges: Reward milestones, accomplishments, participation, or community contributions.
• Role Badges: Identify staff, moderators, contributors, creators, experts, or other community roles.
• Membership Badges: Highlight premium members, supporters, subscribers, donors, or special membership levels.
• Gamification: Encourage members to complete criteria and collect visible achievements.
• Verification Requests: Let members apply for badges that require staff review or supporting information.
• Temporary Verification: Create badges that expire and require periodic renewal.
• Community Recognition: Give trusted badge owners responsibility for managing recipients.
• Badge Directory: Provide members with a public catalog of available badges, requirements, and recipients.

---

FAQ:​

• Can the same badge be assigned both automatically and manually?
  Yes. Administrators and authorized moderators can manually assign an automatic badge. Its configured retention mode still applies to every holder. A conditionally retained badge can be removed when its criteria are no longer met, while a manually removed badge can be awarded again during the next automatic check if the member still meets the criteria.
• Can badge owners manage automatically awarded badges?
  No. Badge owners are available only for manually awarded badges, preventing owner actions from conflicting with automatic criteria and retention rules.
• Will changing a badge's validity period update existing awards?
  No. A new validity period applies to future awards and renewal requests. Existing expiry dates remain unchanged unless an administrator or authorized moderator edits an individual assignment.
• What happens if a renewal request is pending when the badge expires?
  The pending request does not extend the existing term. The badge stops displaying after expiration. If the renewal is later approved, the new term is calculated so applicable remaining valid time is preserved.
• Can members see who else has received a badge?
  Yes, when they have permission to view badge recipients. The public badge catalog can display the current recipient count and link to a recipient list without exposing members to user groups that lack access.
• How is the display order of multiple badges determined?
  Badges follow their configured ACP display order. Badges with the same display order use their badge ID as a stable fallback.
• Are expired badge assignments deleted?
  No. An expired assignment stops displaying as an active badge, but its record remains available for renewal and administrative review. Expiry can also be recorded in badge history when automatic history logging is enabled.

---

Screenshots:​

Public interface

Member and moderator tools​

Admin interface​