benecaster_promote_grace_expired
Fires when a subscriber’s promote-to-bridge grace period expires without them completing setup in the destination membership plugin. By the time this runs their feed token has already been revoked and the expiry email has been queued, so do not assume they still have access.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$user_id |
int |
— | The subscriber whose grace period expired. Their token for this show has already been revoked by the time this fires. |
$show_id |
int |
— | The show they were promoted away from. |
$tier_slug |
string |
— | The tier they held on the Benecaster side before the promotion. |
Example
add_action( 'benecaster_promote_grace_expired', function ( int $user_id, int $show_id, string $tier_slug ): void {
// Access is ALREADY revoked here -- this is a notification, not a veto
// point. To stop a revocation, use benecaster_promote_grace_expiry_should_revoke.
my_crm_tag_lapsed_promotion( $user_id, $show_id, $tier_slug );
}, 10, 3 );
Notes
⚠ Fires AFTER the token is revoked, not before. The subscriber has already lost access by the time a callback runs, and the expiry email has already been sent. This is a notification point, not a decision point.
To veto a revocation, use benecaster_promote_grace_expiry_should_revoke instead — it runs first and a callback returning anything other than boolean true stops the revocation.
The subscriber reached this state by not completing setup in the destination membership plugin before their grace period ran out, so the useful reaction is usually outreach rather than cleanup.
Need this built rather than just documented? See our services →