License Events Actions
Actions for License Events. Every other area is listed on the Action Hooks Reference. Each name links to its own page, with its parameters, notes and an example.
Fire as the daily license validation cron runs — successful validation, explicit rejection, an unreachable server, the payment-failed grace window, and the hard limit reached after sustained failures.
(All hooks in this section are Premium — fire only on paid plans or when license validation runs — except the two marked Free)
The daily run validates each connected show in turn. Hooks that report one validation end with a $show_uuid argument naming that show; pass it to benecaster_get_license_plan() when you read the license back. The two day-30 cutoff hooks end with $show_uuids instead, every connected show on the license that was cut off. A listener registered for fewer arguments keeps working.
| Hook | Description |
|---|---|
benecaster_license_validated |
Fires when the daily validation cron receives a valid response from the license server; receives $response (array), $show_uuid (string) |
benecaster_license_invalid |
Fires when validation returns an explicit rejection (status: "invalid") from a reachable server; receives $response (array), $show_uuid (string) |
benecaster_license_plan_changed |
Free. Fires when a validation changes the cached plan, and only then; receives $from (string), $to (string), $show_uuid (string) |
benecaster_license_expiring |
Fires on each validation while the license is within 30 days of expiry; receives $days_remaining (int), $expires_at (string), $show_uuid (string) |
benecaster_over_limit_flags_evaluated |
Free. Fires after each validation once subscribers over the plan’s limits are flagged; receives $count (int), $ids (int[]), $show_uuid (string) |
benecaster_license_grace_started |
Fires when a failed payment opens the 30-day grace window; receives $started_at (int), $reason (string), $show_uuid (string) |
benecaster_license_payment_grace_hard_cutoff |
Fires once on day 30 of an unpaid grace window, when subscriber access is cut off; receives $cutoff_at (int), $token_count (int), $show_uuids (string[]) |
benecaster_license_grace_expired |
Fires straight after the day-30 cutoff, for older listeners; receives $started_at (int), $show_uuids (string[]) |
benecaster_license_grace_recovered |
Fires when the license goes valid again and closes a grace window; receives $started_at (int), $duration_seconds (int), $show_uuid (string) |
benecaster_license_payment_grace_recovered |
Fires when a recovery lifts a day-30 cutoff and restores subscriber access; receives $restored_count (int), $started_at (int), $show_uuid (string) |
benecaster_validation_failure |
Fires every day the license server is unreachable; passes the cumulative consecutive failure day count |
benecaster_license_hard_limit_reached |
Fires after 30 consecutive days of server-unreachable failures; premium features are restricted until the next successful validation |
benecaster_license_free_threshold_warning |
Fires when a site’s paying subscriber count reaches 80% of its plan’s limit, at most once per calendar month. A notice cadence, not a plan-change signal |
Seven license-enforcement action names do not exist in Benecaster and never fire:
benecaster_license_overage_month_1,_month_2,_cleared,benecaster_license_free_bump_confirmed,benecaster_license_downgrade_locked,benecaster_license_auto_upgrade_firedandbenecaster_license_downgrade_lock_expired. They are named here because a callback attached to one of them simply never runs — nothing errors — so a license hook that seems dead is worth checking against this page. The premises they describe are not how licensing works: overage is counted on a rolling window held by the license server, which the plugin cannot see, and there is no downgrade lock.
See Also
Need this built rather than just documented? See our services →