TicketSource Events User Guide

TicketSource Events lets you display TicketSource event dates on your WordPress website and allow visitors to book tickets from the event page.

What The Plugin Does

• Connects WordPress to your TicketSource account.
• Displays upcoming public event dates using a shortcode.
• Shows booking buttons for dates that are on sale.
• Opens the TicketSource checkout inline on desktop where supported.
• Opens TicketSource booking in a new window on mobile devices.

Before You Start

You will need:

• An Administrator account for your WordPress website.
• A TicketSource API key.
• A Smudge Hosting license key.
• At least one TicketSource event with an event reference set in TicketSource.

The plugin is designed to work best with YooTheme-based WordPress sites. If your site uses a different theme, the layout may need checking after setup.

Installing The Plugin

1. Log in to your WordPress admin area.
2. Go to Plugins > Add New Plugin.
3. Click Upload Plugin.
4. Choose the TicketSource Events ZIP file.
5. Click Install Now.
6. Once installed, click Activate Plugin.

Connecting TicketSource

1. In WordPress, go to Settings > TicketSource.
2. Enter your TicketSource API Key.
3. Enter your License Key supplied by Smudge Hosting.
4. Click Save Changes.
5. Check that the License Status shows Active.

The TicketSource API key is required before event dates can be displayed.

Preparing An Event In TicketSource

1. Log in to TicketSource.
2. Create or edit the event you want to show on your website.
3. Find the event reference field in the event's advanced settings.
4. Add a clear reference, such as summer-concert or christmas-show.
5. Save the event.

You will use this reference in the WordPress shortcode.

Adding Event Dates To A Page

1. In WordPress, open the page or post where you want the booking options to appear.
2. Add this shortcode, replacing the reference with your own TicketSource event reference:

[ticketsource_event reference="your-event-reference"]

3. Save or update the page.
4. View the page on the front end of the website.

Example:

[ticketsource_event reference="summer-concert"]

How Event Dates Are Displayed

The plugin only shows dates that are:

• Upcoming.
• Public.
• Not cancelled.
• Still on sale, or not yet on sale with a visible on-sale date.

Past dates and dates where ticket sales have ended are not shown.

Booking Behaviour

On desktop, visitors can click Buy Tickets to open the TicketSource checkout on the page. They can also choose Open in new window.

On mobile, visitors are sent to TicketSource in a new window for a smoother booking experience.

License And Updates

The plugin uses a license key to receive automatic updates.

If the license status is Active, WordPress can show plugin updates under Dashboard > Updates or Plugins.

Before updating, make sure your website has a recent backup. Then update the plugin in the same way you would update any other WordPress plugin.

Troubleshooting

If the page says TicketSource API key not configured, go to Settings > TicketSource and save the correct API key.

If the page says No event reference provided, check that the shortcode includes the reference value.

If the page says Event not found, check that the event reference in the shortcode matches the reference saved in TicketSource.

If no dates appear, check that the TicketSource dates are public, upcoming, not cancelled, and still on sale.

If the layout does not look right, check the page using the site theme or page builder, especially if the site is not using YooTheme.

If updates are not appearing, check Settings > TicketSource and make sure the license status is Active.