benecaster_subscriber_never_accessed_grace_days
Filters how many days must pass after a subscriber is given their feed link before a link that has never been polled qualifies for the never_accessed transition on a given show. Default: 7. Asked once per show on each daily run, so the window can differ per show.
The window can be raised or lowered. A value below 0 is treated as 0, which flags a never-polled link on the next daily run.
Widen it where subscribers are slow to onboard by nature — annual plans, corporate rollouts, an audience that signs up in a burst around a launch. Tighten it where onboarding is fast and a week of silence already means something went wrong.
Governs benecaster_subscriber_never_accessed and the Never set up segment on the subscribers list.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$days |
int |
— | The current grace window in days. `7` unless already filtered. |
$show_id |
int |
— | ID of the show the token belongs to, so the window can vary per show. |
Returns:
int
Examples
Give annual subscribers on one show three weeks to get set up
add_filter( 'benecaster_subscriber_never_accessed_grace_days', function ( int $days, int $show_id ): int {
// Show 12 sells annual plans; subscribers often set up weeks later.
return 12 === $show_id ? 21 : $days;
}, 10, 2 );Notes
The engagement check runs on WP-Cron, which fires on site traffic, so on a quiet site the transition can lag whatever window you set.
Need this built rather than just documented? See our services →