benecaster_promote_grace_cleared
Fires after a podcaster manually clears a transferred subscriber’s grace period from the Promotion History panel — the operator confirming that the subscriber re-authorized payment in the destination membership plugin. Clearing removes the grace marker and re-enables the subscriber’s feed token.
$promotion is the row as it was BEFORE the clear, and that is the only reason it is useful. Clearing nulls both promote_grace_period_ends_at and promoted_to_bridge, so a listener that re-read the row would find two nulls and would have lost the two facts worth reacting to: which bridge the subscriber was moved to, and what deadline was cancelled.
Does not fire on a failed write, and does not fire when no subscription has that id. A grace period that simply runs out is not this event — that is benecaster_promote_grace_expired.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$promotion |
array |
— | The subscription row as it stood immediately before clearing, hydrated by `SubscriptionRepository`. Includes `promote_grace_period_ends_at` (the deadline being cancelled) and `promoted_to_bridge` (the destination), both of which are null on the stored row afterwards. |
$user_id |
int |
— | Subscriber's WordPress user ID. Also present in `$promotion`. |
Need this built rather than just documented? See our services →