Mitch Referrals 1.5.2

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.

🧠 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

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

This release focuses on affiliate usability, promotion tools, and system reliability, laying the groundwork for future enhancements like media uploads and advanced banner analytics.

Companion Top Referrers Widget added

Updated several files and made the system more stable