Skip to main content

[benecaster_guest_section]

guest-manager

An episode’s guests anywhere on the site: in its own show notes, on a landing page, or beside an embedded player. Registered by the Guest Manager add-on. It lists the guests linked to the episode, in the episode’s order, with the same markup as Guest Manager’s Guests in this episode Episode Page block (photo, name linked to the guest’s website, Title, Organization, bio) inside <div class="benecaster-guest-section">.

It draws nothing for an id that is not an episode, an episode that is not published (unless the viewer can edit it), an episode whose own show has Guest Manager switched off, or an episode with no linked guest. There is no access check: a guest’s name is not member content, and the episode page shows a locked episode’s guests too.

The guests show once. When it draws an episode’s guests, the episode page’s own Guests section leaves that episode’s guests out for the rest of the page, so placing it in an episode’s show notes takes the place of that section.

It never prints itself. The tag is registered on every request, so a page never shows it as text; it draws nothing unless Guest Manager is switched on for at least one 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 HTML can be changed with benecaster_guest_manager_guest_section_output; see Place guests anywhere with Guest Manager’s shortcodes.

Parameters

Name Type Default Required Description
episode_id int 0 No The episode. 0 or left out: the post being shown, when it is an episode.
title string Guests No The section heading, an h2. An empty title draws no heading.
bio string excerpt No excerpt shows the first 30 words as plain text. full shows the whole bio with its paragraphs. none shows no bio. Anything else reads as excerpt.
photos bool true No Shows each guest's photo, 96 × 96.

Example

<!-- The guests of the episode being shown -->
[benecaster_guest_section]

<!-- A specific episode's guests, full bios, no heading -->
[benecaster_guest_section episode_id="42" bio="full" title=""]

<!-- Names and titles only -->
[benecaster_guest_section bio="none" photos="false"]