Add-ons Mitch Referrals 1.5.2
- Author XenForo
- Creation date
Mitch Referrals v1.4.6 – Referral Source Analytics (External Traffic Tracking)
Version: 1.4.6
XF Compatibility: 2.3.x
This update introduces Referral Source Analytics, a long-requested feature that shows where referrals actually came from, not just where users landed on your site.
What’s New
External Referral Source Tracking (Done Right)
Affiliate clicks now capture and store the external referrer at click time:
Tracks external domains and pages (Google, Reddit, blogs, etc.)
Internal site URLs are explicitly ignored
Data is captured at click time, never guessed later
Fully XF-native, safe, and privacy-respecting
Each click can now store:
External source domain
External source full URL (when available)
Note: Some platforms (e.g. Discord, mobile apps, privacy browsers) do not send referrer headers. In those cases, the source will correctly display as Unknown.
“Who Referred Who” – Source Display
The affiliate dashboard now shows where each successful referral originated:
Source domain displayed per registration
Optional link to the originating page (when available)
Click → registration matching is evidence-based:
Same referrer
Same IP
Within attribution window
Click occurred before registration
No heuristics. No assumptions.
Why This Matters
Most referral systems only show:
total clicks
total signups
Mitch Referrals now answers the real question:
Which platforms are actually converting?
This lays the groundwork for:
Top referral domains
Per-affiliate traffic sources
Future analytics dashboards
Mitch Referrals v1.4.5 – Feature Update
This release focuses on affiliate tools, usability improvements, and stability fixes, expanding Mitch Referrals into a more complete referral & promotion system.
New: Affiliate Banner / Referral Tools Page
Members can now access a dedicated Referral Tools → Banners page where they can:
View all available promotional banners
Copy BBCode or HTML snippets with one click
Automatically inject their own affiliate code into banner links
Use banners in forum signatures, external sites, or ads without manual editing
This makes it significantly easier for members to actively promote your community.
Widget Enhancement
The Affiliate widget now includes a direct link to the Referral Tools / Banners page, making promotion tools immediately discoverable right from the dashboard.
Admins now have a full ACP banner management system, allowing you to:
Add, edit, enable/disable, and delete banners
Control banner titles, images, links, and optional custom HTML
Instantly update what affiliates see without code changes
Store banner data safely via XenForo options (exportable & upgrade-safe)
Upload support is intentionally disabled for this release to ensure maximum stability and export compatibility. Image URLs are fully supported.
Affiliate Code Auto-Injection
All banners automatically include the correct affiliate tracking code for the viewing user.
No manual editing, no copy mistakes, no broken links.
🛠 Fixes & Improvements
Fixed copy-to-clipboard issues across widgets, leaderboards, and tools pages
Improved template structure and styling consistency
Cleaned up referral attribution edge cases
Improved option handling to ensure upgrade safety and data integrity
General stability and performance improvements
XenForo 2.2+ / 2.3+
Fully upgrade-safe
No core file modifications
Summary
Version 1.4.5 transforms Mitch Referrals from a tracking system into a true affiliate promotion platform, giving both admins and users the tools they need to grow communities organically.
As always, feedback and feature requests are welcome
Mitch Referrals 1.4.4 – Feature Release
This update introduces a major expansion of the affiliate system, giving members better tools to promote your site and giving admins more control over referrals and rewards.
Referral Tools: Banners Page (Public)
Members now have access to a dedicated Referral Tools → Banners page where they can:
View all available promotional banners
Copy BB code or HTML code with one click
Automatically inject their personal affiliate code into banner links
Use banners in forum signatures, external websites, or promotions
This makes it dramatically easier for members to actively promote your site.
A new Affiliate Referrals page allows members to clearly see:
Who they have referred
Referral dates
Referrer ↔ referred relationships
Clean, modern card-based layout
Mobile-friendly responsive design
This adds transparency and motivation for affiliates.
Referral Leaderboard Enhancements
The referral leaderboard has been refined with:
Cleaner layout
Better spacing and responsiveness
Improved UX consistency with XenForo 2.3.x styling
Referral Rewards System (PHP-Driven)
Referral credit payouts are now handled entirely in PHP, removing reliance on bridge/event hacks.
Benefits:
More reliable credit payouts
No duplicate credit triggers
Full control over referral logic
Compatible with DBTech Credits
Registration Referral Input
New registrants can now optionally enter the username of the member who referred them directly on the registration form.
Works alongside cookie-based referrals
Automatically triggers the same referral logic and rewards
Prevents duplicate or self-referrals
Admin Improvements
Banner Management (Admin CP)
Admins can now manage banners from the Admin CP:
Add, edit, enable/disable banners
Control banner titles, images, links, and custom HTML
Centralized banner configuration (no hardcoding)
Note: Image upload support is intentionally disabled in this release and will be introduced in a future update. For now, banners use image URLs.
🛠 Technical Improvements
Improved referral attribution safety
Stronger duplicate-prevention logic
Better compatibility with XenForo 2.3.7+
Cleaner separation between public and admin logic
Export-safe templates and options (no _output hacks)
Version
1.4.4
This release focuses on affiliate usability, promotion tools, and system reliability, laying the groundwork for future enhancements like media uploads and advanced banner analytics.