benecaster_promote_grace_extended
Fires after a podcaster manually extends a transferred subscriber’s grace period from the Promotion History panel.
The old deadline and the new one arrive by different routes. $promotion is the row as it was before the extension, so $promotion['promote_grace_period_ends_at'] is still the old date; the new one is the third argument. Reading both is what lets a listener report the change rather than just the result.
$new_expiry_ts is a UTC Unix timestamp, not a formatted string — deliberately, so there is no clock to mistake and no format to parse.
Does not fire on a failed write, when no subscription has that id, or when the row has no grace period to extend.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$promotion |
array |
— | The subscription row as it stood immediately before the extension. `promote_grace_period_ends_at` is the deadline being replaced. |
$user_id |
int |
— | Subscriber's WordPress user ID. Also present in `$promotion`. |
$new_expiry_ts |
int |
— | The new grace-period deadline as a UTC Unix timestamp. |
Need this built rather than just documented? See our services →