Custom Affiliate & Referral System for WooCommerce
A production-ready affiliate, referral tracking, and commission management system for WooCommerce with HPOS support.
by Nadeem · github.com/aimal-dev/affiliatewp---affiliate-plugin-for-wordpress · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/aimal-dev/affiliatewp---affiliate-plugin-for-wordpress/archive/refs/heads/main.zipReadme
=== Custom Affiliate & Referral System for WooCommerce === Contributors: nadeem Tags: woocommerce, affiliate, referral, commissions, payouts, hpos Requires at least: 6.0 Tested up to: 6.7 Requires PHP: 8.1 Stable tag: 1.0.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html
A production-ready affiliate, referral tracking, and commission management system for WooCommerce with HPOS support.
== Description ==
Custom Affiliate & Referral System for WooCommerce allows registered users and store customers to become affiliates, generate referral links, track visits and WooCommerce purchases, calculate commissions, and receive payouts.
Key Features
- WooCommerce HPOS Support: High-Performance Order Storage compatible.
- Affiliate Referral Tracking: First-party cookie tracking with configurable duration (default 30 days) and custom query parameters.
- Smart Commission Engine: Percentage or Fixed commissions with support for custom affiliate-specific commission rates.
- Order Status Sync: Commissions automatically transition from Pending to Approved when orders reach designated statuses (e.g. Completed).
- Refund Handling: Full refund reversals and proportional partial refund adjustments with complete audit trails.
- Anti-Fraud: Self-referral prevention (blocks affiliates from earning on their own customer ID and billing email) and duplicate commission prevention.
- Interactive Setup Wizard: 5-step onboarding guide to configure tracking, commissions, payouts, and auto-generate the affiliate dashboard page.
- Modern Responsive Dashboard: Frontend portal for affiliates with 1-click link copying, Web Share API, statistics, commission logs, and payout settings.
- WooCommerce My Account Tab: Seamless integration into the customer's My Account area under "Affiliate Area".
== Installation ==
- Upload the
custom-affiliate.zipplugin file via WordPress Admin → Plugins → Add New → Upload Plugin. - Click Activate.
- Go to Affiliate System → Setup Wizard to follow the 5-step onboarding guide.
- (Optional) Insert the
[affiliate_dashboard]shortcode onto any page if you prefer a custom URL.
== Shortcodes ==
[affiliate_dashboard]- Full interactive affiliate dashboard portal.[affiliate_registration]- Standalone affiliate registration form.[affiliate_referral_link]- Displays the logged-in affiliate's referral URL with copy button.[affiliate_stats]- Displays quick KPI metric cards (Clicks, Orders, Conversion Rate, Available Balance).[affiliate_commissions]- Displays the affiliate's commissions and referral orders table.
== Changelog ==
= 1.0.0 =
- Initial production release.