GigRoute Events

Description

GigRoute Events is a WordPress event management plugin built for music bands, 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 is designed to help 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 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 the 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.
  • REST response caching with cache headers and debug information for administrators.
  • SEO controls for hiding individual event pages and preventing indexing.
  • 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 promoting events visually. 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 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.

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 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, poster behavior, and REST API information.

FAQ

Who is GigRoute Events for?

GigRoute Events is designed for bands, musicians, performers, stand-up comedians, show-business teams, event promoters, venues, and entertainment websites that need to publish event listings and promote ticket links.

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.

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.

Can I mark an event as free?

Yes. Events include a free-event option for cases where no ticket purchase is required.

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.

Can visitors filter events?

Yes. The block can show frontend filters for event type, country, city, status, and tour series.

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.

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.

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.

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.

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.

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

Translate “GigRoute Events” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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.