[benecaster_guests]
The guest list on any page: every published guest linked to a published episode on a show where Guest Manager is switched on, A–Z, each with their photo, name linking to their guest page, and Title, Organization. Registered by the Guest Manager add-on. It is the same list as the public guest directory at /guests/, and works whether or not that directory is switched on.
The search finds guests by name or organization, never by email. Paging and the search use the page’s own address (?guests_page= and ?guest_search=), so the list works under any permalink setting. Use one list per page: two would share those.
It never prints itself. The tag is registered on every request, so a page never shows it as text; it draws nothing while Guest Manager is switched on for no published show. Test for it with shortcode_exists(). The Blocks & Widgets add-on wraps it as a block and an Elementor widget.
Switches read false, 0, no and off as false and anything else as true. The list can be changed with benecaster_guest_manager_guest_directory_data and the HTML with benecaster_guest_manager_guests_output; a theme can override the guest/directory-list.php template. See Place guests anywhere with Guest Manager’s shortcodes.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
title |
string |
Guests
|
No | The list's heading, an h2. An empty title draws no heading. |
search |
bool |
true
|
No | Draws the search box, which finds guests by name or organization. |
per_page |
int |
30
|
No | Guests per page, 1 to 100. 0 reads as 30. |
show |
string |
— | No | Which show's guests to list. Empty lists every show with Guest Manager on. A show's ID or slug lists only the guests in that show's published episodes. current lists the show of the page being viewed: a show's page, an episode's show, or a show's guest directory; on any other page, every show. A show that doesn't exist, isn't published or has Guest Manager off lists nobody (No guests yet.), never every show. The search covers the chosen show only. |
Example
<!-- The whole guest list, with search -->
[benecaster_guests]
<!-- Only one show's guests -->
[benecaster_guests show="haunted-houses"]
<!-- The guests of the show this page belongs to -->
[benecaster_guests show="current"]
<!-- No heading or search, 12 to a page -->
[benecaster_guests title="" search="false" per_page="12"]