Title: TributeCity Gig List
Author: themasterpage
Published: <strong>August 4, 2026</strong>
Last modified: August 4, 2026

---

Search plugins

![](https://ps.w.org/tributecity-gig-list/assets/banner-772x250.png?rev=3633566)

![](https://ps.w.org/tributecity-gig-list/assets/icon-256x256.png?rev=3633566)

# TributeCity Gig List

 By [themasterpage](https://profiles.wordpress.org/themasterpage/)

[Download](https://downloads.wordpress.org/plugin/tributecity-gig-list.2.5.6.zip)

 * [Details](https://wordpress.org/plugins/tributecity-gig-list/#description)
 * [Reviews](https://wordpress.org/plugins/tributecity-gig-list/#reviews)
 *  [Installation](https://wordpress.org/plugins/tributecity-gig-list/#installation)
 * [Development](https://wordpress.org/plugins/tributecity-gig-list/#developers)

 [Support](https://wordpress.org/support/plugin/tributecity-gig-list/)

## Description

TributeCity Gig List connects to [TributeCity](https://tributecity.com) so Pro band
accounts can show their current and archived gigs on any WordPress page via a shortcode.

Listings are managed in the TributeCity dashboard. This plugin does not create or
edit shows locally — it only displays data returned by the TributeCity API using
credentials you configure.

#### Features

 * Shortcode-driven gig list and single-show detail views
 * Optional archive view and result limit
 * Settings screen for API token, Band ID, and display options
 * Transient caching to reduce remote API calls
 * Internationalized (translation-ready)
 * Optional credit link (off by default)

#### External services

This plugin connects to the TributeCity service (https://tributecity.com) to display
gig listings for a configured TributeCity Pro band account.

 * What it is used for: fetching current and archived show data and loading poster
   images for display via the shortcode.
 * What data is sent and when: when a visitor opens a page that contains the shortcode,
   the plugin requests gig data from `https://tributecity.com/api/gig` using the
   API token and Band ID stored in your WordPress settings, plus request parameters
   needed to fetch shows (for example gig ID, archive flag, or limit). Poster images
   may load from `https://tributecity.com/media/`.
 * No WordPress site visitor personal data is sent to TributeCity.
 * A TributeCity Pro account is required for the API to return listings. Without
   valid credentials, the shortcode shows an empty-state message.

Service provider: TributeCity (https://tributecity.com)

 * Terms of Service: https://tributecity.com/p/terms
 * Privacy Policy: https://tributecity.com/p/privacy

#### Shortcode

Recommended:

    ```
    [tributecity_gigs]
    ```

Legacy tag (still supported):

    ```
    [tributecity-gigs]
    ```

Attributes:

 * `limit` — Maximum number of shows (e.g. `[tributecity_gigs limit="5"]`)
 * `archive` — Show archived gigs (`[tributecity_gigs archive="1"]`)
 * `gig_id` — Show a single gig (`[tributecity_gigs gig_id="123"]`)

Visitors can open a show’s detail view from the list; that uses a `gig_id` query
argument on the same page.

### Privacy Policy

This plugin stores the following options in your WordPress database: API token, 
Band ID, hide-title preference, and optional credit preference. When the shortcode
renders, those credentials are used to request gig data from tributecity.com. No
visitor emails or site usage analytics are collected by this plugin.

For TributeCity’s own privacy practices and terms, see:

 * Privacy Policy: https://tributecity.com/p/privacy
 * Terms of Service: https://tributecity.com/p/terms

## Screenshots

[⌊Settings screen for API credentials and display options.⌉⌊Settings screen for 
API credentials and display options.⌉[

Settings screen for API credentials and display options.

[⌊Front-end gig list table.⌉⌊Front-end gig list table.⌉[

Front-end gig list table.

[⌊Single show detail view.⌉⌊Single show detail view.⌉[

Single show detail view.

## Installation

 1. Upload the `tributecity-gig-list` folder to `/wp-content/plugins/`, or install 
    the zip via **Plugins  Add New**.
 2. Activate the plugin through the **Plugins** screen.
 3. Go to **TributeCity Gigs** in the admin menu.
 4. Enter your API token and Band ID from the TributeCity Pro dashboard (API Functionality
    manager).
 5. Add `[tributecity_gigs]` to any page or post.

## FAQ

### Do I need a TributeCity account?

Yes. The plugin displays data for TributeCity Pro accounts. Free or non-Pro accounts
will not receive API listings.

### Does this plugin collect personal data?

The plugin stores your API token and Band ID in the WordPress options table. It 
does not collect visitor analytics. Remote requests only fetch show data for the
Band ID you configure. See the External service section above.

### Why is the list empty?

Confirm your token and Band ID, that the account is Pro-enabled for API access, 
and that the band has shows to display. Cached responses expire after fifteen minutes(
filterable for developers).

### Can I hide the band name on the detail view?

Yes. Enable **Hide band name** under **TributeCity Gigs  Settings**.

### Is the “Powered by” link required?

No. Credit is optional and off by default (WordPress.org Guideline 10).

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“TributeCity Gig List” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ themasterpage ](https://profiles.wordpress.org/themasterpage/)

[Translate “TributeCity Gig List” into your language.](https://translate.wordpress.org/projects/wp-plugins/tributecity-gig-list)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/tributecity-gig-list/),
check out the [SVN repository](https://plugins.svn.wordpress.org/tributecity-gig-list/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tributecity-gig-list/)
by [RSS](https://plugins.trac.wordpress.org/log/tributecity-gig-list/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.5.6

 * Security: encode JSON-LD script payloads so API-derived values cannot break out
   of script tags.
 * Directory readiness: include composer.json in the plugin package; document TributeCity
   Terms and Privacy links; explicit sanitize_callback on all registered settings.

#### 2.5.5

 * New: shortcode attribute hide_title=”1″ to omit the list H2 when a theme already
   provides a section heading (avoids duplicate “Upcoming Shows” / “Current show
   listings” on mobile).
 * Admin: About tab shortcode copy-to-clipboard controls; Band ID limited to 10 
   numeric digits.
 * Plugin Check / directory readiness: Tested up to 7.0; scoped template variables;
   prefixed uninstall locals; remove manual load_plugin_textdomain().
 * Plugin author metadata set to TributeCity.

#### 2.5.4

 * SEO: Complete Event JSON-LD offers for Google Search Console (price, priceCurrency,
   availability, validFrom). Free shows and events without a ticket URL now emit
   a full Offer. Add eventStatus and eventAttendanceMode.

#### 2.5.3

 * Fix: Mobile card list posters were cropped/zoomed (`object-fit: cover` + fixed
   min-height). Stacked cards now show the full flyer at natural aspect ratio, matching
   the detail view.

#### 2.5.2

 * Fix: “View details” on post type archives no longer links to the first CPT post
   in the main query (dummy sample tours). List URLs now resolve from the current
   request / archive link.
 * New: optional shortcode attribute base_url for embeds (e.g. homepage teaser  
   tour archive detail links).

#### 2.5.1

 * Limit teasers (`limit="N"`) keep posters and View details; only the archive/current
   toggle stays hidden.
 * Cards without a poster use full width (no empty half-column).

#### 2.5.0

 * Mobile: horizontal padding for titles and main listings; fully responsive cards/
   detail.
 * SEO: semantic section/article markup, MusicEvent microdata, JSON-LD ItemList/
   Event schema for indexing.

#### 2.4.4

 * Detail view: gig title/subtitle line is left-justified.

#### 2.4.3

 * Detail view: Venue Website and Facebook Event Page sit under Event Page (link
   list); Website removed from Details meta.

#### 2.4.2

 * Styling  Font size applies to the interactive archive table (search, rows, pager)
   as well as current listings.

#### 2.4.1

 * Archive table: rows-per-page dropdown (10 / 25 / 50 / All) under the list.

#### 2.4.0

 * Interactive archive table: search, pagination across all archived shows, accent
   show names, hover row states.

#### 2.3.3

 * Archive mode uses a simple table (show, date, location) — no posters or View 
   details.

#### 2.3.2

 * Fix archive view: always show Archived/Current heading; soft-cap archive list(
   24) so the page does not hang on 200+ shows.
 * Keep archive/current toggle when soft-cap is active; detail links work on archive.

#### 2.3.1

 * Cards: hard flex 50/50 with inline styles + object-fit:cover so poster fills 
   its half.
 * Detail view columns also forced to 50/50. Version marker data-tcgl-v for cache
   checks.

#### 2.3.0

 * Cards rebuilt as real HTML tables with inline 50% column widths + critical inline
   CSS.
 * Fixes theme/image intrinsic-size fights that kept columns at ~320/456.

#### 2.2.7

 * Cards layout: table-layout:fixed 50/50 columns (immune to poster intrinsic width).

#### 2.2.6

 * Cards layout: true 50/50 poster and details columns via CSS grid.

#### 2.2.5

 * Force 800px host width against theme .lz-container / .lz-prose constraints.
 * Load public CSS after theme styles; viewport-based breakout fallback.

#### 2.2.4

 * Cards layout uses equal 50/50 poster and details columns.
 * Styling tab: font size selector (Small / Medium / Large / Extra large).

#### 2.2.3

 * Override theme prose/container (e.g. Led Zepplica .lz-prose 720px) to 800px when
   hosting the shortcode.

#### 2.2.2

 * Gig list container set to max-width 800px so card posters render larger.

#### 2.2.1

 * Cards layout: horizontal poster + details on wider screens; full poster (no crop);
   single cards expand to full width.

#### 2.2.0

 * List layout options: Table, Cards (with posters), and Stacked list.
 * Layout works with any visual theme or site-style inheritance.
 * Shortcode override: layout=”table|cards|list”.
 * “Use suggested layout for selected theme” helper on the Styling tab.

#### 2.1.0

 * New Styling tab: inherit site/theme styles or choose a visual override theme.
 * Themes: Classic, Dark Stage, Concert Poster, Clean Minimal, Soft Cards.
 * Split public CSS into structural base + theme stylesheets.

#### 2.0.0

 * Full modernization for WordPress.org compliance (GPL headers, i18n, security).
 * Namespace moved to `TributeCity\GigList`; PSR-4 autoloading.
 * Escaped all front-end output; Settings API sanitization updated for PHP 8+.
 * Admin UI uses core `nav-tab-wrapper` patterns and `manage_options` capability.
 * Conditional asset loading; public CSS only when the shortcode is used.
 * API client: timeouts, HTTP status checks, JSON validation, transient caching.
 * Optional credit link defaulting to off (Guideline 10).
 * Removed incomplete widget placeholder code.
 * Added `readme.txt`, license file, and directory index guards.
 * Version bump; improved shortcode attribute handling and permalink-safe detail
   links.

#### 1.1

 * Previous release: shortcode-based gig list and basic settings.

## Meta

 *  Version **2.5.6**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [concerts](https://wordpress.org/plugins/tags/concerts/)[events](https://wordpress.org/plugins/tags/events/)
   [gigs](https://wordpress.org/plugins/tags/gigs/)[shortcode](https://wordpress.org/plugins/tags/shortcode/)
 *  [Advanced View](https://wordpress.org/plugins/tributecity-gig-list/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/tributecity-gig-list/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/tributecity-gig-list/reviews/)

## Contributors

 *   [ themasterpage ](https://profiles.wordpress.org/themasterpage/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/tributecity-gig-list/)