Topics

⌘K
  2. Home
  4. Docs
  6. Topics
  8. Tickets
  10. Ticket themes

Ticket themes

FooEvents Ticket Themes allow you to change the way your email tickets look using template sets called Ticket Themes. These can be downloaded from the free Ticket Themes Gallery on the FooEvents website.

Sections #

Adding a New Ticket Theme #

  1. In your WordPress admin area, go to FooEvents > Ticket Themes
  2. Click the Choose File button and find the FooEvents Ticket Theme that you downloaded onto your computer
  3. Click Upload Ticket Theme
  4. If you would like to see what the ticket theme looks like in an email, click on the preview image of the theme and enter an email address before clicking the Send Ticket Preview button

Setting a Ticket Theme #

  1. In your WordPress admin area, click on Products
  2. Edit your event (product)
  3. Click on the Ticket Settings tab
  4. Select the theme in the HTML Ticket Theme and/or PDF Ticket Theme drop-down
  5. Click on Update

Sending a Ticket Preview #

  1. Navigate to FooEvents > Tickets Themes in your WordPress admin area
  2. Click the theme that you would like to preview. The default FooEvents ticket theme is named “Default Ticket Theme” (Replaced the ‘Default 2020’ ticket theme in Nov 2022)
  3. In the text input box, enter the email address where you would like to send the preview and click the “Send Ticket Preview” button
  4. The ticket will then be sent to the email address you specified
  5. Please Note: The ticket data is pre-populated test data and it is not from one of your valid events. Tickets sent via the preview option will not scan using the ‘FooEvents Check-ins’ app, nor will they match any of your generated tickets

  1. In your WordPress admin area, click on Products
  2. Edit your event (product)
  3. Click on the Ticket Settings tab
  4. Upload your logo file in the Ticket logo field. To ensure compatibility with different email formats please be sure to only use a .png or .jpg image.
  5. Click on Update

Changing the Header Image #

  1. In your WordPress admin area, click on Products
  2. Edit your event (product)
  3. Click on the Ticket Settings tab
  4. Upload your logo file in the Header image field. To ensure compatibility with different email formats please be sure to only use a .png or .jpg image.
  5. Click on Update

Modifying a Ticket Theme Template #

  1. Browse to the directory wp-content/uploads/fooevents/themes/
  2. Make a copy of the theme you wish to overwrite e.g. wp-content/uploads/fooevents/themes/[FOOEVENTS-THEME-NAME]
  3. Make changes as required to the files in the new theme directory that you copied

Versions older than 1.7.0:

  1. In your WordPress theme create the following directory structure: fooevents/templates
  2. Copy the template files that you would like to modify from the wp-content/plugins/fooevents/templates directory to the directory that you created in Step 1
  3. Modify the template files as required

Modify the Theme Date Format #

The date displayed on a ticket is the date entered in the event’s individual settings. The format of the date is determined by the WordPress date format.

FooEvents currently supports the default date formats in the English version of WordPress only. Please note FooEvents does not currently support custom date formats.
​
You can change which date format to use here: WordPress admin area > Settings > General
fooevents date format

Please note that after you’ve changed the date format you will have to edit each event, select the event date(s) again and click on “Update” before the date format change will be applied. New tickets that are emailed or existing tickets that are emailed again after this change will display the date in the new format.

Create your own HTML Ticket Theme #

Please refer to the Custom Ticket Themes help guide.

Difference Between Single and Multiple PDF Ticket Theme Templates #

​If you are using the “Single” template and a customer purchases multiple tickets, then each ticket will appear on its own page in the same PDF file. Each ticket will have its own header image, logo and event details. If you are using the “Multiple” template then the event logo and details will appear at the top of the page followed by 3 tickets and then again the event details followed by 3 tickets etc. The idea is that the event details and 3 tickets fit on one page, but if you are displaying a lot of information then these tickets might run over onto the next page. To change this you can either display less information or override the template to remove some of the padding or reduce the font size.

Updating Ticket Themes #

Occasionally, it may be necessary to update your ticket theme/s when the PDF library that FooEvents uses has been updated or when new features have been added.

After updating your ticket themes you must resend tickets if you want attendees to receive the most recent version of the ticket. Resending tickets will also regenerate the PDF ticket files that your customers can download from the “My Account” section on your site.

There are two ways that you can update ticket themes:

Option 1: Update Themes via FTP #

    1. Download the most recent version of the ticket theme/s from the “Downloads” tab in your FooEvents Account, or from the Ticket Themes page.
    2. Connect to your web server via FTP
    3. Navigate to the folder: wp-content/uploads/fooevents/themes *
    4. Make a backup of the FooEvents ticket theme/s that you currently have installed (Note: this is a crucial step if you made any changes to the ticket theme code)
    5. Delete the existing ticket theme folder/s on your server. If you are attempting to update the Default Ticket Theme or Receipt Ticket Theme then please be aware that the FooEvents plugins will recreate these theme folders automatically after you delete them. If you see these folders again after deleting them then you can skip Steps 5 and 6.
    6. Unzip the latest ticket theme ZIP files that you downloaded and upload the theme folder to:
      wp-content/uploads/fooevents/themes *

* Please note that if you have a WordPress multisite setup then you will also need to update the ticket themes in each user’s folder i.e. wp-content/uploads/sites/[User ID]/fooevents/themes

Option 2: Update Themes via the WordPress Admin Area #

    1. Delete the existing ticket theme/s on your server first via FTP
    2. Download the most recent version of the ticket theme/s from the “Downloads” tab in your FooEvents Account, or from the Ticket Themes page.
    3. Copy any custom changes that you may have made to your ticket theme code previously and save them in a temporary text file as you will need to paste these changes back into the new ticket themes
    4. Upload the ticket theme/s through the ticket theme upload interface in the WordPress admin area
      NB: Do not unzip the ticket theme/s (upload the zipped file in its original state). Refer to the Adding a New Ticket Theme section for instructions on how to do this.

Replacing Custom Theme Code #

If you previously made any custom changes to your ticket theme code, you will need to paste these changes into the new ticket theme files. Alternatively, you can copy the updates in the new ticket themes to your current modified ticket theme files. The main changes that you would need to make are copying the code that displays the booking details (if you are using this functionality) and using the new URLs for the logo, barcode, QR code and other images.

Here is a list of the new URL variables that need to be used as the “src” value for the image tags:

      • Logo: $ticket['WooCommerceEventsTicketLogo']
      • Header image: $ticket['WooCommerceEventsTicketHeaderImage']
      • Barcode: $barcodeURL
      • Location icon: $locationIcon
      • Time icon: $timeIcon
      • Ticket icon: $ticketIcon
      • Scissors/Dotted lines: $cut1 and $cut2
      • Divider image: $divider

Removing Ticket Themes #

The only way to completely remove a FooEvents Ticket Theme from your website at the moment, is to delete the theme folder manually through your web hosting control panel software (e.g. cPanel) or via FTP.

Steps to remove ticket themes via FTP #

  1. Connect to your server using your preferred FTP client
  2. Navigate to the folder wp-content/uploads/fooevents/themes
  3. Delete the folder containing the theme you want to remove
Tags , , , , , , , , , , ,