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.

FluentCRM Integration

Automation triggers and actions, the affiliate CRM profile card (tag/list management from the affiliate screen), smart codes, contact import, and advanced filters.

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.

Custom Registration Fields

Add custom fields to the affiliate registration form. Eight field types, values stored in the fa_affiliates.custom_fields JSON column, with validation and portal profile support.

Captcha

Protect the registration form with Google reCAPTCHA v2/v3 — validated-keys-before-save gate, encrypted secrets, and a pluggable provider layer.

---

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
});