GigRoute Events

Opis

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

Snimke zaslona

  • GigRoute Events Gutenberg block settings.
  • GigRoute Events block with filters and pagination.
  • Events CPT page.

Blokovi

Ovaj dodatak omogućava 1 blok.

  • GigRoute Events Display events from the GigRoute Events plugin.

Instalacija

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

ČPP

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

Recenzije

Nema recenzija za ovaj dodatak.

Suradnici i Programeri

“GigRoute Events” je softver otvorenog koda. Sljedeće osobe su doprinijele ovom dodatku.

Suradnici

Prevedite “GigRoute Events” na svoj jezik.

Zainteresirani ste za razvoj?

Pregledajte kôd, pogledajte SVN spremišteili se pretplatite na dnevnik razvoja od RSS.

Dnevnik promjena

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.