Solid Affiliate – New Affiliate Tigger

Tech Articles | May 15, 2025 | Automation, Blog, Bubble, FlowMattic, WooCommerce, Wordpress

Following a question about Solid Affiliate Triggers in the Flowmattic Facebook group, I set about looking at what was available to notify about A new affiliate sign-up and also an affiliate referral.

I initially settled on solid_affiliate_trigger_new_referral and Solid_affiliate/Affiliate/new_registration/success As my chosen action hooks, but on trying with solid_affiliate/Affiliate/new_registration/success I was having intermittent success; it would only trigger on the frontend, not the backend, and I’d still need to look up the data again.

I haven’t tested solid_affiliate_trigger_new_referralBut I see no reason this shouldn’t work. For the rest of the article, I am going to work on an alternative to Solid_affiliate/Affiliate/new_registration/success and explain how I came about a working version.

Initial Failure

Following the initial failure, I experienced with Solid_affiliate/Affiliate/new_registration/success, I decided to see what fires in general when I add a new affiliate and see if there was something more suitable to use in that case.

So I set about adding a snippet to record to my debug log every Solid Affiliate Action when I navigate and create an affiliate using the below snippet.

// Ensure plugin is available
if ( ! function_exists( 'is_plugin_active' ) ) {
    require_once ABSPATH . 'wp-admin/includes/plugin.php';
}

// Only activate if Solid Affiliate is active
if ( is_plugin_active( 'solid_affiliate/plugin.php' ) ) {

    // Listen on *all* hooks with a very early priority
    add_action( 'all', function( $hook_name, $arg1 = null ) {
        // Only log Solid Affiliate hooks
        if ( strpos( $hook_name, 'solid_affiliate' ) === 0 || strpos( $hook_name, 'data_model_' ) === 0 ) {
            //
            if ( defined( 'WP_DEBUG' ) && WP_DEBUG && defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG ) {
                $args = func_get_args();
                // Remove the hook name from args list
                array_shift( $args );
                error_log( sprintf(
                    '[SolidAFF-] Hook fired: %s, args: %s',
                    $hook_name,
                    print_r( $args, true )
                ) );
            }
        }
    }, 0 );
}

PHP

This gave me a lot of data, a very small extract is below

Another Swing and a Miss!

So I settled on data_model_solid_affiliate_affiliates and ran that, but immediately, it was clear we where getting about four triggers per addition, so looking through my logs and applying some logic was needed. I had the following triggers available to me

data_model_solid_affiliate_affiliates_inserted

data_model_solid_affiliate_affiliates_updated

data_model_solid_affiliate_affiliates_save

I decided that by targeting the _inserted one, I would get exactly one call when a brand‐new affiliate record is created. i.e an insertion

This worked as planned. We now successfully get data, but it’s not the format I wanted for FlowMattic.

Finishing Off

So now that I had the data, I worked on the array and wanted to add a separate action to fire that could be captured in flowmattic. The reason for this was so we could use the plugin or WordPress action trigger and not have separate webhook triggers.

I settled on the following snippet to capture, lookup and pull the data and pass it to the action hook.

// Ensure is_plugin_active() is available
if ( ! function_exists( 'is_plugin_active' ) ) {
    require_once ABSPATH . 'wp-admin/includes/plugin.php';
}

// Only hook if Solid Affiliate is active
if ( is_plugin_active( 'solid_affiliate/plugin.php' ) ) {

    // Fires exactly once when a new affiliate record is inserted
    add_action(
        'data_model_solid_affiliate_affiliates_inserted',
        'sat_trigger_custom_affiliate_action',
        10,
        1
    );
}

/**
 * Fires a custom action passing a named array of affiliate data.
 *
 * @param SolidAffiliate\Models\Affiliate $affiliate_obj
 */
function sat_trigger_custom_affiliate_action( $affiliate_obj ) {
    // Pull protected attributes via magic getter
    if ( method_exists( $affiliate_obj, '__get' ) ) {
        $data = $affiliate_obj->__get( 'attributes' );
    } else {
        $data = [];
    }

    /**
     * Fires after a Solid Affiliate record is inserted,
     * passing a named array for easy mapping.
     *
     * @param array $data {
     *   @type int    $id
     *   @type int    $user_id
     *   @type int    $affiliate_group_id
     *   @type string $commission_type
     *   @type float  $commission_rate
     *   @type string $payment_email
     *   @type string $mailchimp_user_id
     *   @type string $first_name
     *   @type string $last_name
     *   @type string $registration_notes
     *   @type string $status
     *   @type string $custom_registration_data
     *   @type string $created_at
     *   @type string $updated_at
     * }
     */
    do_action( 'sa_aff_created_trigger', $data );
}

PHP

so our trigger becomes sa_aff_created_trigger in FlowMattic, as can be seen below

We get the following data in flowmattic for that signup.

You can view the bubble below to see this in action:

Support the Author

Appoligies for any spelling and grammer issue. As a dyslexic i need to rely on tools for this they like me are not perfect but I do try my best