OVERVIEW
--------
Bounty Hunt transforms your XenForo forum into a community-driven resource
discovery board. Post "Most Wanted" resources, let members submit tips, and
automatically reward successful submissions with premium upgrades.
FEATURES
--------
Public Bounty Page
- Dedicated Most Wanted page listing all active bounties
- Bounties organised into four reward tiers: Platinum, Gold, Silver, Standard
- Each tier displays its own reward label (configurable per tier in options)
- Bounty cards show resource icon, title, description, category, and reward
- "No resources in this tier" placeholder when a tier has no active bounties
- Optional enforcer notice bar displayed across the top of the page
- Guests can optionally browse bounties (configurable) but must log in to submit
- Fully styled with LESS and XenForo style variables — supports dark mode
Submission System
- Members can submit tips for any active bounty via a modal popup form
- Submission form accepts source URL, notes, and an optional file attachment
- Members can view all their past submissions and current statuses
- Submissions are tracked with statuses: Pending, Approved, Rejected
Admin Management
- Full CRUD for bounties: add, edit, delete with icon upload support
- Bounty fields: title, description, resource URL, category, tier, priority,
display order, and status (Active, Claimed, Closed)
- Manage all submissions from a dedicated submissions list
- Filter submissions by status (All / Pending Only)
- Submission detail page shows all member info, notes, URL, and attachment
- Download submitted file attachments directly from the ACP
- Add admin notes to any submission
- Delete submissions with automatic attachment file cleanup
Approval & Reward System
- Approving a submission automatically marks the bounty as Claimed
- Global reward upgrade ID — one setting grants the same upgrade for all tiers
- User upgrade is granted automatically to the submitting member on approval
- Tier reward labels are fully configurable per tier in addon options
Notifications
- Admin receives a private conversation when a new tip is submitted
- Conversation is sent from the submitting member so it lands in your inbox
- Notification includes bounty title, member notes, and source URL
Approval Thread Posting
- Optionally post a forum thread automatically when a submission is approved
- Configurable forum node ID and bot user account for thread authoring
- Thread title and body are fully customisable via XenForo phrases
- Available phrase variables: {title}, {submitter}, {tier}, {reward}
- Thread posting is non-fatal — approval still completes if posting fails
Options & Configuration
- Admin Notification User ID
- Global Reward Upgrade ID
- Guests Can View Bounties (on/off)
- Page Title and Page Description
- Enforcer Notice bar text
- Claim Button Text
- Approval Thread Forum Node ID
- Approval Thread Author User ID
- Per-tier reward labels (Platinum, Gold, Silver, Standard)
How rewards work
------------
Bounty Hunt does not manage subscription lengths or membership durations itself — it delegates that entirely to XenForo's built-in User Upgrades system, which means it works with whatever upgrade structure you already have in place.
When a submission is approved, Bounty Hunt simply fires a User Upgrade against the submitting member's account. The duration of that reward — whether it's one month, six months, a year, or anything else — is determined entirely by how you have configured that upgrade inside XenForo's ACP. If your "Gold Member" upgrade is set to run for six months, approving a gold-tier bounty grants six months. If you later change it to three months in your upgrade settings, every future approval reflects that automatically.
You can assign a different User Upgrade ID to each bounty tier — Platinum, Gold, Silver, and Standard — so each tier can carry a genuinely different reward duration. There is also a global fallback upgrade ID for any tier you haven't specifically configured.
This approach means the addon has no opinion about how long rewards should last. You are in full control through your existing upgrade configuration, and there is nothing to learn beyond pointing each tier at the right upgrade ID in the Bounty Hunt options page.
REQUIREMENTS
------------
- XenForo 2.3.0 or newer
- PHP 8.0+
- MySQL 5.7+ / MariaDB 10.3+
INSTALLATION
------------
1. Upload the contents of upload/ to your XenForo root directory
2. In the ACP go to Add-ons and click Install/Upgrade
3. Select XFTech_BountyHunt_v1.0.0.zip and install
4. Configure the addon under ACP > Bounty Hunt > Options
5. Add your first bounty under ACP > Bounty Hunt > Add Bounty
SUPPORT
-------
xenforotech.com
