Admin Configuration

Configure the referral system from the admin panel.

Accessing Settings

Navigate to Admin > Referrals

Configuration Options

Signup Bonus

• Amount — Fixed bonus for each qualified referral
• Default: 0
• Example: Set to 5 to award $5 per signup

Commission Settings

• Commission Percent — Percentage of referred user's order

• Default: 5%

• Example: Set to 10 for 10% commission

• Commission Cap — Maximum commission per order

• Default: 0 (uncapped)

• Example: Set to 50 to cap at $50

Attribution Window

• Days — How long referral is tracked after click
• Default: 7 days
• Range: 1-30 days

Managing Referrals

View All Referrals

Navigate to Admin > Referrals

• See all referral relationships
• View status (pending/qualified/rewarded)
• Track earnings per referral

View Rewards

Navigate to Admin > Referrals > Rewards

• See all earned rewards
• Filter by status (earned/paid)
• Export for payment processing

CLI Management

Use the command line for advanced management:

# Initialize referrals system
php bin/referrals init

# View configuration
php bin/referrals config

# View all referral links
php bin/referrals links

# View statistics
php bin/referrals stats

# View rewards
php bin/referrals rewards

# Process payments
php bin/referrals pay

Best Practices

1. Set competitive rates — Attract active referrers
2. Use caps wisely — Prevent excessive payouts
3. Monitor activity — Watch for fraud patterns
4. Process payments — Pay rewards promptly
5. Communicate — Keep referrers informed

Troubleshooting

Referrals Not Tracking

• Verify plugin is activated
• Check cookie settings
• Clear browser cache

Bonuses Not Credited

• Verify email verification completed
• Check signup bonus amount
• Review referral status

Commission Not Earned

• Verify order was paid
• Check commission settings
• Review referral status

Last updated: September 2026