benecaster_locked_content_message
Filters the message displayed when content is locked. Use to create custom upgrade prompts — for example, free tier subscribers see ‘Subscribe to listen’ while lower paid tiers see ‘Upgrade to Premium for early access.’
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$message |
string |
— | Locked content message HTML |
$episode_id |
int |
— | ID of the episode |
$required_tier |
string |
— | Tier slug required to access the content |
$user_tier |
string|null |
— | Current user's tier slug; null if not subscribed |
Returns:
string
Example
add_filter( 'benecaster_locked_content_message', function( $message, $episode_id, $required_tier, $user_tier ) {
// Show a tier-specific upgrade prompt.
if ( 'follower' === $user_tier && 'premium' === $required_tier ) {
return '<p>Upgrade to Premium to unlock early access and bonus episodes.</p>';
}
if ( null === $user_tier ) {
return '<p>Subscribe to listen to this episode.</p>';
}
return $message;
}, 10, 4 );
