Code Snippets

TIP

These snippets are validated against the current core and Pro source trees. Add them to a custom plugin or an MU plugin rather than editing FluentAffiliate directly.

Auto-Approve New Affiliates

Automatically approve all new affiliate applications without manual review.

add_filter('fluent_affiliate/auth/auto_approve_affiliates', '__return_true');

Redirect Affiliates After Login

Send affiliates to a custom URL after they log in to the portal.

add_filter('fluent_affiliate/auth/after_login_redirect_url', function ($redirectUrl, $user) {
    return home_url('/affiliate-dashboard/');
}, 10, 2);

Add a Custom Portal Menu Item

Append a menu item to the affiliate portal navigation.

add_filter('fluent_affiliate/portal_menu_items', function ($menuItems) {
    $menuItems[] = [
        'key'   => 'resources',
        'label' => 'Resources',
        'icon'  => 'el-icon-document',
        'route' => 'resources',
    ];
    return $menuItems;
}, 10, 1);

Customize the Pending Affiliate Message

Override the message shown to affiliates whose application is still pending.

add_filter('fluent_affiliate/portal/pending_message', function ($html, $affiliate) {
    return '<p>Your application is under review. We will contact you within 2 business days.</p>';
}, 10, 2);

Cap Commission at a Maximum Amount

Prevent commission from exceeding a fixed ceiling regardless of order size.

add_filter('fluent_affiliate/commission', function ($commission, $context) {
    return min($commission, 100.00); // Cap at $100
}, 10, 2);

Record Zero-Amount Referrals

By default, FluentAffiliate skips referrals where the calculated commission is zero. Remove this guard to record all conversions regardless of commission value.

add_filter('fluent_affiliate/ignore_zero_amount_referral', '__return_false');

Add Custom Data to the Admin SPA

Inject custom variables into the admin SPA's global JavaScript object.

add_filter('fluent_affiliate/admin_vars', function ($vars) {
    $vars['my_plugin_enabled'] = defined('MY_PLUGIN_VERSION');
    return $vars;
});

Limit Data Export Rows

Override the maximum number of rows returned by CSV export endpoints.

add_filter('fluent_affiliate/data_export_limit', function ($limit) {
    return 2000;
});

Change the Referral Share Base URL

Override the default URL that affiliates share. Useful when your shop is on a different path.

add_filter('fluent_affiliate/default_share_url', function ($url, $affiliate) {
    return 'https://yoursite.com/shop/';
}, 10, 2);

Use a Custom Avatar URL

Replace the default Gravatar URL with a custom avatar from your own system.

add_filter('fluent_affiliate/affiliate_avatar', function ($gravatarUrl, $email) {
    $custom = my_plugin_get_avatar($email);
    return $custom ?: $gravatarUrl;
}, 10, 2);

Send a Notification on Referral Approval

Fire a custom email when a referral is approved and moves to unpaid status.

add_action('fluent_affiliate/referral_marked_unpaid', function ($referral) {
    $affiliate = $referral->affiliate;
    if (!$affiliate) {
        return;
    }
    $wpUser = get_user_by('id', $affiliate->user_id);
    if (!$wpUser) {
        return;
    }
    wp_mail(
        $wpUser->user_email,
        'Your referral has been approved',
        'A referral commission of ' . $referral->amount . ' has been approved.'
    );
}, 10, 1);

Check if Pro is Active

Guard Pro-only code paths behind a constant check.

if (defined('FLUENT_AFFILIATE_PRO')) {
    // Pro features are available
}

Grant Affiliate-Level Access to a Role

Allow a specific WordPress role to access FluentAffiliate admin data without being an administrator.

add_filter('fluent_affiliate/has_all_affiliate_access', function ($hasAccess) {
    if (current_user_can('editor')) {
        return true;
    }
    return $hasAccess;
});

Skip a Referral Before It Is Recorded

recordReferral() runs every incoming referral payload through fluent_affiliate/referral_data, then drops zero-amount sales unless fluent_affiliate/ignore_zero_amount_referral says otherwise. Zeroing the amount is the supported way to suppress a referral for orders you don't want to commission.

add_filter('fluent_affiliate/referral_data', function ($data, $provider) {
    if ($provider !== 'woo') {
        return $data;
    }

    $order = wc_get_order($data['provider_id'] ?? 0);
    if (!$order) {
        return $data;
    }

    foreach ($order->get_items() as $item) {
        if (has_term('gift-cards', 'product_cat', $item->get_product_id())) {
            $data['amount'] = 0; // dropped by the zero-amount guard
            break;
        }
    }

    return $data;
}, 10, 2);

Change the Referral Cookie Duration Default

Cookie lifetime comes from the cookie_duration referral setting (days, default 30). Filter the defaults to change what an unconfigured site uses:

add_filter('fluent_affiliate/default_referral_settings', function ($settings) {
    $settings['cookie_duration'] = 60;
    return $settings;
});

The public tracker script reads the same value as duration_days, which you can override independently:

add_filter('fluent_affiliate_tracker_vars', function ($vars) {
    $vars['duration_days'] = 60;
    return $vars;
});

Log Referral Creation for Debugging

Hook into the referral created action to log data to a custom table or external service.

add_action('fluent_affiliate/referral_created', function ($referral) {
    error_log(sprintf(
        '[FluentAffiliate] Referral #%d created — affiliate #%d, amount %s, provider %s',
        $referral->id,
        $referral->affiliate_id,
        $referral->amount,
        $referral->provider
    ));
}, 10, 1);