Shortcodes

Shortcodes are the primary way to place Hype5 content in pages, posts, page builders and themes; they work without the block editor. There are three collection shortcodes (productions, people, schedule), modular production shortcodes and modular person shortcodes. All of them render through the same templates as the plugin's own pages and apply the plugin's public visibility rules.

Common rules #

• Attributes affect only that shortcode instance; no shortcode saves anything.
• Presentation follows: shortcode attribute → the production's or person's own Display value → global Appearance → layout defaults → built-in default. Every display option can be given as an attribute.
• Invalid attribute values fall back to defaults; invalid schedule filters produce an empty list rather than a broader one.
• The plugin's stylesheets load automatically when a shortcode renders.

Collections #

Collections read filter values from the URL (?hype5_genre=drama, see Queries). An attribute always wins over the URL, and a filter set by attribute is not shown in the filter bar. Several collections on one page share the same URL parameters; set filters="0" and explicit attributes for an independent list.

[hype5_productions] #

Only published productions are listed. A password-protected production appears as a card with title, address, poster, genres, audience recommendation and premiere only.

Legacy names: [hype5_theater_productions] and [theater_productions] behave like [hype5_productions] with status="active"; status accepts the same values as context.

[hype5_people] #

Only published people whose profile page is allowed and who are shown in the directory are listed.

[hype5_schedule] #

Aliases: [hype5_next_performances], [hype5_theater_schedule], [theater_schedule].

Without dates the schedule lists future performances, earliest first. An explicit date window also includes earlier performances inside it. Without production, only performances of productions that are public to everyone (published without a password, in the original and the reader's language) are listed; with production, a password-protected production's performances appear after its password has been entered only on the production's own page or when the page's address filters to it (?hype5_production=); on any other page only productions public to everyone are listed. Venues are named only when published. Past, cancelled, postponed and sold-out performances never show a purchase link.

Production shortcodes #

Attributes:

• id — production ID. Default: the production being viewed.
• layout — the component's layout: production page (editorial, poster, wide, cinematic), cast (inline, list, table, grid), gallery (grid, masonry, carousel, feature), schedule (agenda, compact, cards, table), meta (inline, stacked), visitor (cards, list), media (featured, grid, list), partners (logos, list, compact), articles (list, cards, compact).
• images — alias of cast_images (none, small, large).
• group_by — alias of schedule_group.
• [hype5_production_schedule] also accepts the schedule filters limit (default 20), past, include_past, from, to, month, status and offset. An archived production shows past performances unless past or include_past is given.

Visibility: nothing is shown for a production that is not published, unless the current user may read it. For a password-protected production, until the visitor enters the password, [hype5_production] shows the title and WordPress's password form, [hype5_production_title] shows the title, and every other production shortcode shows nothing.

On a page other than the production's own page (Theater 0.7.0) the production shortcodes and blocks show a production's details only while it is public to everyone — published without a password, in its original language and in the reader's language — or to people who may read it while it carries no password (an editor previewing a draft, a member of a private production). A password-protected production shows the title and the password form there also after the visitor entered the password; the form takes the visitor to the production's own page, where it unlocks. Such pages therefore never depend on a visitor's password and stay safe for page caches. The same holds for WordPress's own readers outside the production's page: feeds, archives, search results and core REST answers show a production with a password as protected also after the password was entered. [hype5_schedule production="…"] follows the same rule; a schedule that the page's address itself filters to one production (?hype5_production=…) follows the production's own page and is sent with no-cache headers (inside a REST request the parameter does not scope it).

A published translation whose original-language production is unpublished shows only its title (and poster) — on its own page, in feeds, core REST answers and search — to visitors who may not read the original.

Person shortcodes #

Attributes: id; layout — profile (profile, editorial, minimal), gallery (masonry, grid, carousel, feature), current productions (cards, list, compact), past productions (timeline, list, compact), meta (inline, stacked); and the person display options.

Visibility: nothing is shown for a person who is not published or whose profile page is not allowed, unless the current user may edit the person. Productions listed on a profile are only those published without a password.

Display options #

Every key below can be used as an attribute; the first value is the built-in default.

Layout keys (*_layout) accept the registered layouts of their family, including add-on layouts.

Examples #

[hype5_productions context="archive" order="premiere_desc" layout="list" filters="0"]
[hype5_people profession="actor" layout="alphabetical" per_page="24"]
[hype5_schedule venue="42" range="month" group_by="none" filters="0"]
[hype5_production id="487" layout="poster"]
[hype5_production_cast id="487" images="none" cast_character="0"]
[hype5_person_past_productions id="483" layout="timeline"]