Action Hooks Reference
All action hooks provided by Benecaster. Each area below has its own page, and each hook name there links to its reference page with full parameter docs, usage notes, and code examples.
Hooks are not a paid feature — we don’t charge for them and none of them is gated behind a purchase. Hooks marked Premium sit on code paths that only run on a licensed install, so on an unlicensed site they simply never fire; there is nothing for them to act on. Everything else fires on any install.
The number after each area is how many actions it lists.
Benecaster
| Area | What it covers |
|---|---|
| Show Lifecycle (4) | Fire as a show is created, edited, trashed, or permanently deleted. |
| Episode Lifecycle (12) | Fire as an episode moves through creation, edits to its fields, references, and custom field values, publish/unpublish transitions, and deletion. |
| Subscription Lifecycle (10) | Fire when a subscriber’s membership changes state on the connected bridge — activated, cancelled, moved to a different tier, renewed, or failed to pay. |
| Token Lifecycle (8) | Fire around the feed token that gives a subscriber access — generated, accessed, reset, revoked, or presented invalid. |
| Feed (2) | Fire around the moment a feed’s RSS XML is output, for code that needs to act right before or after the response body rather than filter its contents. |
| Feed Cache (2) | Trigger and react to clearing the compiled-feed cache. Every feed is cached, your public feed included, so both hooks fire on every install. |
| Custom Fields (1) | Fires after a custom field value is persisted, for add-ons that need to react to a specific field changing. |
| Setup and Configuration (5) | Fire around first-run setup and bridge configuration — completing the setup wizard, saving a bridge selection, and clearing stale <itunes:new-feed-url> redirects. |
| Bridge and Tier Events (4) | Fire when the mapping between a membership plugin’s levels and Benecaster’s tiers changes, or when the bridge itself is switched. |
| SSP / PowerPress Import Events (4) | Fire while episodes are imported from the Seriously Simple Podcasting or PowerPress plugins, per-episode and per-batch. |
| Analytics and Data Management (2) | Fire when shadow records (imported patron placeholders — see Show Settings Reference) are created from a Patreon upload and when the nightly purge clears expired ones. |
| Subscriber Engagement (4) | Fire as Benecaster tracks whether a subscriber’s podcast app is actively polling their feed — first poll, never starting, going inactive, and coming back. All four pass the token’s stored tier — follower for a follower. |
| Templates — Show Page (13) | Bracket each section of the public show page — header, subscribe links, tier listing, embedded episode list, and stats — for inserting custom markup before or after. |
| Templates — Locked State (6) | Bracket the messages shown to visitors who can’t access an episode — the generic locked message, the upgrade prompt for logged-in subscribers at the wrong tier, and the login prompt for logged-out visitors. |
| Templates — Episode Archive (24) | Bracket the episode archive listing and each part of an individual episode card — artwork, title, meta, excerpt, player, and locked state — for inserting custom markup around them. |
| Admin Subscriber Actions (2) | Fire when a podcaster manually revokes a subscriber’s access or overrides their tier from the Benecaster admin. |
| Email Events (10) | Fire around dispatch of any Benecaster email, a test send and a broadcast, and around a subscriber’s opt-out state, for logging, monitoring send failures, or reacting to unsubscribes. |
| Marketing Consent (1) | Fires when a person’s answer to an add-on’s marketing-consent checkbox is recorded or changes. Benecaster asks only when an add-on asks it to, and never sends marketing email itself. |
| Integration Actions (2) | Fire around an add-on’s handler when an outside system — Zapier, Make, a CRM — calls it through POST /wp-json/benecaster/v1/actions. Neither fires for a replay of an earlier request. |
| Subscriber Account (Front End) (15) | Bracket each section of the [benecaster_account] shortcode — subscription, feed URL, token reset, app links, and QR code — for add-ons that extend the subscriber account page. |
| License Events (13) | 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. |
| Data Export (2) | Fire around generation of the “Your Data” XLSX export a subscriber can download. |
| Shortcode Extension (1) | Lets an add-on echo custom HTML inside each tier card rendered by [benecaster_subscribe]. |
| Front-end Scripts and Styles | Benecaster registers its front-end script and style handles on init, not on wp_enqueue_scripts, so they exist in wp-admin, the block editor and preview requests as well as on the front end. Each file is still added to a page only when the shortcode that needs it renders there. |
Add-ons
These fire only while the named add-on is installed and active.
| Area | What it covers |
|---|---|
| Add-on Manager (9) | Fire as the Add-on Manager downloads, checks and installs add-ons, and updates them or itself. Each page lists the order the pairs fire in. Nothing a callback returns is read. |
| Migration Wizard (9) | Fire as a migration import runs and as migrated subscribers sign up, lapse, or are handled from the migration dashboard. |
| Outlinks (15) | Fire as tracked /go/ links are clicked, as Link Health checks links and acts on them, and as tracked links follow their Reference Library items or move with an episode. Most fire only where Outlinks is switched on and the license is current; each page says which. |
| AI Search (8) | Act before and after a search, a production-panel search, and a pinned result being saved or deleted. |
| Email Editor (14) | Act before and after a design, the branding, UTM settings or episode-notification settings are saved, a design is reset or imported, and an episode notification is sent. |
| Guest Manager (24) | Act when a guest is saved, deleted, linked to an episode or imported, around the guest page, the directory and its setting, and around the Guest portal: invitations, submissions and approvals. |
| Transcription Service (3) | Act when a transcript is imported, formatted or updated. |
See Also
Need this built rather than just documented? See our services →