[benecaster_search]
Full-text keyword search form for episodes. Renders a search input and live results area — results load via fetch() without a page reload. Available to all visitors including those without a subscriber account; tier filtering happens at the query level (anonymous users see only public episodes; token-authenticated subscribers see episodes accessible to their tier).
Coexists with benecaster_ai_search — both can be placed on the same site simultaneously. Typical pattern: [benecaster_search] on the public episode archive (no API cost); [benecaster_ai_search] in a tier-gated subscriber area.
Same-page upgrade pattern: To show regular search to visitors and AI search to logged-in subscribers on the same page, use your membership plugin’s content restriction to conditionally render each shortcode — or wrap them in a theme template conditional using is_user_logged_in(). This lets subscribers get the richer experience without a separate page.
Output filterable via benecaster_search_output. Gutenberg block and Elementor widget available via the Blocks & Widgets Library add-on.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
show_id |
int |
(current show)
|
No | Show to search within. Required on multi-show installs where no show context is available. |
placeholder |
string |
Search episodes…
|
No | Input placeholder text. |
per_page |
int |
10
|
No | Number of results per page. |
style |
string |
list
|
No | Result layout. list — vertical stacked cards; grid — two-column grid. |