Overview Version (9) Discussion (9)

• 

  Mitch - Referrals

  Mitch Referrals gives your community an easy, powerful way to spread the word — and gives you clear

  mitch referrals

  referrals
  About this resource

  

  
  

  Mitch Referrals

  Turn your members into your best promoters
  
  Growing a forum is hard. Keeping it growing is even harder.
  Mitch Referrals gives your community an easy, powerful way to spread the word — and gives you clear insight into what's actually working.
  
  No gimmicks. No hacks. Just a clean referral system built the XenForo way.
  
  

  ---

  
  

  Simple referral links (that just work)

  
  Every member gets a unique referral code they can share anywhere using links like:
  
  ?ref=ABC123
  
  ✔ No pretty URLs required
  ✔ No URL clutter
  ✔ No core file edits
  
  When someone visits using a referral link, Mitch Referrals:
  

  • Tracks the click
  • Stores attribution securely via cookie
  • Automatically cleans the URL to prevent double-counting
  • Credits referrals only when a registration is completed

  Fair, accurate, and abuse-resistant by design.
  
  

  ---

  
  

  Share the

  
  Why send everyone to the homepage?
  
  With Mitch Referrals, members can generate referral links for any page on your site, including:
  

  • Forum threads
  • Categories
  • Resources
  • The homepage
  • Custom landing pages

  From the affiliate dashboard, members can paste any internal URL (or relative path) and instantly generate a referral-enabled version. This lets them share the content that actually convinced them — which means better engagement and better signups.
  
  Bonus: the optional sidebar widget automatically creates a referral link for the page the user is currently viewing, making organic sharing effortless.
  
  

  ---

  
  

  Everything members need, in one place

  
  Each member gets a clean, easy-to-use affiliate dashboard where they can:
  

  • View their referral code
  • Copy referral links with one click
  • Generate referral links for specific pages
  • Track total clicks and unique clicks
  • See how many users registered through their links
  • View recent referral activity

  It feels native. It looks native. Because it is native.
  
  

  ---

  
  

  Clear insight for admins (without the noise)

  
  Admins get a dedicated stats page that shows:
  

  • Top referrers
  • Click totals and unique clicks
  • Registration counts
  • Conversion performance over time

  Plus a focused set of admin options:
  

  • Referral cookie lifetime
  • Unique click tracking window
  • Enable/disable click tracking
  • Control whether referral cookies can be overwritten

  No bloated settings pages. Just the controls that matter.
  
  

  ---

  
  

  Built the XenForo way

  
  Mitch Referrals is built specifically for XenForo 2.3.x and follows best practices:
  
  ✔ No core edits
  ✔ No URL rewriting
  ✔ Uses native entities, listeners, widgets, and templates
  ✔ Safe for live production sites
  ✔ Fully dev-mode exportable
  
  Install it, turn it on, and let your members do what they already do best — talk about your community.
  
  

  ---

  
  

  Designed to grow with you

  
  Mitch Referrals is intentionally lightweight, but built on a solid foundation. It's ready today for:
  

  • Organic community growth
  • Member-driven promotion
  • Content-specific referrals

  And it's structured to support future upgrades like:
  

  • Referral rewards
  • Paid upgrade commissions
  • Leaderboards
  • Trophy or badge integration

  ---

  
  

  In short

  
  If you want a referral system that:
  

  • Feels native to XenForo
  • Empowers your members
  • Tracks real results
  • Avoids common abuse pitfalls
  • And leaves room to grow

  Mitch Referrals has you covered.
• Version

  1.5.4 Stable Available Jan 18, 2026 · 1

  Download

  File size: 60.1 KB

  SHA-256: 49385b16910a132a621dbf6dde67e515fd1d0865bba224dab729995d6d174f04

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  Fixes Null error in widget

  1.5.3 Stable Available Jan 18, 2026 · 0

  Download

  File size: 60.1 KB

  SHA-256: b45c13b6aaa7d9d382b0cb97878d2dbbb7f56337d9c14cc5aea83b0017ef304a

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  Fixed install error on some installs

  1.5.2 Stable Available Jan 7, 2026 · 1

  Download

  File size: 59.9 KB

  SHA-256: fada2a3e43628c9d85f02017ce4b57a66d3f77e24859b82c0174705f94ab3e93

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  Fixed upgrade step

  1.5.1 Stable Available Jan 7, 2026 · 0

  Download

  File size: 59.7 KB

  SHA-256: 55ca9f141ea16668c5596dec3c49868a08d44747e5e27def3ff3e68706eb6139

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  Mitch Referrals v1.5.1 — Analytics & Reporting Update

  
  This release introduces the first phase of real analytics for Mitch Referrals, giving both administrators and affiliates better visibility into referral performance.
  
  

  New: Admin Analytics Dashboard (ACP)

  
  A new Stats page has been added to the Admin Control Panel, providing a high-level overview of referral performance across the site.
  
  Admins can now see:
  

  • Top referrers by registrations
  • Total clicks vs unique clicks
  • Conversion rates (registrations ÷ unique clicks)
  • Time-based filtering (last X days)

  This makes it much easier to identify high-performing affiliates and evaluate overall referral effectiveness.
  
  

  ---

  
  

  New: Referral Source Tracking (Foundation)

  
  Clicks now store external referral source data at click time, laying the groundwork for advanced analytics.
  
  What's captured:
  

  • External referrer URL (when available)
  • Referrer domain (e.g. Google, Discord, Reddit, blogs, etc.)
  • Internal landing pages are explicitly excluded

  This data is stored safely at click time and will power future reports such as:
  

  • Top traffic sources
  • Per-affiliate traffic breakdowns
  • Source-level conversion analysis

  (No guessing, no retroactive assumptions.)
  
  

  ---

  
  

  New: Affiliate-Side Stats Improvements

  
  Affiliate dashboards now benefit from more accurate and consistent click data, ensuring:
  

  • Reliable total vs unique click counts
  • Better alignment between clicks and registrations
  • Future readiness for affiliate-visible analytics expansions

  ---

  
  

  Technical Notes

  • Fully compatible with XenForo 2.3.x
  • Schema changes are applied automatically during install/upgrade from archive
  • No destructive migrations
  • Existing data is preserved

  Important:
  As with all releases that include PHP and database changes, upgrades should be performed using "Install/upgrade from archive" in the Admin Control Panel.

  1.4.5 Stable Available Dec 29, 2025 · 0

  Download

  File size: 53.6 KB

  SHA-256: e76a4a0f63612efbb7198fc94ddac6157fe31d8f771056ec95596cde77771c6b

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  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.

  Admin-Controlled Banner Management
  
  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

  Compatibility
  

  1. XenForo 2.2+ / 2.3+
  2. Fully upgrade-safe
  3. 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.

  1.4.4 Stable Available Dec 27, 2025 · 0

  Download

  File size: 53.6 KB

  SHA-256: 2f4a700b0a54af6e469eb18df6fb8c0d5267927a3d0ea84e8d2ec9af38993f16

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  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.
  
  

  ---

  
  

  New Features

  
  

  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.
  
  

  ---

  
  

  Affiliate Referrals Page (Public)

  
  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.

  Click to expand...

  
  

  ---

  
  

  🛠 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.

  1.4.3 Stable Available Dec 27, 2025 · 0

  Download

  File size: 44.8 KB

  SHA-256: d19e82f1a0ee4f5353f0df246bf512fcb35eae2ed05280728e21dfcfbc29d227

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  Mitch Referrals v1.4.3 – Feature Update & Stability Release

  
  This release finalizes the referral → credit flow, removes all DBTech bridge dependency for payouts, and adds long-requested visibility and registration improvements.
  
  

  ---

  
  

  Referral Attribution (Stable & Final)

  • Referrals are now attributed at registration time as the single source of truth.
  • Attribution works via:
    • Referral cookie OR
    • Username entered on the registration form
  • Each user can only ever be attributed once.
  • Self-referrals are blocked.
  • Attribution never breaks registration if something fails.

  ---

  
  

  DBTech Credits – Direct PHP Payouts (No Bridge)

  • Credits are now awarded directly via PHP.
  • DBTech "Event" logic is no longer used to determine amounts.
  • No reliance on:
    • Content type filters
    • Event caps
    • Daily limits
    • Apply-max rules
  • Credits are always awarded exactly once per valid referral.

  ---

  
  

  Referral Payout Rules (Single-Line Option)

  
  Referral payouts are now controlled by a single option string.
  
  Format (single line only):
  
  <span>*=1000|Registered=250|Moderator=500|Administrative=0<br></span>
  
  How it works:
  

  • *= is the fallback payout
  • Matches are done by user group title
  • If a user belongs to multiple groups, the highest payout wins
  • Group titles make this portable across installs

  ---

  
  

  Affiliate Referrals Page (Member-Facing)

  • New public page showing:
    • Who referred whom
    • Referral dates
  • Accessible to logged-in members
  • Clean, paginated layout
  • Linked from the Members menu

  ---

  
  

  Referral Widget Improvements

  • Referral link is displayed in a read-only field
  • Copy button now uses XenForo's clipboard handler correctly
  • Users can copy their referral link with one click

  ---

  
  

  Registration Page Enhancement

  
  

  • Optional "Referred by (username)" field added to registration
  • Username is validated and resolved at registration
  • Triggers the same referral logic as cookie-based referrals

  ---

  
  

  🛠 Technical / Internal

  • Referral attribution handled in XF\Entity\User::_postSave
  • Referral repository is the single source of truth
  • Safer IP logging
  • No _output files edited directly
  • Fully XenForo 2.3.7 compliant

  ---

  
  

  Result

  • Credits award reliably
  • Stats remain accurate
  • Admin control is simple
  • Users can clearly see referral relationships
  • No fragile event configuration required

  1.4.2 Stable Available Dec 26, 2025 · 0

  Download

  File size: 44.1 KB

  SHA-256: c0b63ec0af1db70c0c3972efcddd37e72864faa96b8a33b699469d737e157ef3

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  No longer requires the Bridge addon.
  
  You can uninstall the Bridge addon if you have it installed

  1.4.1 Stable Available Dec 25, 2025 · 0

  Download

  File size: 39.1 KB

  SHA-256: 0a85fbafea5aabd86e60438a5878f6bf0cf1c98e28d1a0620b7a0b30be1c9871

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  View attachment 2547​

  
  

  Mitch Referrals

  Turn your members into your best promoters
  
  Growing a forum is hard. Keeping it growing is even harder.
  Mitch Referrals gives your community an easy, powerful way to spread the word — and gives you clear insight into what's actually working.
  
  No gimmicks. No hacks. Just a clean referral system built the XenForo way.
  
  

  ---

  
  

  Simple referral links (that just work)

  
  Every member gets a unique referral code they can share anywhere using links like:
  
  ?ref=ABC123
  
  ✔ No pretty URLs required
  ✔ No URL clutter
  ✔ No core file edits
  
  When someone visits using a referral link, Mitch Referrals:
  

  • Tracks the click
  • Stores attribution securely via cookie
  • Automatically cleans the URL to prevent double-counting
  • Credits referrals only when a registration is completed

  Fair, accurate, and abuse-resistant by design.
  
  

  ---

  
  

  Share the

  
  Why send everyone to the homepage?
  
  With Mitch Referrals, members can generate referral links for any page on your site, including:
  

  • Forum threads
  • Categories
  • Resources
  • The homepage
  • Custom landing pages

  From the affiliate dashboard, members can paste any internal URL (or relative path) and instantly generate a referral-enabled version. This lets them share the content that actually convinced them — which means better engagement and better signups.
  
  Bonus: the optional sidebar widget automatically creates a referral link for the page the user is currently viewing, making organic sharing effortless.
  
  

  ---

  
  

  Everything members need, in one place

  
  Each member gets a clean, easy-to-use affiliate dashboard where they can:
  

  • View their referral code
  • Copy referral links with one click
  • Generate referral links for specific pages
  • Track total clicks and unique clicks
  • See how many users registered through their links
  • View recent referral activity

  It feels native. It looks native. Because it is native.
  
  

  ---

  
  

  Clear insight for admins (without the noise)

  
  Admins get a dedicated stats page that shows:
  

  • Top referrers
  • Click totals and unique clicks
  • Registration counts
  • Conversion performance over time

  Plus a focused set of admin options:
  

  • Referral cookie lifetime
  • Unique click tracking window
  • Enable/disable click tracking
  • Control whether referral cookies can be overwritten

  No bloated settings pages. Just the controls that matter.
  
  

  ---

  
  

  Built the XenForo way

  
  Mitch Referrals is built specifically for XenForo 2.3.x and follows best practices:
  
  ✔ No core edits
  ✔ No URL rewriting
  ✔ Uses native entities, listeners, widgets, and templates
  ✔ Safe for live production sites
  ✔ Fully dev-mode exportable
  
  Install it, turn it on, and let your members do what they already do best — talk about your community.
  
  

  ---

  
  

  Designed to grow with you

  
  Mitch Referrals is intentionally lightweight, but built on a solid foundation. It's ready today for:
  

  • Organic community growth
  • Member-driven promotion
  • Content-specific referrals

  And it's structured to support future upgrades like:
  

  • Referral rewards
  • Paid upgrade commissions
  • Leaderboards
  • Trophy or badge integration

  ---

  
  

  In short

  
  If you want a referral system that:
  

  • Feels native to XenForo
  • Empowers your members
  • Tracks real results
  • Avoids common abuse pitfalls
  • And leaves room to grow

  Mitch Referrals has you covered.
• Discussion

  This resource has a discussion thread on the forum where you can ask questions, report issues, and talk with the author and other users.

  Join the discussion (9)