Hype5 Docs

Hype5 Theater 0.6.17 · Pre-release

The Hype5 app (Fuajee)

Hype5 Theater is managed in the Hype5 app. Hype5 Theater in the WordPress sidebar opens it, and everything else is reached through the app's own navigation.

On this page

The Hype5 app (code name Fuajee) is the administration application of Hype5 Theater. Hype5 Theater in the WordPress sidebar opens it directly (wp-admin/admin.php?page=hype5t-app). It covers the daily work of a theatre — productions, credits, people, the schedule, venues, appearance, vocabularies and settings — and everything is reached through the app's own navigation. The WordPress lists and editors remain as compatibility screens for the tasks the app hands to WordPress.

Who can open it

Two conditions must both be true:

  1. The app is enabled for the user. Access is still switched on per site: a site administrator enables it either for every user by adding define('HYPE5_THEATER_FUAJEE', true); to wp-config.php, or for named users by listing their user IDs in the app's access list, the hype5t_fuajee_testers option (for example with WP-CLI: wp option update hype5t_fuajee_testers '[12,34]' --format=json). There is no settings screen for this list. Developers can also decide per user with the hype5_theater_fuajee_enabled filter.
  2. The user has a Hype5 permission that the app opens with: editing productions, editing people, managing performances or editing venues.

For these users the WordPress sidebar shows one entry, Hype5 Theater, with no submenu (unless another plugin adds its own page under it); it opens the app on the Overview. Users for whom the app is not enabled — and users whose only Hype5 permission is Settings or Vocabularies — keep the classic Hype5 Theater menu (see Without the Hype5 app).

Rollout. The access list has not been removed. Opening the app for every user with a Hype5 permission, based on capabilities alone, is still pending; until then a site administrator decides who uses the app (the access list or the constant).

Enabling the app never grants a permission. Inside the app each screen and action follows the same capabilities as the classic screens (see Roles and capabilities). Removing a user from the access list, or removing the constant, gives that user the classic menu back; the data saved in the app is ordinary plugin data that the classic screens read.

Old addresses of classic Hype5 screens that the app replaces, such as bookmarks to Hype5 Theater → Settings, open the matching app screen (see Old addresses). On the compatibility screens, Open in Hype5 app in the WordPress toolbar and on the rows of the WordPress lists of productions, people and venues returns to the app.

Layout

  • Sidebar. Work: Overview (Ülevaade), Productions (Lavastused), People (Inimesed), Schedule (Mängukava), Venues (Mängupaigad). Configuration: Appearance (Välimus), Vocabularies (Liigitused), Settings (Seaded). A destination the user may not use in the app is shown as a link to the classic screen, or not at all.
  • Search. Ctrl+K / ⌘K opens Hype5 search on the app screen.
  • Back to WordPress returns to the normal wp-admin.
  • The app has a light and a dark theme and follows the user's WordPress language (English and Estonian are included).

WordPress and plugin notices are shown as plain text in the app's own notice area.

Saving and editing together

  • Changes are kept as a draft until you press Save. Leaving with unsaved changes asks first.
  • Productions, people and venues use WordPress's own edit lock: while someone else edits a record (in the app or the classic editor), it is read-only with their name and a Take over option.
  • If a field was changed elsewhere after you opened the record, the save stops and the field is marked; you choose Use saved value or Keep mine. Your other changes are kept.
  • If only part of a save succeeds, the app names what was saved and keeps the rest as unsaved changes.

Overview

The Overview (Ülevaade) is the app's start screen. Each part is shown only to users who can act on it; nothing is stored or cached.

Part Content
Header Published counts of productions, people and venues; create actions allowed for the user.
This week The current week from the site's first day of the week; each day lists its performances (site time zone) and links to the Schedule for that day.
Next performances The next five performances with status, venue and a ticket hint.
Needs attention Three checks: a Playing production without future performances; a published production without a poster image (archived productions excluded); a performance in the next 30 days without a ticket offer. Reminders can be hidden per browser.
Productions In the repertoire and Recently changed productions you can edit.
Getting started Steps detected from saved data (time zone, first production, credits, venue, performance, appearance, a published production). Opening a step never creates anything.

What stays in WordPress

  • The productions list shows at most the 500 most recently changed productions; bulk actions, Trash and Quick Edit for productions are in the WordPress list (Open the WordPress list under the app's list).
  • Author, comments and revisions are edited in the WordPress editor.
  • Public pages are not previewed with unsaved changes; Preview and Saved page links show saved data.
  • System Status: Settings → Advanced (Täpsem) shows the same facts in the app; Continue in WordPress: System status opens the WordPress screen, which also works when the app cannot load.

The compatibility screens are described in Compatibility screens.