Skip to main content

benecaster_license_free_bump_triggered

Removed. This action no longer fires. It was removed in the feature/launch-tier-cleanup batch when the automatic server-side Launch → Starter upgrade was replaced with a customer-initiated checkout flow. Use [benecaster_license_free_bump_confirmed](/docs/benecaster_license_free_bump_confirmed/) to detect when a customer upgrades from Launch to a paid plan.

Fires the first time a Launch-plan site’s paying subscriber count exceeds 10. An end-of-period Starter upgrade has been scheduled on the license server.

Access: Premium
Since: 1.0.0


Parameters

Parameter Type Description
$count int Current paying subscriber count

When It Fires

Fires inside TierUpgradeManager during daily validation when:

  1. The current license plan is 'launch' (free tier)
  2. The paying subscriber count exceeds 10 for the first time

“First time” is enforced by a local benecaster_free_bump_scheduled option flag. Once set, this hook will not fire again until a benecaster_license_free_bump_confirmed resets the state.

After this hook fires, the license server will charge the card on file and upgrade the license to Starter at the end of the current billing period. No billing action occurs in the plugin itself.


Example Usage

// Send an internal notification when a Launch-plan upgrade is triggered
add_action( 'benecaster_license_free_bump_triggered', function( int $count ): void {
    wp_mail(
        'ops@example.com',
        'Benecaster: Starter upgrade scheduled',
        sprintf(
            'The Launch plan on %s has reached %d paying subscribers. ' .
            'An upgrade to Starter has been scheduled on the license server.',
            home_url(),
            $count
        )
    );
} );

See Also