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 any page
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.
