benecaster_license_free_bump_triggered
Removed. This action no longer fires. It was removed in the
feature/launch-tier-cleanupbatch 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:
- The current license plan is
'launch'(free tier) - 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
)
);
} );
Related
benecaster_license_free_threshold_warning— fires at 8 subscribers (warning before the limit)benecaster_license_free_bump_confirmed— fires when the Starter upgrade is confirmedbenecaster_license_downgrade_lock_expired— fires 30 days after the bump is confirmed