Guides
Practical guides for extending and customizing FluentAffiliate.
Getting Started
Custom Integration Guide
Build a complete e-commerce or booking integration using the BaseConnector + BaseConnectorSettings two-class pattern. Covers the full referral lifecycle — order events, commission calculation, customer records, self-referral prevention, and refund handling.
Code Snippets
Source-verified, ready-to-use PHP snippets for the most common customization tasks: auto-approving affiliates, capping commissions, sending custom notifications, modifying portal menus, and more.
Pro Features
Affiliate Groups
Segment affiliates into groups with custom commission rates. Groups are stored in fa_meta with per-group rate_type, rate, and status. Includes REST API, lifecycle hooks, and programmatic usage.
Creatives
Manage affiliate marketing assets — banners, images, text links, HTML — with scheduling (WP Action Scheduler), affiliate/group targeting, and portal display filtering.
Social Media Share
Configure the affiliate portal's social sharing widget. 8 built-in platforms, developer filters to add custom platforms, and feature settings hooks.
Permission Manager
Grant non-admin WordPress users granular access to FluentAffiliate data — view affiliates, manage referrals, process payouts — without full admin access.
Connected Sites / Multi-Domain
Track affiliates across multiple WordPress sites. Token-based cross-site authentication with a single affiliate dashboard on the primary site.
Recurring Commissions
Automatically pay affiliates for subscription renewals. WooCommerce Subscriptions and FluentCart recurring payments supported. Per-group recurring rate overrides.
Integrations
| Integration | Type | Description |
|---|---|---|
| WooCommerce | Pro | Orders, subscriptions, coupon mapping, My Account menu. |
| Easy Digital Downloads | Pro | EDD payment commissions. |
| SureCart | Pro | SureCart orders and subscriptions. |
| FluentCart | Core | FluentCart orders and subscriptions. |
| Fluent Forms | Core | Affiliate registration via form feed. |
| LifterLMS | Pro | Course and membership commissions. |
| GiveWP | Pro | Donation commissions. |
| MemberPress | Pro | Membership purchase commissions. |
| Paid Memberships Pro | Pro | PMP order commissions. |
| TutorLMS | Pro | Course purchase commissions (Pro version required). |
| ProfilePress | Pro | Membership plan commissions. |
| Paymattic | Pro | Payment form commissions and registration feed. |
| FluentBooking | Pro | Booking payment commissions. |
| Voxel | Pro | Marketplace transaction commissions. |
Where to Add Custom Code
Add customizations to a custom plugin or an MU plugin (wp-content/mu-plugins/). Avoid editing FluentAffiliate directly — your changes will be overwritten on plugin updates.
<?php
/**
* Plugin Name: My FluentAffiliate Customizations
* Description: Custom hooks and modifications for FluentAffiliate.
* Version: 1.0.0
*/
defined('ABSPATH') || exit;
add_action('plugins_loaded', function () {
if (!defined('FLUENT_AFFILIATE_VERSION')) {
return; // FluentAffiliate not active
}
// Your customizations here
});