Title: Stagent Author: stagent Published: Ẹrẹ́nà 17, 2025 Last modified: Igbe 1, 2025 --- Ṣàwárí àwọn plugin ![](https://ps.w.org/stagent/assets/banner-772x250.jpg?rev=3257256) Plugin yìí **kò tíì ṣe àyẹ̀wò pẹ̀lú àwọn ìtújáde mẹ́ta pàtàkì tó kẹ́yìn ti WordPress**. Ó lè jẹ́ pé a kò tọ́jú tàbí ṣe àtìlẹ́yìn fún un mọ́, ó sì lè ní àwọn ọ̀ràn ìbámu nígbà tí a bá lò ó pẹ̀lú àwọn ẹ̀yà WordPress tuntun. ![](https://ps.w.org/stagent/assets/icon-256x256.jpg?rev=3257256) # Stagent Láti ọwọ́ [stagent](https://profiles.wordpress.org/stagent/) [Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/stagent.0.2.5.zip) * [Àwọn àlàyé](https://yor.wordpress.org/plugins/stagent/#description) * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/stagent/#reviews) * [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/stagent/#installation) * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/stagent/#developers) [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/stagent/) ## Àpèjúwe Stagent is a lightweight WordPress plugin designed to display bookings from the Stagent API on your website. Easily integrate your event bookings by fetching teams and bookings directly from Stagent, and display both upcoming and past events using the [stagent_bookings] shortcode. With built-in AJAX pagination, customizable display options (including dark mode, toggle buttons, and canceled bookings), and transient caching for performance, Stagent makes event management seamless. **Features include:** Ìtumọ̀ Yorùbá: – **API Integration**: Securely fetch teams and bookings using your Stagent API key. Ìtumọ̀ Yorùbá: – **Shortcode Driven**: Use [stagent_bookings] to embed booking lists anywhere, with options for team, artists, show type, per page, canceled bookings, past/upcoming toggles, and dark mode. Ìtumọ̀ Yorùbá: – **Booking Widget**: Add the Stagent Booking Widget in a few clicks. Ìtumọ̀ Yorùbá: – **Load More**: Smooth, incremental loading of bookings without page reloads. Ìtumọ̀ Yorùbá: – **Transient Caching**: Improve performance with built-in caching. Ìtumọ̀ Yorùbá: – **Display Options**: Configure dark mode, toggle past/upcoming visibility, show canceled events, and set items per page via shortcode or settings. Ìtumọ̀ Yorùbá: – **Developer Friendly**: Extend functionality with hooks and a clean codebase. Ìtumọ̀ Yorùbá: – **Future Proof**: Designed to evolve with additional booking features. ### License Stagent is released under the GPLv2 or later. See [http://www.gnu.org/licenses/gpl-2.0.html](http://www.gnu.org/licenses/gpl-2.0.html) for details. ## Ìgbéwọlẹ̀ #### Manual Installation 1. Download the plugin zip file. 2. In your WordPress admin dashboard, navigate to Plugins > Add New > Upload Plugin. 3. Upload the ‘stagent.zip’ file and click “Install Now.” 4. Activate the plugin. 5. Go to Settings > Stagent to configure your API key, default team, and display options. Note: The “Refresh” link requires a valid nonce for security. 6. Insert the [stagent_bookings] shortcode into posts or pages to display bookings. #### FTP Installation 1. Unzip the ‘stagent.zip’ file. 2. Upload the resulting folder to the /wp-content/plugins/ directory on your server. 3. Activate the plugin from the WordPress dashboard. 4. Configure settings and insert the shortcode as described above. ## 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: Ìtumọ̀ Yorùbá: – `team="id"`: Filter bookings by a specific team ID. Ìtumọ̀ Yorùbá: – `artists="id,id"`: Comma-separated list of artist IDs to filter bookings. Ìtumọ̀ Yorùbá: – `show="all|upcoming|past"`: Control which bookings to display: Ìtumọ̀ Yorùbá: – `all` (default): Upcoming and past bookings. Ìtumọ̀ Yorùbá: – `upcoming`: Upcoming bookings only. Ìtumọ̀ Yorùbá: – `past`: Past bookings only. Ìtumọ̀ Yorùbá: – `per_page="number"`: Number of bookings per page( default: 5). Ìtumọ̀ Yorùbá: – `canceled="true|false"`: Show canceled bookings: Ìtumọ̀ Yorùbá: – `false` (default): Hide canceled bookings. Ìtumọ̀ Yorùbá: – `true`: Include canceled bookings. Ìtumọ̀ Yorùbá: – `show_past="true|false"`: Show or hide the “ Past” and “Upcoming” toggle buttons: Ìtumọ̀ Yorùbá: – `true` (default): Show toggle buttons (if past bookings are enabled in settings). Ìtumọ̀ Yorùbá: – `false`: Hide toggle buttons, showing only the selected `show` type. Ìtumọ̀ Yorùbá: – `dark_mode ="true|false"`: Enable or disable dark mode for the bookings list: Ìtumọ̀ Yorùbá:–` false` (default): Use light mode unless enabled in settings. Ìtumọ̀ Yorùbá: – `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Ìtumọ̀ Yorùbá: ″] Shows bookings for team ID “d1e2f3”. ### Example: Filter by Artists [stagent_bookings team=”d1e2f3Ìtumọ̀ Yorùbá: ″ artists=”a1b2c3,a4b5c6Ìtumọ̀ Yorùbá:″] 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Ìtumọ̀ Yorùbá: ″] 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Ìtumọ̀ Yorùbá: ″ artists=”a1b2c3,a4b5c6Ìtumọ̀ Yorùbá:″ show=”upcoming” per_page=”15Ìtumọ̀ Yorùbá: ″ 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. ## Àwọn àgbéyẹ̀wò Kò sí àwọn àgbéyẹ̀wò fún plugin yìí. ## Àwọn Olùkópa & Olùgbéejáde “Stagent” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí. Àwọn Olùkópa * [ stagent ](https://profiles.wordpress.org/stagent/) [Túmọ̀ “Stagent” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/stagent) ### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè? [Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/stagent/), ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/stagent/), tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/stagent/) nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/stagent/?limit=100&mode=stop_on_copy&format=rss). ## Àkọsílẹ̀ àwọn àyípadà #### v0.2.5 * **Fixed**: Clashing CSS with some themes. #### v0.2.4 * **Added**: Option to enable/disable ‘Powered by Stagent’. * **Improved**: Optimized and minified CSS. #### v0.2.3 * **Fixed**: Corrected minimum required versions. #### v0.2.2 * **Improved**: Store widget script as URL and enqueue it. * **Fixed**: Add element existence checks in JS. #### v0.2.1 * **Improved**: Applied feedback from WordPress.org for Plugin Directory listing. #### v0.2.0 * **Added**: New shortcode attributes `show_past="true|false"` to control visibility of “Past” and “Upcoming” toggle buttons (defaults to `true` if past bookings are enabled in settings). * **Added**: New shortcode attribute `dark_mode="true|false"` to enable/disable dark mode per shortcode instance (overrides settings, defaults to `false`). * **Added**: New shortcode generator located in the **Settings > Stagent** page under the “Shortcode Generator” tab. * **Enhanced**: Added nonce security, migrated inline JS to `stagent-admin.js`, refined `stagent_booking_widget` validation, and streamlined shortcode generator UI for better usability and compliance. * **Improved**: Enhanced template security with sanitization/escaping, added type safety, updated README with full `$atts` docs, fixed filename mismatches and 403 errors, and ensured widget display consistency. #### v0.1.0 * Initial release. ## Àkójọpọ̀ Meta * Ẹ̀yà **0.2.5** * Ìgbàgbọ́hùn tó kẹ́yìn **ọdún 1 sẹ́yìn** * Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **Tó kéré sí 10** * Ẹ̀yà WordPress ** 5.0 tàbí ju bẹ́ẹ̀ lọ ** * Dánwò dé **6.7.7** * Ẹ̀yà PHP ** 7.0 tàbí ju bẹ́ẹ̀ lọ ** * Èdè * [English (US)](https://wordpress.org/plugins/stagent/) * Àwọn àmì * [artists](https://yor.wordpress.org/plugins/tags/artists/)[bookings](https://yor.wordpress.org/plugins/tags/bookings/) [djs](https://yor.wordpress.org/plugins/tags/djs/)[events](https://yor.wordpress.org/plugins/tags/events/) * [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/stagent/advanced/) ## Àwọn ìbò Kò sí ìwádìí tí a tíì fi ránṣẹ́. [Your review](https://wordpress.org/support/plugin/stagent/reviews/#new-post) [Wo gbogbo àwọn àgbéyẹ̀wò](https://wordpress.org/support/plugin/stagent/reviews/) ## Àwọn Olùkópa * [ stagent ](https://profiles.wordpress.org/stagent/) ## Ìrànlọ́wọ́ Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́? [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/stagent/)