Skip to main content

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_fired and benecaster_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 →