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 Upload Ticket Theme button, then Choose File/Browse button and find the FooEvents Ticket Theme that you downloaded onto your computer
  3. Click Upload
  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.

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 the WordPress Admin Area #

Similar to how you update WordPress plugins, you can update existing ticket themes in the Ticket Themes section of your WordPress admin area.

Before you update your ticket themes, please note:

  • Make a backup of the ticket theme(s) you currently have installed, especially if you have made any customizations to the ticket theme code.
  • If you previously made changes to the ticket theme code, you will need to reapply those changes to the updated version, or copy the new updates into your modified version.

Follow these steps to update your ticket themes:

FooEvents Ticket Theme Update

  1. Download the most recent version of the ticket theme(s) from FooEvents Account > Downloads.
  2. In your WordPress admin area, go to FooEvents > Ticket Themes.
  3. Click the Upload Ticket Theme button, then click the Choose File or Browse button and select the ticket theme ZIP file that you downloaded.
  4. Check the Overwrite ticket themes with matching folder names setting. This will ensure that the existing theme files are replaced with the updated files.
  5. Click Upload. A confirmation message will appear, warning that the original ticket theme files will be overwritten. Click OK to continue

You need to upload the ticket theme ZIP file. Some browsers automatically unzip files when downloading themes, so if you only see an extracted folder on your desktop, you will need to compress it into a ZIP file before uploading it. Also ensure that the ZIP file name matches the original folder name (for example, admission_ticket_theme.zip).

Once done, confirm the latest version is reflecting:

FooEvents Ticket Theme version number

Option 2: Update Themes via FTP #

    1. Download the most recent version of the ticket theme(s) from FooEvents Account > Downloads.
    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

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

Articles

Tags , , , , , , , , , , ,