Xtreme Referrals Documentation
In ReviewAffiliate referral system for WooCommerce — tracks coupon codes and links, calculates commissions, manages payouts.
Need help? File a support ticket.
Installation
Tip: this plugin is currently in WordPress.org review. Until the listing goes live, grab the latest zip from xtremeplugins.com/download/ and upload it via Plugins → Add New → Upload Plugin.
Xtreme Referrals depends on WooCommerce 7+. Install WooCommerce first, then upload the Xtreme Referrals zip via Plugins → Add New → Upload Plugin and activate. The activator creates four custom tables (affiliates, referrals, payouts, clicks), registers the Affiliate user role, and auto-publishes the portal and login pages with their default shortcodes.
Detailed installation guide — coming soon.
Configuration
Open Xtreme Referrals → Settings:
- Commission — flat or percentage rate, plus optional tiered rates by affiliate.
- Cookie — referral cookie lifetime in days.
- Payouts — minimum payout threshold, PayPal / Stripe Connect credentials.
- Exclusions — products and categories ineligible for commission.
- Emails — affiliate welcome, referral confirmation, payout notification.
- Portal pages — choose which WordPress pages host the affiliate portal, login, and register shortcodes.
Field-by-field reference — coming soon.
Shortcodes & Blocks
Three shortcodes power the affiliate-facing pages:
[xtreme_referrals]— the main affiliate portal (stats, link generator, payout request, history).[xtreme_referrals_login]— affiliate login form.[xtreme_referrals_register]— affiliate self-registration form (creates a user with thexrefs_affiliaterole).
The activator auto-publishes these pages on first activation; the IDs are stored in plugin options so you can reassign them later.
Troubleshooting
A completed order didn't record a referral. Referrals only attach to orders that either applied the affiliate's coupon code OR were placed by a visitor whose referral cookie was still valid. Confirm one of those is true and that the order is in Completed status (the recording hook runs on woocommerce_order_status_completed).
Affiliate portal redirects to login in a loop. The user account exists but the xrefs_affiliate role is missing — usually because a role-management plugin stripped it. Re-add the role from Users and the portal will load.
Payout request button is missing. The affiliate's available balance is below the minimum threshold set in plugin settings. Lower the threshold or wait for more eligible referrals.
Still stuck? File a support ticket.
FAQ
Does Xtreme Referrals require WooCommerce?
Yes. Commissions are calculated from completed WooCommerce orders, and each affiliate is automatically issued a WooCommerce coupon that doubles as their tracking code.
How are commissions tracked?
Two ways: by referral link (a cookie is set when a visitor lands via an affiliate URL) and by coupon code (any order that applies the affiliate's coupon counts as a referral).
Can affiliates request payouts themselves?
Yes. The affiliate portal includes a request-payout button once the affiliate's balance meets the minimum threshold you set in plugin settings.
What payout methods are supported?
PayPal and Stripe Connect are supported out of the box. Bank transfer is handled as a manual mark-as-paid action.
Can I exclude certain products from earning commission?
Yes. The settings screen lets you blacklist specific product IDs or entire product categories. Commissions are calculated only on the eligible line items.