For travel and tourism content, the Display on Pages feature is the real breakthrough. We can create destination landing pages for cities, counties, attractions, and travel guides, then add relevant events with detailed filters in minutes. It turns static tourism pages into useful local event hubs.
Turn Ticketmaster Events Into Your Website Revenue
PI Event Master connects your WordPress site directly to the Ticketmaster Discovery API — launch a local events directory, import events, display live listings, and grow affiliate earnings without writing a single line of code.
See Your Events Page
Before You Publish It
The admin panel now shows a full-fidelity live preview of your event cards — styled with your real colours and fonts — right next to the configuration form. No more guessing what it will look like.
Configure & Preview
Side by Side
Set filters (city, category, keyword, date), pick a layout, choose a page — and instantly see a live preview panel reflecting your Display Styles settings. No shortcode. No page edit. No publish → preview loop.
- ✓ Preview updates as you type filters
- ✓ Reflects your saved card colours & fonts
- ✓ Grid, 2-col, or List layout selector
- ✓ Assign to any WordPress page instantly
Real API Events,
Previewed Instantly
The Live Events tab now has its own Display on Pages form with the same side-by-side preview panel. Choose city, category, keyword or radius — the preview renders live Ticketmaster-style cards in your site's exact design theme.
- ✓ Separate preview for Live & Imported events
- ✓ TM API filter fields (segment, radius, ZIP)
- ✓ Independent style profiles per event source
- ✓ One click to assign to any page
Build Event Pages
in Under a Minute
Pick a page, set filters, see the preview, hit save. Your event directory page is live. No shortcode to memorise, no trial-and-error publishing, no developer needed. Perfect for city-by-city rollout across a multi-page events portal.
- ✓ No shortcode editing needed
- ✓ Scale to 100s of city & category pages
- ✓ Each page gets its own filtered event set
- ✓ Multiple assignments per page supported
Available in all licence tiers — Standard, Business, and Developer.
One-Time Purchase, Clear Upgrade Path
No monthly subscriptions. Buy once, use forever. All plans include the core Ticketmaster import and display toolkit, with 1 year of updates and support.
- ✓ Core live API listings and imports
- ✓ Shortcode, widget, styling and caching
- ✓ SEO event pages and affiliate links
- ✓ 1 year updates and support
- ✓ Everything in Standard
- ✓ Scheduled imports and search rules
- ✓ CSV export and team notifications
- ✓ Priority support for 1 year
- ✓ Everything in Business
- ✓ REST API, API keys and rate limits
- ✓ Webhooks, template overrides and multisite
- ✓ Agency and headless builds
Compare Every License
Scan the full matrix below to see exactly which features are included in Standard, Business, and Developer.
| Feature | Standard $110 | Business $255 | Developer $399 |
|---|---|---|---|
| Live Ticketmaster Discovery API events | ✓ | ✓ | ✓ |
| Bulk event importer | ✓ | ✓ | ✓ |
| Import Log and one-click rollback | ✓ | ✓ | ✓ |
[tm_events] shortcode | ✓ | ✓ | ✓ |
| Events widget | ✓ | ✓ | ✓ |
| Grid, list and masonry layouts | ✓ | ✓ | ✓ |
| Visual Display Styles editor | ✓ | ✓ | ✓ |
| Affiliate ID tracking on ticket links | ✓ | ✓ | ✓ |
| Live and imported transient caching | ✓ | ✓ | ✓ |
| Visual Shortcode Builder | ✓ | ✓ | ✓ |
| iCal / Add-to-Calendar links | ✓ | ✓ | ✓ |
| Structured data JSON-LD | ✓ | ✓ | ✓ |
| Virtual SEO event detail pages | ✓ | ✓ | ✓ |
| Auto-import on first page view | ✓ | ✓ | ✓ |
| Google Maps venue embed | ✓ | ✓ | ✓ |
| Seat map display | ✓ | ✓ | ✓ |
| Display on Pages assignments | 3 total | ✓ unlimited | ✓ unlimited |
| 👁 Live admin preview on Display on Pages | ✓ Imported & Live | ✓ Imported & Live | ✓ Imported & Live |
| Import notification recipients | 1 email | ✓ multiple emails | ✓ multiple emails |
| Scheduled cron auto-import | × | ✓ | ✓ |
| Auto-import Search Rules manager | × | ✓ | ✓ |
| CSV export of imported events | × | ✓ | ✓ |
| Event REST API endpoints: list + single | × | × | ✓ |
| API key authentication for REST API | × | × | ✓ |
| REST API response caching | × | × | ✓ |
| REST API rate limiting and headers | × | × | ✓ |
| Import webhook for Zapier / Make / n8n | × | × | ✓ |
| Theme template overrides | × | × | ✓ |
| WordPress Multisite support | × | × | ✓ |
| Client and agency deployments | × | × | ✓ |
| Flutter / headless WordPress ready | × | × | ✓ |
| Updates and support | 1 year | 1 year priority | 1 year priority |
"PI Event Master made it practical for us to build event landing pages across California cities and counties. With Display on Pages, we can add filtered Ticketmaster events to any landing page in about a minute, using city, category, keyword, venue, date, and layout filters without touching code."
EventsInCalifornia.com — California Events Directory ★★★★★
Which License Should You Choose?
Pick by workflow, not just by domain count. The plugin code gates the advanced automation and developer features by tier.
Standard
Best for one site that needs live listings, manual imports, styling, caching, affiliate links, virtual detail pages, and up to 3 page assignments.
Business
Best once the site becomes operational: unlimited page assignments, scheduled imports, saved search rules, CSV export, and team notifications.
Developer
Best for client work and integrations: REST API, API keys, response cache, rate limiting, webhooks, template overrides, and multisite setup.
Built For Ticketmaster-Powered Event Sites
PI Event Master is designed for WordPress sites that need live Ticketmaster API listings, imported SEO event posts, affiliate-ready ticket links, and local event directory pages.
For Ticketmaster API Key Holders
Connect your API key, choose city/category filters, and publish live Ticketmaster event listings or imported WordPress event posts without building a custom application.
For Local Event Sites
Use inexpensive WordPress hosting to launch city guides, concert directories, sports event pages, theatre listings, tourism pages, or niche affiliate event sites.
For Publishers & Agencies
Build city guides, niche event portals, client sites, or headless event apps with imported WordPress posts and Developer REST API access.
Build Search-Friendly Ticketmaster Event Content
PI Event Master helps publishers turn Ticketmaster event data into useful WordPress content for organic search. Create live Ticketmaster event listings for fresh discovery, or import selected concerts, sports fixtures, theatre shows, and family events as editable WordPress posts with stable permalinks. Those posts can support city event guides, venue pages, category archives, internal links, and long-tail searches such as “concerts in Chicago,” “sports events in New York,” or “theatre tickets near me.”
Event JSON-LD, event dates, venue details, location information, images, and ticket URLs give search engines clearer context about each listing. Virtual detail pages can provide crawlable URLs for live events, while Auto-import on First View can preserve selected events as WordPress posts. Rankings and rich results are never guaranteed, but the plugin supplies the technical event-publishing foundation needed for a focused Ticketmaster events SEO strategy.
Common WordPress Event Publishing Needs
Useful for teams searching for a WordPress Ticketmaster event importer, live Ticketmaster events shortcode, local events directory plugin, Ticketmaster affiliate WordPress site, or headless event API for WordPress.
What It Is
A Ticketmaster event importer and publishing engine for WordPress.
What It Is Not
It is not a generic manual calendar plugin and it does not replace Ticketmaster checkout. It sends users to affiliate-ready Ticketmaster ticket links.
Build a Profitable Events Portal
on WordPress — No Custom Dev Needed
Every feature you need to launch a Ticketmaster-powered events site: live listings, imported SEO posts, affiliate ticket links, and now a live admin preview so you see exactly what visitors will see.
Live Ticketmaster API
Real-time event listings from the Ticketmaster Discovery API, with transient caching to control API usage and refresh frequency.
Bulk Event Importer
Import up to 100 Ticketmaster events per batch as WordPress posts — filtered by city, keyword, category, date range, and more.
[tm_events] Shortcode
One shortcode handles live and imported events, all layouts, filters and pagination. Build it visually with the Shortcode Builder — no code.
Import History & Rollback
Every bulk import is tracked as a session. Roll back any session with one click and permanently remove those posts — your safety net.
Smart Caching
Separate transient caches for live API and imported events. Set expiry from 5 min to 24 hrs — flush instantly from the admin panel.
iCal + Google Maps
Add-to-Calendar button on every event. Google Maps embed shows venue location. Seat map display on detail pages.
Visual Shortcode Builder
Configure your shortcode with dropdowns and pickers — source, layout, filters — then copy the generated code. No guesswork.
Visual Display Styles
Customise card colours, fonts, button styles, thumbnail height, and column counts — with a live 2-card preview. Separate profiles for live vs. imported.
Virtual SEO Pages
Auto-create individual event pages at clean URLs. Enable Auto-import on First View to permanently save events as WordPress posts when a crawler or visitor lands.
Your site. Ticketmaster's events.
Your affiliate earnings.
Connect your Ticketmaster API key → choose cities and categories → publish live events or import them as SEO posts → earn commission when visitors book tickets. That's the entire loop, handled by this plugin.
How Events Render On Your Site
The plugin outputs real WordPress HTML using its own scoped CSS classes — Grid (3-col, 2-col, 4-col), Masonry, and List. All layouts are fully responsive. The previews below reflect the exact markup the plugin produces.
piwpt-events grid-3
Tab 1 — License Key
Activate your purchased licence to unlock tier-specific features and enable automatic plugin updates from the PI Media licence server.
🔐 Activation
| License Key | XXXX-XXXX-XXXX-XXXX-XXXX Enter your key from the purchase confirmation email. Validated against the PI Media licence server on activation. |
|---|---|
| Activate Button | AJAX call — no page reload. Validates the key with the PI Media licence server, binds it to the current domain, and immediately stores the tier (single / business / developer) from the server's product_ref. The tier badge and gated settings update instantly on success. On server error the plugin falls back to the locally cached tier. |
| Licence Status | Two inline status boxes toggle via jQuery: ● License Active (green) shown when active, License Not Active (amber) shown otherwise. Displays the activation message and appropriate action button. |
| Deactivate | AJAX deactivation — contacts the licence server, then always clears the local activation marker and cached tier regardless of server response. This prevents a stale local state from keeping paid features unlocked after a valid deactivation. The tier transient is also deleted so it refreshes on next load. |
🔄 Updates & Tier Display
| Automatic Updates | A valid active licence enables update notifications in Dashboard → Updates. Updates are delivered via the WordPress standard update mechanism. |
|---|---|
| Update Period | 1 year of updates included. Plugin continues to work after expiry — only new version updates stop. Renew at a discounted rate to continue receiving updates. |
| Tier Badge | The admin header shows a colour-coded badge: Standard Business Developer indicating which features are unlocked. |
| Gated Settings | Business-only and Developer-only tabs show a padlock notice and upgrade link when a lower-tier licence is active. Settings can be saved but won't take effect until the correct licence is applied. |
Tab 2 — API Settings
Connect to the Ticketmaster Discovery API and set your affiliate tracking ID. Three fields — takes under two minutes to configure.
🗝 API Credentials (get a free key at developer.ticketmaster.com)
| Consumer Key | Your TM Discovery API Key Your Ticketmaster Discovery API key (API key). This is the primary credential used for all event search calls. Free accounts have generous rate limits suitable for most sites. |
|---|---|
| Consumer Secret | Your TM Consumer Secret Used for OAuth-authenticated endpoints. Required for some advanced Discovery API calls. Leave blank if only using basic event search. |
| Test API | Makes a live call to the Ticketmaster API with your credentials and reports success or the specific error. Run this after saving to verify the connection. |
💰 Affiliate ID — Earn Commission on Every Ticket
| Ticketmaster Affiliate ID | your-affiliate-id Your Ticketmaster Affiliate Programme ID. When set, plugin-generated ticket URLs append the aff=YOUR_ID parameter using WordPress URL handling. Confirm the required tracking format with your Ticketmaster affiliate programme before publishing links. |
|---|
Tab 3 — Import Events
Pull Ticketmaster events into your WordPress database as real posts. Seven sub-tabs control every aspect of the import process.
① Import Settings — How Events Are Saved as WordPress Posts
| Post Type | Post / Page / Custom… Select the WP post type to import events into. Any public post type is available. |
|---|---|
| Author | Admin User WordPress administrator assigned as author of all imported event posts. |
| Post Status | Published / Draft / Pending Status of posts immediately after import. |
| Featured Image | ✓ Import event image as featured image Downloads the Ticketmaster event image and sets it as the WordPress post thumbnail. |
| Event Segment | ✓ Import event segment Category / Tag Saves the TM segment (Music, Sports, Arts…) as a WordPress category or tag. |
| Event Genre | ✓ Import genre Category / Tag Saves the TM genre (Rock, Jazz, Basketball…) as category or tag. |
|---|---|
| Event Sub-Genre | ✓ Import sub-genre Category / Tag Saves the TM sub-genre classification as category or tag. |
| Seat Map | ✓ Import seat map Downloads and stores the static seat map image URL. Displayed on the event detail page. |
| Date & Location Block | ✓ Add before content Prepends event date, time, and venue fields above the post body on the single page. |
| Append Meta to Title | ✓ Append venue, city, date to title Makes post titles unique and SEO-rich: "Band Name — Venue Name, City, Date". |
Event Expiry & Auto-Unpublish
| Enable Auto-Expiry | ✓ Automatically process past events daily WordPress cron checks daily for events whose piwpt_datetime has passed. Requires Date & Time to be stored (enabled in Imported Fields → Section B). |
|---|---|
| Action on Expiry | Set to Draft / Move to Trash What happens to the post when the event date passes. |
| Auto-Noindex Expired | ✓ Add noindex,nofollow to expired event pagesPrevents search engines from indexing past event pages. Keeps your search rankings clean without needing to delete posts. |
Import Email Notification
| Enable Email | ✓ Send notification after each bulk import Sends an email summarising how many events were imported and which posts were created. |
|---|---|
| Notification Email | admin@yourdomain.com Standard licence: only the first address is used — additional comma-separated addresses are ignored. Business & Developer: full comma-separated list supported, all recipients receive the notification. |
Fallback / Default Event Image
| Fallback Image URL | https://yourdomain.com/.../placeholder.jpg Shown on event cards when an event has no Ticketmaster thumbnail — applies to both live API events and imported event posts. Leave blank to show no image. |
|---|
② Imported Fields — What Data is Stored and Displayed
piwpt_ prefix (e.g. piwpt_city, piwpt_datetime). The TM Event ID (piwpt_tm_id) is always stored for duplicate detection.Section A — ACF Field Mapping (Optional)
If you use Advanced Custom Fields, map your existing ACF fields to TM event data so both your ACF fields and the plugin's own meta fields are populated on each import. Skip if you don't use ACF.
| Sync ACF Fields on Import | ✓ Enable ACF sync — when checked, mapped ACF fields are updated on each import. |
|---|---|
| ACF Field Group | Select Group… Choose the ACF group then map each field below. Mappable fields: Date & Time, Venue Address, City, State, Postal Code, Ticket URL, Seat Map URL. |
Section B — Plugin-Managed Meta Fields (No ACF Required)
Tick each field you want stored on import. Stored as piwpt_FIELD post meta. Sample values from the live API are shown when a valid Consumer Key is entered.
| Store | Field | Meta Key | Description |
|---|---|---|---|
| ✓ | TM Event ID | piwpt_tm_id | ALWAYS STORED — used for duplicate detection |
| ✓ | Date & Time | piwpt_datetime | Event start: localDate + localTime. Required for Event Expiry to work. |
| ✓ | Venue Name | piwpt_venue | Name of the event venue |
| ✓ | Venue Address | piwpt_address | Street address line 1 |
| ✓ | City | piwpt_city | City name — used for Display on Pages city filter |
| ✓ | State / Region | piwpt_state | State or region name |
| ✓ | Postal Code | piwpt_postalcode | ZIP / postal code |
| ✓ | Segment / Category | piwpt_segment | Top-level TM classification (Music, Sports, Arts…) |
| ✓ | Genre | piwpt_genre | Genre within the segment |
| ✓ | Sub-Genre | piwpt_subgenre | Sub-genre classification |
| ✓ | Ticket URL | piwpt_url | Link to buy tickets (affiliate ID appended automatically) |
| ✓ | Seat Map URL | piwpt_seatmap | Static seat map image URL |
| ✓ | Min Price | piwpt_price_min | Minimum ticket price from priceRanges |
| ✓ | Max Price | piwpt_price_max | Maximum ticket price from priceRanges |
| ✓ | Currency | piwpt_currency | Currency code: USD, GBP, AUD… |
| ✓ | Event Info | piwpt_info | General information / notes from TM |
| ✓ | Please Note | piwpt_please_note | Ticketmaster advisory / terms text |
Section C — Display Field Visibility (Grid/List Cards & Single Page)
Choose which stored fields appear on imported event cards and single post pages. Separate controls for each view.
| Field | Show |
|---|---|
| Thumbnail Image | ✓ |
| Date & Time | ✓ |
| Venue Name | ✓ |
| Address | |
| City | ✓ |
| State / Region | ✓ |
| Postal Code | |
| Segment / Category | ✓ |
| Genre | ✓ |
| Sub-Genre | |
| Price Range | ✓ |
| Ticket Button | ✓ |
| Field | Show |
|---|---|
| All card fields above | ✓ |
| Venue Address | ✓ |
| Postal Code | ✓ |
| Sub-Genre | ✓ |
| Event Info | ✓ |
| Please Note | ✓ |
| Seat Map | ✓ |
③ Import Events — Search & Bulk Import from Ticketmaster
| Keyword | Jazz Festival Search TM events by name / keyword. |
|---|---|
| City Name | New York Filter by city name. |
| Postal Code | 10001 Filter by ZIP / postal code (use instead of or with city). |
| Radius & Unit | 25 miles / km Distance radius from the city or postal code. |
| Number of Events | 5 / 10 / 20 / 50 / 100 How many events to fetch per API page. |
|---|---|
| Page Number | 0 – 100 Which page of results to fetch (for stepping through large result sets). |
| Get Events ↓ | Fetches matching events and displays them in a preview table. Review before importing. Events show: title, date, venue, city. Select individual events or import all at once. |
| Duplicate Check | Events already imported (matching piwpt_tm_id) are automatically skipped. Import button shows count of new events only. |
④ Import Log — View & Manage All Imported Events
| Log Table | Shows imported WordPress event posts. Columns: Post ID, Title, Ticketmaster Event ID, and Imported On date. |
|---|---|
| Total Count | Live badge showing total number of imported event posts matching the piwpt_tm_id meta key. |
| Search | Submit a search by post title, Ticketmaster Event ID, or Post ID to filter the log. |
| Quick Edit / View | Each row has direct links: edit the post in WP admin, view it on the frontend. |
|---|---|
| Bulk Delete | Select multiple imported events using the row checkboxes, choose Delete, and permanently remove them in one nonce-protected action. |
| Pagination | Standard WP List Table pagination. Works independently of the settings form. |
⑤ Import History — Session Log with One-Click Rollback
| Session ID | Unique identifier generated at import time (e.g. dop_64f3a1b2c3d4e). |
|---|---|
| Date / Time | Exact timestamp of when the import ran. |
| Events Imported | Count of new posts created in that session. |
| Post IDs | First 8 post IDs shown (full list stored in option). Used by rollback to locate and delete posts. |
| Rollback | Permanently deletes all posts created in that session. A confirmation dialog prevents accidental rollback. The session record is also removed after successful rollback. |
⑥ Display on Pages — Imported Events (No Shortcode Needed) 👁 Live Preview
The Display on Pages form now opens in a 50/50 split panel. The left side has all your configuration fields. The right side shows a live preview of the event cards — styled exactly as they will appear on your site — before you save anything. Change filters, switch layout, adjust city: the preview updates immediately.
Assign imported event listings to any WordPress page. The listing is injected automatically before or after page content — no shortcode editing required. Each assignment has its own independent settings.
| Select Page | — Choose a page — Hierarchical dropdown of all published pages. |
|---|---|
| Events Title | Upcoming Events in Chicago Optional heading shown above the listing. |
| Display Style | Grid — 3 columns / Grid — 2 columns / List These three options are available in the Display on Pages dropdown. Masonry and Grid 4-col are not in this dropdown — use the [tm_events style="masonry"] or [tm_events style="grid-4"] shortcode directly on the page instead. |
| Position | After page content / Before page content |
| Events per Page | 12 |
| Pagination | ✓ Show pagination |
| Keyword | music Matches post title and content. |
|---|---|
| Category | concerts WordPress category slug. |
| Tag | festival WordPress tag slug. |
| City | New York Matches piwpt_city meta. |
| Postal / ZIP | 10001 |
| Radius | 25 Miles / km |
| Date From | 2026-08-01 Show only events on or after this date. |
⑦ Display Styles — Imported Events
Customise the visual appearance of imported event cards site-wide without writing CSS. All values are saved as a separate option (piwpt_style_imported) and applied via scoped inline CSS variables.
| Card Background | Colour picker + hex. Default: #ffffff |
|---|---|
| Card Border Colour | Default: #e8e8e8 |
| Card Border Radius | 0–30px slider. Default: 10px |
| Thumbnail Height | 80–400px slider. Default: 190px |
| Card Gap | 0–60px spacing between cards |
| Title Colour | Default: #1a1a2e |
|---|---|
| Title Font Size | 12–32px slider. Default: 16px |
| Meta Text Colour | Date, venue, category, price. Default: #555555 |
| Meta Font Size | 10–20px slider. Default: 13px |
| Button Background | Default: #0073aa |
|---|---|
| Button Text Colour | Default: #ffffff |
| Button Radius | 0–30px (sharp to pill) |
| Desktop Columns | 2 / 3 / 4 columns (>1024px) |
| Tablet Columns | 1 / 2 / 3 columns (<1024px) |
Tab 4 — Live Events
Control how Ticketmaster API events are displayed. Live listings are not stored as WordPress posts; when caching is enabled, repeat requests can be served from WordPress transients until the configured expiry.
① Live Events Settings — Virtual Pages, Defaults & SEO
Virtual Single Event Pages
| Enable Virtual Detail Pages | ✓ Enable virtual single-event pages for live events Creates dynamic URLs: /ticketmaster-event/EVENT-ID/. Rewrite rules flushed automatically on toggle. |
|---|---|
| Auto-import on First View (recommended) | ✓ Permanently save the event as a WordPress post on first visit The first time anyone visits a virtual event URL, the event is silently imported using your Import Settings (post type, status, fields, featured image, categories). The URL then permanently resolves to the real WP post — even after the event expires on Ticketmaster. Respects Event Expiry and Noindex settings. |
| Noindex Virtual Pages | Add noindex, nofollow to virtual event pagesUse when you want virtual pages for human visitors but not search engine indexing of short-lived URLs. Has no effect once Auto-import converts a page to a permanent post. |
Default Display Settings
| Default Events per Page | 12 Used by [tm_events source="live"] when no explicit size attribute is supplied. Shortcodes and page assignments can override it. |
|---|---|
| Default Display Style | Grid 3-col / Grid 2-col / Grid 4-col / Masonry / List Used by live shortcodes when no explicit style attribute is supplied. |
| Default Radius Unit | Miles / Kilometres Used by live shortcodes when no explicit radius_unit attribute is supplied. |
② Live Event Fields — Field Visibility for Cards & Detail Pages
| Field | Show |
|---|---|
| Thumbnail Image | ✓ |
| Date & Time | ✓ |
| Venue Name | ✓ |
| Address | |
| City | ✓ |
| State / Region | ✓ |
| Postal Code | |
| Segment / Category | ✓ |
| Genre | ✓ |
| Sub-Genre | |
| Price Range | ✓ |
| Ticket Button | ✓ |
| Field | Show |
|---|---|
| All card fields above | ✓ |
| Venue Address | ✓ |
| Postal Code | ✓ |
| Sub-Genre | ✓ |
| Event Info | ✓ |
| Please Note | ✓ |
| Seat Map | ✓ |
③ Display on Pages — Live Events (No Shortcode Needed) 👁 Live Preview
The Live Events tab now has its own Display on Pages form with the same 50/50 split-panel live preview introduced for Imported events. Configure TM API filters (segment, city, ZIP, radius, keyword) on the left — preview the event cards in your site's exact styling on the right. No more publish-and-check loops.
Same form structure as the Imported Events Display on Pages, but fetches events live from the Ticketmaster API. Each assignment has its own filter set.
| Select Page | — Choose a page — |
|---|---|
| Events Title | Live Events in Los Angeles |
| Display Style | Grid — 3 columns / Grid — 2 columns / List These three options are available in the Display on Pages dropdown. Masonry and Grid 4-col are not in this dropdown — use the [tm_events style="masonry"] or [tm_events style="grid-4"] shortcode directly on the page instead. |
| Position | After / Before page content |
| Events per Page | 12 |
| Pagination | ✓ Show pagination |
| Keyword | Jazz |
|---|---|
| Segment / Category | Music / Sports / Arts & Theatre / Film / Misc TM API classification — not a WP category. |
| City | Los Angeles |
| Postal / ZIP | 90001 |
| Radius | 25 Miles / km |
| Date From | 2026-08-01 |
| Tag | Not available for live events |
④ Display Styles — Live Events
Identical controls to the Imported Display Styles tab, but stored separately as piwpt_style_live so live and imported events can have different visual designs on the same site.
Tab 5 — Shortcodes & Widget
One unified shortcode, a visual builder, and a sidebar widget — all powering the same flexible event display engine.
① Reference & Widget — Full Shortcode Documentation
[tm_events] Parameters
| Parameter | Default | Description |
|---|---|---|
source | live | live — fetch events from Ticketmaster API in real time imported — display events already saved as WordPress posts |
size | 12 | Number of events per page |
style | grid | grid (3-col) · grid-2 (2-col) · grid-4 (4-col) · list (horizontal card) · masonry (variable-height columns) |
pagination | yes | yes or no. Multiple shortcodes on the same page paginate independently — no configuration needed. |
| Filters — Live & Imported | ||
keyword | — | Search keyword. Matches event name on TM API; full-text search on imported posts. |
city | — | Filter by city name |
postalcode | — | Filter by ZIP / postal code |
radius | — | Distance radius (number). Requires postalcode or city. |
radius_unit | miles | miles or km |
category | — | Live: TM classification name (Music, Sports, Arts & Theatre…)Imported: WordPress category slug |
date_start | — | Show events from this date only (YYYY-MM-DD). Live events only. |
| Imported-Only Filters | ||
tag | — | WordPress tag slug. Imported events only. |
| Standard Shortcode | ||
[ticketmaster_events] | — | Available in any page, post, or template. Maps directly to [tm_events source="live"]. Accepts all the same parameters above. |
Shortcode Examples
[tm_events source="live" city="New York" size="12" style="grid"][tm_events source="live" postalcode="10001" radius="25" radius_unit="miles" category="Music" style="grid-2"][tm_events source="live" city="Los Angeles" style="masonry" size="9"][tm_events source="imported" tag="festival" size="9" style="grid"][tm_events source="live" city="Chicago" category="Music" size="6"][tm_events source="live" city="Chicago" category="Sports" size="6"]Widget — PI TM Events
| Location | Appearance → Widgets · also available as a Legacy Widget block in the block editor. Place multiple widget instances in any sidebar — each paginates independently. |
|---|---|
| Widget Settings | Title · Source (Live / Imported) · Display Style (Grid 3-col / Grid 2-col / Grid 4-col / Masonry / List) · Events per Page · Show Pagination · Keyword · City · Postal Code · Radius · Radius Unit · Category · Tag (imported only) · Date From (live only). |
| Caching | Widget results use the same caching settings as shortcodes (configured in the Caching tab). Live virtual detail pages work from widget-rendered event cards too. |
② Shortcode Builder — Visual Configuration → Copy & Paste
Configure your event listing visually. The shortcode output updates live as you change settings. One click copies it to the clipboard — ready to paste into any page, post, or widget.
| Source | Live — Ticketmaster API / Imported — WP Posts Switches category input between TM segment dropdown (live) and WP category text field (imported). Also shows/hides the Tag and Date From fields. |
|---|---|
| Display Style | Grid 3-col / Grid 2-col / Grid 4-col / Masonry / List All five layout options are available in the Shortcode Builder. Note: Masonry and Grid 4-col are shortcode-only — they do not appear in the Display on Pages form dropdown. |
| Events per Page | 12 |
| Pagination | ✓ Show pagination |
| Keyword | Jazz |
| City | San Francisco |
| Postal / ZIP Code | 94105 |
| Radius | 25 Miles / km |
| Category / Segment | Live: Music / Sports / Arts / Film / Misc Imported: wp-category-slug |
| Tag (imported only) | festival |
| Date From (live only) | 2026-08-01 |
?piwpt_nocache=1 in the URL (admin only) to bypass cache during testing. Field visibility is controlled in the Imported Fields or Live Event Fields tabs.Display Styles — Visual Customisation
Two separate style profiles — one for Live events, one for Imported events. Each stored as its own WordPress option. Change colours, typography, button style, thumbnail height, and column counts with a visual UI and live preview.
piwpt_style_imported vs piwpt_style_live).🖌 Card Appearance
- Card background colour
- Card border colour
- Card border radius (0–30px)
- Thumbnail height (80–400px)
- Card gap / spacing (0–60px)
🔤 Typography
- Title colour
- Title font size (12–32px)
- Meta text colour
- Meta font size (10–20px)
- Applied to: date, venue, city, category, price
🎟 Button & Columns
- Button background colour
- Button text colour
- Button border radius (0–30px)
- Desktop columns: 2 / 3 / 4
- Tablet columns: 1 / 2 / 3
.piwpt-events-wrap element.Tab 7 — Advanced → Business Settings Business & Developer
Automated scheduled imports, multi-recipient notifications, and CSV export. Unlocked with a Business or Developer licence — Developer includes every Business feature plus the REST API, webhooks, and Multisite capabilities in the Developer Settings tab below.
⏰ Auto-Import Scheduler
| Enable Auto-Import | ✓ Run auto-import on schedule Activates a WordPress cron job that runs your saved Search Rules automatically. Only new events (not matching any existing piwpt_tm_id) are imported — no duplicates. |
|---|---|
| Frequency | Every Hour / Twice Daily / Daily / Weekly How often the cron runs the saved rules. Daily is recommended for most sites. |
| Last Run | 2026-07-14 03:00 AM — 12 event(s) imported. Shown after the first successful auto-import run. |
📋 Auto-Import Search Rules
Add multiple independent search rules. Each rule defines a Ticketmaster query that runs on every cron cycle. Rules are stored as a WordPress option and shown in a table below the Add Rule form.
| Rule Field | Example Value | Description |
|---|---|---|
| City | Los Angeles | Filter events by city name |
| ZIP / Postal Code | 90001 | Use instead of or with city |
| Segment / Category | Music / Sports / Arts / Film / Misc | TM top-level classification |
| Keyword | jazz festival | Optional keyword for the TM search |
| Radius | 25 miles / km | Distance from city or ZIP |
| Max Events | 20 | Maximum events fetched per rule per run |
| Add Rule button | Saves the rule. It appears in the table above with a Remove button. Rules take effect on the next scheduled run or Run Now. | |
📧 Import Email Recipients
| Standard Licence | One email address only. |
|---|---|
| Business & Developer | admin@example.com, manager@example.com Comma-separated list. All addresses receive the import notification including: event count, event titles, session ID, import time. |
📊 CSV Export
| Download Events CSV | One-click download of all imported events with every stored meta field: title, date, venue, city, state, postal, segment, genre, price range, TM ID, affiliate ticket URL. |
|---|---|
| Access | Nonce-protected — only admins can trigger the download. Works for any volume of imported events. |
| Use cases | Site backup, migration to another WordPress install, or analysis in Excel / Google Sheets. |
Tab 7 — Advanced → Developer Settings Developer Licence Only
Includes all Business features plus REST API endpoints, authentication, response caching, rate limiting, import webhooks, template overrides, and Multisite. Settings show a padlock notice if a lower-tier licence is active.
🌐 REST API Endpoints
/wp-json/pi-event-master/v1/events
per_page · page · city · postalcode · category · tag · keyword · after (YYYY-MM-DD) · api_key/wp-json/pi-event-master/v1/events/{id}
piwpt_* meta fields, affiliate ticket URL./wp-json/pi-event-master/v1/ical/{id}
.ics calendar file for an imported event post. This supports the Add-to-Calendar feature.| Endpoint Availability | ✓ Registered automatically when a valid Developer licence is active Lower tiers see the Developer tab but the REST event routes are not registered until the licence gate passes. |
|---|---|
| Data Source | Imported WordPress event posts The API serves saved event posts and their piwpt_* meta fields, including affiliate-ready ticket URLs. |
🔐 API Authentication
| Require API Key | ✓ Reject requests without a valid API key All REST endpoints require the key as Authorization: Bearer YOUR_KEY header or ?api_key=YOUR_KEY query parameter. Unauthorised requests receive HTTP 401. |
|---|---|
| API Key | One-click generates a 40-character random key prefixed piem_. Regenerate at any time — instantly invalidates the old key. Keep this secret; share only with authorised apps. |
⚡ REST API Response Caching
| Enable Caching | ✓ Cache REST API list and single event responses Each unique query (filters + pagination) gets its own WordPress transient cache entry. Responses include X-Cache: HIT or MISS header. Auto-invalidated when an event post is updated or deleted. |
|---|---|
| Cache TTL | 1 min / 5 min / 10 min / 30 min / 1 hr / 2 hr / 24 hr Shorter = fresher data, more DB load. Longer = faster responses. Bypass with ?piwpt_nocache=1 (admin only). |
| Flush API Cache |
🚦 Rate Limiting
Protect the API from abuse and runaway clients. Limits tracked per IP address (or per API key when authentication is enabled).
| Enable Rate Limiting | ✓ Limit requests per time window Clients exceeding the limit receive HTTP 429 Too Many Requests with a Retry-After header. |
|---|---|
| Request Limit | 60 Max requests per client per window. Default: 60. |
| Window | 60s / 5 min / 10 min / 1 hour Time window for the request limit counter. |
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1720000000
X-Cache: HIT
Retry-After: 42 (429 responses only)
🔗 Import Webhook
| Webhook URL | https://hooks.zapier.com/hooks/catch/… POST payload sent after every import (manual or auto). Leave blank to disable — no performance impact. |
|---|---|
| Payload Fields | event · session_id · post_ids[] · tm_ids[] · count · time · site_url |
| Test Webhook | Sends a sample payload to the saved URL immediately. |
| Integrations | Zapier, Make (Integromat), n8n, or any custom HTTP endpoint. |
🗂 Theme Template Overrides
| Override Directory | /your-theme/pi-event-master/ |
|---|---|
| Available Templates | event-card.php — grid/list/masonry cardevent-detail.php — virtual live event detail page |
| Status | Admin shows ✓ Override active when a theme file is detected, otherwise "Using plugin default". |
| Enable | ✓ Allow theme files in /pi-event-master/ to override plugin templates |
🌐 WordPress Multisite
| Network Activate | Activate PI Event Master network-wide from Network Admin → Plugins. |
|---|---|
| Per-Site Settings | Each sub-site gets its own independent plugin settings, import data, and licence check. |
| New Sites | Sites created after network activation are automatically configured. |
Tab 6 — Caching
Dramatically reduce Ticketmaster API calls and page load times with configurable transient caching for both live API events and imported event listings.
🌐 Live API Events Cache
| Enable Caching | ✓ Cache live Ticketmaster API results Recommended. Each unique set of shortcode/widget parameters gets its own cache entry. Reduces API calls and page load time significantly. |
|---|---|
| Cache Expiry | 5 min / 15 min / 30 min / 1 hr / 2 hr / 6 hr / 12 hr / 24 hr How long to keep each cached API result before re-fetching. Recommended: 1 hour. |
🗄 Imported Events Cache
| Enable Caching | ✓ Cache imported events listing output (HTML) Caches the rendered HTML of imported event listings. Clear after publishing or editing events to see the latest content. |
|---|---|
| Cache Expiry | 5 min / 15 min / 30 min / 1 hr / 2 hr / 6 hr / 12 hr / 24 hr How long to keep each cached imported listing before regenerating. |
🗑 Manage Cached Transients
| Active Transients | Live count of active piwpt_ prefixed transients currently stored in the WordPress options table. |
|---|---|
| Transient Table | Each row shows: transient key, expiry countdown ("3 hours remaining" or "Expired"), and a Delete button. Deletes are AJAX-powered — no page reload. |
| Flush Live Cache | Clears only live API transients. |
| Flush Imported Cache | Clears only imported listing transients. |
| Flush All | Clears every piwpt_ transient instantly. Individual and bulk flush buttons are disabled when count is 0. |
?piwpt_nocache=1 to any page URL to see fresh API data without clearing the whole cache. Useful for checking new events immediately after an import.What Our Customers Say
WordPress site owners and event publishers who chose PI Event Master for their Ticketmaster integrations.
Common Questions Answered
Everything you need to know before buying PI Event Master.
Do I need a Ticketmaster API key?
Yes — a free Ticketmaster developer account gives you an API key. You can sign in or create an account here: Ticketmaster Developer Account. The free tier has generous rate limits suitable for most event sites.
What's the difference between live and imported events?
Live events come from the Ticketmaster API and are not stored as WordPress posts, although API responses can be held temporarily in the configured transient cache. Imported events are saved as editable WordPress posts for longer-term publishing and SEO use.
Will imported events show a 404 after they expire?
Imported events are saved as WordPress posts, so their URLs remain available unless you manually remove them or enable the optional expiry action that moves past events to Draft or Trash. For live virtual pages, Auto-import on First View saves the event as a post when the virtual page is first visited.
Can I use the plugin with custom post types?
Yes. The Import Settings tab lets you choose any public post type — Posts, Pages, or your own custom types — as the target for imported events.
How does the affiliate ID work?
Enter your Ticketmaster Affiliate ID in API Settings and plugin-generated ticket URLs append an aff parameter. Confirm that this parameter format matches the tracking instructions supplied by your Ticketmaster affiliate programme.
Can I roll back a bulk import I made by mistake?
Yes. Every bulk import is logged as a session with a timestamp and the post IDs created. The Import History tab lets you roll back any session, permanently deleting all posts created in that run.
Does it work with page builders like Elementor?
Yes. The [tm_events] shortcode works in any page builder that supports WordPress shortcodes, including Elementor, Divi, WPBakery, and the Gutenberg block editor.
What happens after my 1-year support period ends?
The plugin continues working indefinitely. You lose access to new version updates and priority support. You can renew your license for another year at a discounted rate to continue receiving updates.
Is there a limit to how many events I can import?
No — there's no hard limit imposed by the plugin. The practical limit is your Ticketmaster API rate limit and your server resources. The caching system minimises API load.
Does it support Google rich results for events?
The plugin automatically outputs Schema.org Event JSON-LD for its event listings and imported event pages, including available date, venue, location, image, and ticket information. This can make a page eligible for event search features, but Google decides whether any page receives a rich result.
Which features are limited on the Standard license?
Standard includes the core Ticketmaster API, import, shortcode, widget, styling, caching, affiliate, iCal, JSON-LD, and virtual page features. The practical limits are 1 licensed domain, 3 total Display on Pages assignments, and one import notification email address.
When should I upgrade to Business or Developer?
Choose Business when you need scheduled auto-imports, saved search rules, unlimited page assignments, CSV export, or team notifications. Choose Developer for REST API access, API keys, rate limiting, webhooks, template overrides, multisite, and client deployments.
Blog Articles & Resources
Tutorials, guides, and strategies for building a high-traffic Ticketmaster events directory on WordPress.
Questions? We're Here To Help
Pre-sales questions, technical support, or custom development — contact the PI Event Master team.
Reply within 24 hours (Mon–Fri)
Join event publishers using PI Event Master to power their Ticketmaster sites.
View Pricing & Buy NowSend Us a Message
Fill in the form below and we'll get back to you within 24 hours.






