Listener Support Hooks and Shortcode Reference
Developer reference for the Listener Support system. Full documentation for each hook and shortcode — parameters, return types, and usage examples — lives in the dedicated CPT entries linked below.
Filters
| Hook | Description |
|---|---|
benecaster_listener_support_enabled |
Controls whether the Listener Support prompt renders for the current request. Return false to suppress. |
benecaster_listener_support_output |
Filters the fully rendered HTML of a Listener Support variant before it is returned to the caller. |
benecaster_listener_support_button_label |
Filters the button label text. |
benecaster_listener_support_message |
Filters the message body text. Returning an empty string hides the message element. |
benecaster_listener_support_button_position |
Filters the corner anchor for the floating-button variant. Accepts bottom-right, bottom-left, top-right, top-left. |
Actions
| Hook | Description |
|---|---|
benecaster_listener_support_donation_logged |
Fires after a donation reference row is written. Use to sync records to a CRM, send a Slack notification, or trigger any follow-up process. |
Shortcode
| Shortcode | Description |
|---|---|
[[benecaster_listener_support]](/shortcodes/benecaster-listener-support/) |
Renders a Listener Support prompt. Supports link-mode and Stripe-mode styles. Available on all plans including free. |