Stagent

FAQ

How do I obtain my Stagent API key?

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

How do I activate the Stagent plugin?

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

How do I add the bookings list?

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.

Where can I find the IDs?

• 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.

How can I customize which bookings are displayed?

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

Can I disable caching?

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

What is dark mode?

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