Documentation
LiteShoper Affiliate Plugin — Full Guide
On this page
- Overview
- Installation
- Settings
- Referral tracking
- Commissions
- Payouts
- Tutorial
- Affiliate dashboard
- Troubleshooting
Overview
LiteShoper Affiliate (liteshop-affiliate) adds a full referral program. Affiliates share tracked links, earn commissions on sales, and request payouts from a dedicated dashboard.
Installation
- Purchase license → install from marketplace.
- Configure Affiliate → Settings before promoting the program.
Settings
Admin: Affiliate → Settings
| Setting | Description |
|---|---|
| Default commission rate | e.g. 5% of order subtotal |
| Cookie days | Attribution window (default 30) |
| Award status | Approve on confirmed or shipped |
| Min payout | Minimum balance to request withdrawal |
| Include shipping/tax | Whether commission base includes these |
| Auto-approve days | Auto-approve pending commissions after N days (0 = immediate when status met) |
| Block self-referral | Prevent affiliates earning on own orders |
Referral tracking
Affiliate links use ?ref=AFFILIATE_CODE on any store or product URL.
Example: https://your-store.com/product/widget?ref=JANE2024
Cookie name: liteshop_aff_ref
Commissions
- Created on
order_createdas pending - Approved when order reaches configured status (confirmed/shipped)
- Per-product rules override default rate (percent or fixed)
- Cancelled orders reverse commissions
Admin: Affiliate → Commissions
Payouts
- Affiliate requests payout from
/account/affiliate - Admin reviews under Affiliate → Payouts
- Mark paid (upload receipt: JPG, PNG, GIF, WebP, PDF) or reject
Tutorial
- Set 10% default commission, 30-day cookie.
- Approve a test affiliate account.
- Open affiliate link in incognito → purchase product.
- Confirm commission pending → complete payment → commission approved.
- Process test payout.
Affiliate dashboard
/account/affiliate — apply, view stats, copy links, request payouts.
Active affiliates see a share box on product pages.
Troubleshooting
- No commission — cookie blocked, self-referral blocked, or affiliate inactive
- Receipt upload failed — use allowed image/PDF formats only
- Program not available — affiliate_enabled off