Mitch Referrals — Major Feature Update Released!
This update is a
big step forward for Mitch Referrals, focusing on flexibility, developer extensibility, and real-world usability — without adding bloat or forcing unwanted behavior.
Below is a full breakdown of
everything added since the previous release 
Referral links for
You’re no longer limited to a single referral URL.
Members can now:
- Paste any internal URL (or relative path) into their affiliate page
- Instantly generate a tracked referral link for that specific page
- Share links to threads, resources, landing pages, or anywhere else on the forum
This makes referrals far more natural and effective — users can promote
content, not just the homepage.
Member affiliate dashboard (expanded)
The affiliate page has been significantly improved and now includes:
Personal referral code- One-click copy referral links
Live stats:
- Total clicks
- Unique clicks
- Successful registrations
Latest referred registrations
Referral link generator for custom URLs
Everything members need in one place, with a clean XenForo-native UI.
Sidebar widget: referral stats anywhere
A new
sidebar widget is now available, allowing members to see their referral performance from anywhere on the site.
The widget can display:
- Referral code
- Referral link for the current page
- Click and registration stats
- Quick link to the full affiliate dashboard
Perfect for keeping referrals visible without disrupting the main experience.
Built-in reward notifications (optional)
This release introduces a
reward-ready architecture, starting with built-in alerts.
When enabled via options:
Members receive an alert when a referral converts into a registration
Members receive an alert when they hit referral milestones (5, 10, 25, 50, 100)
Rewards are
fully optional and disabled by default, so admins stay in control.
Developer hooks (new!)
Mitch Referrals is now officially
extensible.
Two new code events are fired from the source of truth:
- mitch_referrals_conversion
Fires when a referral registration is successfully credited
- mitch_referrals_threshold
Fires when a referrer hits a referral milestone
These hooks allow other add-ons to:
- Award credits or points
- Promote user groups
- Grant trophies or badges
- Trigger external integrations
- Build custom reward systems
No core files touched. No hacks. Fully XenForo-native.
New admin options
New settings give admins more control over referral behavior, including:
- Enable/disable reward notifications
- Cookie handling and attribution rules
- Click tracking configuration
All options are safe-by-default and designed for live production forums.
🛠 Stability & architecture improvements
Under the hood, this update includes:
- Cleaner separation of “source of truth” logic
- Safer referral attribution (no double-counting)
- Improved event firing consistency
- Better long-term upgrade and extensibility support
Summary
This update turns Mitch Referrals from a simple referral tracker into a
flexible, extensible referral platform — ready for real communities, real incentives, and future expansion.
As always, feedback and suggestions are welcome.
More reward integrations are coming next.
Technical Highlights