Ticketing Add-on Documentation

This add-on requires Event Espresso 3.1.33 or newer. It cannot be used with old versions of Event Espresso 3.

New to the ticket template editor? Learn how to  create a basic custom ticket

---

In most cases the basic template should suffice. It will display details of the event, including the map, QR code, and Gravatar. However, in case you want to do some advanced editing, we have provided a list of shortcodes which you can use to customize your template files. These shortcodes  cannot be inserted into the text area in the ticket editor. 

Your templates are located in  wp-content/espresso-ticketing/templates

If you are making changes to the templates, then everything in this folder should be copied to  wp-content/uploads/espresso/tickets/templates

You can then insert shortcodes into the PHP file and create your own templates, without having to worry about them being overwritten when you update the ticketing add-on.

HTML template tags

Attendee/Event Information

[att_id]
[qr_code]
[gravatar]
[event_id]
[event_identifier]
[registration_id]
[registration_date]
[fname]
[lname]
[event_name]
[description]
	

Payment details

[cost]
[ticket_type]
[ticket_qty]
	

Organization details

[company]
[co_add1]
[co_add2]
[co_city]
[co_state]
[co_zip]
	

Dates and times

[start_date]
[start_time]
[end_date]
[end_time]
	

Ticket information

[ticket_content]
	

Logo

[ticket_logo_url]
[ticket_logo_image]
	

Venue information

[venue_title]
[venue_address]
[venue_address2]
[venue_city]
[venue_state]
[venue_zip]
[venue_country]
[venue_phone]
[venue_description]
[venue_website]
[venue_image]
[google_map_image]
[google_map_link]
[seatingchart_tag]
	

Custom Questions and Answers Template Tags

The custom questions and answers can also be output using shortcodes. To use this feature, you will need to wrap the custom question text with ‘[answer_’ and ‘]’ within your HTML file.

Example:

[answer_A bunch of stuff]

[answer_This is a question]

[answer_Use any custom question you like]
	

Event Meta Template Tags

If you have added event meta to your events, and would like to display the values in the tickets templates. Just use the key names of the event meta to display the values, by adding square brackets (‘ [‘ and ‘]‘) around the key names.

Here is an example:

Create a Ticket Template Workflow

Lets take a look at an example of how to create a ticket template and enable it for an event. This example of will be ticketing for a rock gig (rock concert). The following will be needed for this tutorial:

• Support license for Event Espresso 3
• Ticketing add-on for Event Espresso 3
• iPad, iPhone, or Android app (free mobile apps)
• Apple iPad users (click here for install instructions)
  • Please install the Event Espresso Espresso JSON API Add-on to connect your iPad app to your server.
• Apple iPhone and Android Users (click here for install instructions)
  • Please install the Event Espresso Espresso JSON API Add-on to connect your iPad app to your server.

Now lets get started on this ticketing guide for Event Espresso 3.

Step 1: Install and Activate needed Add-ons
Ensure that the Espresso JSON API add-on in installed and activated on your site. Also ensure that the Ticketing add-on is installed and activated on your site.

Step 2: Create Your Event
Go ahead and create your event using the event editor. If you need help creating your event, then take a look at this example of how to create an event using Event Espresso 3.

My event is a gig for a rock band called Chicken Toes.

Step 3: Create your Ticket
To create a ticket navigate to  WP-admin –> Event Espresso –> Ticket Templates –> Add New. Then follow these steps:

1. Ticket Name – Enter the name of your ticket here. This is what will display in your event editor screen’s ticket template selector.
2. Select Stylesheet – Various styles are available. Select one here.
3. Select a Template – Various templates are available. Select one here.
4. Add a Logo – Click on Upload Image to upload an image that will be used on your ticket. Browse to an image on your computer, select it and begin the upload. Then click on the Insert into Post button.
5. Ticket Description/Instructions – Use this field to enter information that will be displayed on an attendees/registrants ticket.

Step 4: Attach Ticket Template to an Event
Browse to  Event Espresso –> Event Overview and click on your event. You’ll then be brought to the event editor with information for your event.

Scroll through the meta boxes on the right hand side until you find the Custom Tickets meta post. Select your ticket from the dropdown menu.

Step 5: Add to Confirmation Email
Add the ticket link to your registration confirmation email. You can find this under Email Configuration at the bottom of the event editor screen. Choose to use a custom confirmation email.

Create your custom confirmation email and insert the [ticket_link] shortcode.

You can also add the [qr_code] shortcode. This will display the QR code in the email so attendees can simply print the email, or show it on their smartphone to get entry to events.

Select Update Event.

Now when your attendees register, they’ll get an email with a QR code and link to their ticket.

Step 6: Set up Ticketing App
It’s now time to set up your iPad, iPhone, or Android smartphone with one of our mobile apps. Download and install the app on to your smartphone.

Enter your website’s address (URL), WordPress dashboard (WP-admin) username, and password.

Once you’re logged in you’ll see a list of your events.

Step 7: Start Processing!
You’re now ready to start processing your attendees. Touch the event to start scanning QR codes.

The app will scan your attendees tickets, and let you know if their ticket is valid.

It will also automatically update your attendee list in the WordPress dashboard. Once you have scanned an attendee’s QR code, the person will be marked as having attended and will not be able to use that code again.

If anyone tries to use a ticket a second time it will be flagged up as declined. This prevents duplicates from being used.

You’re now ready to use your very own smartphone as a powerful piece of ticketing processing technology. How awesome is that?!

Troubleshooting

The plugin will not activate. Can you help?
Are you running a current version of Event Espresso 3?

I can’t login to the mobile app!
Please ensure that Event Espresso 3, the Ticketing app, and the Espresso JSON API add-on are up-to-date. Next, be sure that you are using the Event Espresso HD App. User roles of Administrator and Espresso Master Admin are the only roles that can login to the mobile apps.

My attendees are not receiving a ticket link in their registration confirmation emails.
Did you add the ticket link shortcode to the event registration confirmation email? If not, take at the tutorial shown earlier in this article.

Customizations

• Learn how to create a basic custom ticket

---

---