Title: GigRoute Events Author: BlackStar Published: May 17, 2026 Last modified: June 2, 2026 --- Search plugins ![](https://ps.w.org/gigroute-events/assets/icon-256x256.png?rev=3534465) # GigRoute Events By [BlackStar](https://profiles.wordpress.org/blackstar1991/) [Download](https://downloads.wordpress.org/plugin/gigroute-events.1.3.0.zip) * [Details](https://pcd.wordpress.org/plugins/gigroute-events/#description) * [Reviews](https://pcd.wordpress.org/plugins/gigroute-events/#reviews) * [Installation](https://pcd.wordpress.org/plugins/gigroute-events/#installation) * [Development](https://pcd.wordpress.org/plugins/gigroute-events/#developers) [Support](https://wordpress.org/support/plugin/gigroute-events/) ## Description GigRoute Events is a WordPress event management plugin built for bands, musicians, artists, stand-up performers, show business teams, venues, and entertainment websites that need a clean way to publish upcoming shows and guide visitors toward tickets. The plugin adds a dedicated Event post type, event details, ticket URLs, location taxonomies, event statuses, posters, frontend filters, and a dynamic Gutenberg block for displaying tour dates and live events anywhere on your site. Whether you manage a band website, a comedy tour page, an artist profile, a festival landing page, or a promotional website for live shows, GigRoute Events helps you keep event information structured, searchable, and easy to promote. #### Built for ticket promotion GigRoute Events helps visitors move from event discovery to ticket action. Each event can include a Ticket URL, venue information, date and time, city, state, country, event type, status, and an optional poster image. This makes it easier to build pages such as: * Upcoming tour dates * Concert schedules * Stand-up show calendars * Festival appearances * Artist event listings * Venue and city-based event pages * Ticket-focused landing pages The frontend block can show a clear “Buy tickets” link for each event and automatically switch to a sold-out label when an event is marked as sold out. #### Key features * Custom Event post type with title, editor, excerpt, and featured image support. * Event date and time fields with local timezone handling and stored UTC values. * Ticket URL and external event source URL fields. * Venue name, latitude, longitude, and related post ID fields. * Event Type, Event Status, City, State, Country, and Tour Series taxonomies. * Default Event Type and Event Status management. * ISO 3166-1 alpha-2 country code support for event countries. * Gutenberg block for displaying event lists on pages and posts. * Upcoming, past, and all-events display modes. * Optional frontend filters by event type, country, city, status, and series. * Optional pagination for event lists. * Configurable event date output formats. * Optional ticket links in frontend event lists. * Sold-out and free-event metadata. * Event poster image support. * Optional global poster for all events. * Optional poster link wrapping for ticket or promotional links. * REST JSON endpoint for public event data. * Optional Schema.org Event/MusicEvent JSON-LD for public, indexable event pages. * Schema.org admin fields for venue address, performer, organizer, ticket offer, attendance mode, and event status. * Registered event meta fields with REST support and revision-aware storage where appropriate. * Shared datetime meta synchronization for classic editor, REST saves, Visual Revisions fallback paths, and Pro imports. * REST response caching with cache headers and debug information for administrators. * SEO controls for hiding individual event pages and preventing indexing. * Optional /events/ archive disable mode with a 301 redirect to a selected published page. * Compatible event editing UI for both the block editor and classic editor, without duplicate meta storage. * Classic theme template fallback for single event and archive templates. #### Gutenberg block The GigRoute Events block lets editors display events without writing code. Block options include title, title tag, layout styling, number of events, event mode, ticket link visibility, grouping, pagination, filters, and date format. This is useful for building conversion-focused sections such as “Tour Dates”, “Upcoming Shows”, “Live Events”, “Get Tickets”, or “Next Performances”. #### Event posters GigRoute Events includes poster functionality for visually promoting events. You can use individual event posters or one global poster across the site. Poster settings include: * Enable or disable posters globally. * Use individual event posters or one global poster. * Set the poster display delay. * Hide the poster for a selected number of days after a visitor closes it. * Wrap poster media in a link when a valid destination is available. * Use the global poster link or the individual event Ticket URL as the destination. This can help promote ticket campaigns, new tour announcements, stand-up specials, festival appearances, or other show business events. #### REST API GigRoute Events provides a public JSON endpoint: ``` /wp-json/gigroute-events/v1/events ``` The endpoint returns published events and supports event discovery, external frontends, mobile apps, landing pages, and custom JavaScript interfaces. Supported query examples: ``` /wp-json/gigroute-events/v1/events /wp-json/gigroute-events/v1/events?mode=upcoming /wp-json/gigroute-events/v1/events?mode=all&year=2026 /wp-json/gigroute-events/v1/events?mode=all&year=2026&month=4 /wp-json/gigroute-events/v1/events?country=ukraine&city=kyiv&event_type=concert /wp-json/gigroute-events/v1/events?start=2026-04-01&end=2026-04-30 /wp-json/gigroute-events/v1/events?mode=all&page=2&per_page=20 ``` The response includes pagination data and event items. Empty values are removed from public event responses where possible. Event edit meta is registered for REST access, so block editor saves, revisions, integrations, and the classic editor all continue to work with the same underlying post meta keys instead of duplicated values. #### SEO and marketing benefits GigRoute Events helps structure event content in a way that supports marketing and organic discovery. You can create dedicated content around live shows, city pages, tour schedules, artist announcements, and ticket calls to action. The plugin separates event metadata from normal post content, which makes it easier to reuse event information across blocks, templates, REST responses, filters, and promotional sections. For SEO-focused event pages, you can use event titles, excerpts, content, featured images, event taxonomies, and location terms to create relevant pages around concerts, tours, stand-up shows, and entertainment events. For events that should appear in lists but should not have a public single page, GigRoute Events includes event visibility controls. You can hide the direct event page and prevent search indexing while still keeping the event available in public lists and REST summaries when published. ### External services GigRoute Events can use the ipapi.co geolocation service when event-based posters are enabled on the frontend. The service is used to request approximate visitor location data from: ``` https://ipapi.co/json/ ``` The plugin uses this response to help choose a relevant upcoming event poster based on the visitor’s country, region, city, and approximate coordinates. The result may be cached in the visitor’s browser localStorage for up to 3 hours. Data sent: the visitor’s browser makes a request to ipapi.co, which means the visitor’s IP address is processed by that external service. Service terms: https://ipapi.co/terms/ Privacy policy: https://ipapi.co/privacy/ ## Screenshots * [[ * GigRoute Events Gutenberg block settings. * [[ * GigRoute Events block with filters and pagination. * [[ * Events CPT page. ## Blocks This plugin provides 1 block. * GigRoute Events Display events from the GigRoute Events plugin. ## Installation 1. Upload the `gigroute-events` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress Plugins screen. 2. Activate the plugin through the Plugins screen in WordPress. 3. Go to Events > Add Event to create your first event. 4. Add the event date, timezone, venue, ticket URL, location terms, event type, and event status. 5. Add the GigRoute Events block to any page where you want to display upcoming shows or tour dates. 6. Optional: go to Events > Event Settings to configure default event duration, archive redirect behavior, poster behavior, and REST API information. ## FAQ ### Q: Who is GigRoute Events for? GigRoute Events is designed for bands, musicians, artists, performers, stand-up comedians, show business teams, event promoters, venues, and entertainment websites that need to publish event listings and promote ticket links. ### Q: Does the plugin support ticket links? Yes. Each event can include a Ticket URL. The frontend event list can display a “ Buy tickets” link when ticket links are enabled in the block settings. ### Q: Can I mark an event as sold out? Yes. Events can be marked as sold out. When an event is sold out, the frontend output can show a sold-out label instead of the ticket link. ### Q: Can I mark an event as free? Yes. Events include a free-event option for cases where no ticket purchase is required. ### Q: Does the event editor work with both the block editor and Classic Editor? Yes. GigRoute Events keeps event data in one set of post meta keys and uses compatible editor handling so the event fields remain available in block-editor and classic- editor workflows without duplicating stored values. ### Q: Does GigRoute Events include a Gutenberg block? Yes. The plugin includes a dynamic Gutenberg block for displaying event lists. The block supports event modes, limits, filters, pagination, ticket link visibility, date formats, and title styling options. ### Q: Can visitors filter events? Yes. The block can show frontend filters for event type, country, city, status, and tour series. ### Q: Does the plugin support event locations? Yes. Events can use City, State, and Country taxonomies. Country terms can store ISO 3166-1 alpha-2 country codes for cleaner location data and integrations. ### Q: Does GigRoute Events have a REST API? Yes. Public event data is available at `/wp-json/gigroute-events/v1/events`. The endpoint supports upcoming, past, and all-event modes, date filters, taxonomy filters, and pagination. ### Q: Is the REST API cached? Yes. The plugin includes a versioned REST cache and cache headers. Cache debug information is available to administrators through the settings page and debug mode. ### Q: Can I hide an event page from direct public access? Yes. GigRoute Events includes controls for hiding an individual event page and preventing indexing. A published event can still appear in event lists and REST summaries while its direct single-event URL is hidden. ### Q: Can I use a poster to promote tickets or a tour? Yes. You can assign posters to individual events or use one global poster. Posters can be linked to ticket or promotional URLs when link wrapping is enabled. ### Q: Can I redirect the /events/ archive to another page? Yes. Go to Events > Settings, enable the event archive redirect option, and select a published page. The plugin stores the page ID and resolves the URL with WordPress, so domain, protocol, and permalink changes are handled more safely than a manually stored URL. ### Q: Can developers change the archive redirect URL for multilingual sites? Yes. Use the `gigroute_events_archive_redirect_url` filter. It receives the resolved URL and selected page ID, so multilingual plugins can return the translated page URL when needed. ### Q: Which template should a block theme use for the event archive? Use `templates/archive-gigroute_event.html`. The public URL can still be `/events/`; the template name follows the post type key `gigroute_event`, not the archive slug. ### Q: Which templates should a classic theme use? For classic themes, use `archive-gigroute_event.php` for the event archive and ` single-gigroute_event.php` for single event pages. The plugin also supports theme overrides in `gigroute-events/archive-event.php` and `gigroute-events/single-event. php` before falling back to its bundled templates. ### Q: Does GigRoute Events replace a full ticketing platform? No. GigRoute Events does not process payments or sell tickets directly. It helps organize event information and send visitors to the correct ticket, event, or promotional URL. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “GigRoute Events” is open source software. The following people have contributed to this plugin. Contributors * [ BlackStar ](https://profiles.wordpress.org/blackstar1991/) [Translate “GigRoute Events” into your language.](https://translate.wordpress.org/projects/wp-plugins/gigroute-events) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/gigroute-events/), check out the [SVN repository](https://plugins.svn.wordpress.org/gigroute-events/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/gigroute-events/) by [RSS](https://plugins.trac.wordpress.org/log/gigroute-events/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.3.0 * Added an optional /events/ archive disable mode with a 301 redirect to a selected published page. * Switched archive redirect settings from a stored URL to a stored page ID for safer domain, protocol, and permalink changes. * Added the `gigroute_events_archive_redirect_url` filter for multilingual redirect targets. * Improved classic theme template lookup for standard `archive-gigroute_event.php` and `single-gigroute_event.php` overrides. #### 1.2.2 * Moved performer Schema.org values to global settings so they can be reused across event pages. * Expanded event schema type options to include additional Schema.org Event subtypes while keeping MusicEvent as the default. * Locked venue city, country, and country code to values resolved from assigned taxonomies and country code term meta. * Removed per-event Schema.org enable toggle; JSON-LD now outputs automatically only when the generated event schema is valid and the event is public/indexable. * Improved the Schema.org validation modal with a working clipboard fallback and direct Schema.org Validator link. #### 1.2.1 * Fixed Schema.org Event Data visibility when the event noindex checkbox is disabled in the editor. * Added a resolved Schema.org values preview using existing event fields and assigned city/country taxonomies. #### 1.2.0 * Added global Schema.org structured data settings after the REST JSON API settings section. * Added index-aware Schema.org event fields for Event and MusicEvent JSON-LD. * Added a Schema.org validation preview modal with copyable JSON-LD for editors. * Added venue address, performer, organizer, ticket offer, attendance mode, and event status fields for richer event markup. * Normalized comma-based latitude and longitude values before saving and schema output. #### 1.1.0 * Fixed incorrect release #### 1.0.3 * Added a dedicated datetime meta synchronization service for local/UTC/date helper fields. * Reused the same datetime sync path for classic metabox saves and REST-based editor saves. * Prepared Pro integrations to call the shared datetime sync service instead of duplicating derived date logic. * Added tests. #### 1.0.2 * Improved registered event meta schema for REST, editor, and revision-aware workflows. * Added REST-save synchronization for derived event datetime fields such as UTC start/end and local start date. * Marked event editing meta boxes as block-editor compatible while keeping the same field placement for editors. * Kept Classic Editor fallback behavior without duplicating event meta values. #### 1.0.1 * Fixed bugs. * Added a button for finding geolocation coordinates in the Pro version. * Added a button for auto-detecting time zones in the Pro version. #### 1.0.0 * Initial release. * Added Event post type with event metadata. * Added event taxonomies for type, status, city, state, country, and tour series. * Added Gutenberg block for displaying event lists. * Added ticket URL support. * Added frontend event filters and pagination support. * Added event poster and global poster settings. * Added public REST JSON endpoint with caching. * Added SEO controls for hidden event pages and indexing behavior. ## Meta * Version **1.3.0** * Last updated **21 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.4 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/gigroute-events/) * Tags * [bands](https://pcd.wordpress.org/plugins/tags/bands/)[concerts](https://pcd.wordpress.org/plugins/tags/concerts/) [events](https://pcd.wordpress.org/plugins/tags/events/)[gutenberg](https://pcd.wordpress.org/plugins/tags/gutenberg/) [tickets](https://pcd.wordpress.org/plugins/tags/tickets/) * [Advanced View](https://pcd.wordpress.org/plugins/gigroute-events/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/gigroute-events/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/gigroute-events/reviews/) ## Contributors * [ BlackStar ](https://profiles.wordpress.org/blackstar1991/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/gigroute-events/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/donate/?hosted_button_id=TK9QQ5DE2K378)