Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/aimal-dev/affiliatewp---affiliate-plugin-for-wordpress/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
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.