Stagent

Log in to your Stagent account and navigate to Account > API Tokens to generate a personal access token.

Copy your personal access token from Stagent and paste it into the Settings > Stagent page in your WordPress admin.

The easiest way is to create your shortcode using the Shortcode Generator located in the Settings > Stagent page under the "Shortcode Generator" tab. Want to do it manually? Use the [stagent_bookings] shortcode to display the bookings list. Customize it with these attributes: - team="id": Filter bookings by a specific team ID. - artists="id,id": Comma-separated list of artist IDs to filter bookings. - show="all|upcoming|past": Control which bookings to display: - all (default): Upcoming and past bookings. - upcoming: Upcoming bookings only. - past: Past bookings only. - per_page="number": Number of bookings per page (default: 5). - canceled="true|false": Show canceled bookings: - false (default): Hide canceled bookings. - true: Include canceled bookings. - show_past="true|false": Show or hide the "Past" and "Upcoming" toggle buttons: - true (default): Show toggle buttons (if past bookings are enabled in settings). - false: Hide toggle buttons, showing only the selected show type. - dark_mode="true|false": Enable or disable dark mode for the bookings list: - false (default): Use light mode unless enabled in settings. - true: Enable dark mode for this shortcode instance. Example: Basic Usage [stagent_bookings] Displays bookings for the default team, showing 5 upcoming bookings with toggle buttons (if past enabled), excluding canceled ones, in light mode. Example: Specific Team [stagent_bookings team="d1e2f3"] Shows bookings for team ID "d1e2f3". Example: Filter by Artists [stagent_bookings team="d1e2f3" artists="a1b2c3,a4b5c6"] Filters bookings for team "d1e2f3" to artists "a1b2c3" and "a4b5c6". Example: Past Bookings Only [stagent_bookings show="past"] Displays past bookings for the default team. Example: Show Canceled Bookings [stagent_bookings canceled="true"] Includes canceled bookings. Example: Custom Per Page [stagent_bookings per_page="10"] Shows 10 bookings per page. Example: Hide Toggle Buttons [stagent_bookings show="upcoming" show_past="false"] Shows only upcoming bookings without toggle buttons. Example: Enable Dark Mode [stagent_bookings dark_mode="true"] Displays bookings in dark mode, overriding settings. Example: Full Control [stagent_bookings team="d4e5f6" artists="a1b2c3,a4b5c6" show="upcoming" per_page="15" canceled="true" show_past="false" dark_mode="true"] Shows 15 upcoming bookings (including canceled) for team "d4e5f6" and artists "a1b2c3", "a4b5c6", without toggle buttons, in dark mode.

Team IDs: Found in the URL: stagent.com/app/teams/ID. Artist IDs: Found in the roster URL: stagent.com/app/teams/team-id/roster/ID.

Use the shortcode attributes above. For further customization, apply CSS to the booking list classes or use the plugin’s filter hooks.

Yes, set STAGENT_DEVELOPMENT_MODE to true in wp-config.php to bypass caching: define('STAGENT_DEVELOPMENT_MODE', true);

Enable dark mode via the dark_mode="true" shortcode attribute or in Settings > Stagent to apply a dark theme to the bookings list display.