How to Change Wording and Text with POedit

It is often useful to be able to change the text or wording of something in Event Espresso in order for it to fit in with your site and audience better. You can hunt through the code to find the strings (text) to replace but there is a much easier and recommended way: use Poedit to change the language files.

What happens is you take the language file (in this example we will work with US English) and translate it, in order to change the text.

1) We recommend downloading and installing Poedit for working on translation files.

2) After you install Poedit, you can download a copy of the event_espresso-en_US.po file from our GlotPress project. Then you can open it in Poedit.

3) Use the Find tool to pull up the text string you need to modify.

4) Change the string as shown:

poedit

5) Save, then upload the newly generated .mo file to the wp-content/uploads/espresso/languages directory on your server.

6) Keep a copy of the modified language files saved somewhere in case you need to re-edit it or re-upload it.

Changing text strings by using a plugin or a custom function

If you know the exact text string you need to re-word, you can alternatively use the Quick Localisation plugin that can be downloaded here for free:

http://wordpress.org/plugins/quick-localization/

Quick Localisation

Or you can add a custom function to your theme’s functions.php file, the custom_functions.php file that is included with Event Espresso’s Custom Files add-on (EE3 only), or your own custom site specific plugin. Example code follows:

Posted in | Comments Off on How to Change Wording and Text with POedit

Known Third Party Plugin & Theme Conflicts

The Event Espresso team develops using best practices and follows WordPress coding standards, in order to limit any conflicts caused by our plugin. Other third party plugins have been known to cause issues with Event Espresso, due to varying reasons, so we have listed all known conflicts here.

Most of these plugins, themes, etc issues have been brought to our attention via the community or in limited cases by our own testing.

Whilst we try to keep this list up to date we cannot guarantee how up to date it is.


Have You Found a Conflicting Plugin/Theme?

If you would like to add something to this list, please post to our support forums. Be sure to describe your issue clearly and provide helpful links.

If you are the developer of one of these plugins/themes and feel it should not be listed here, please contact us, as per above, and advise.

Plugins

404 Redirected

Turn off the automatic redirect/force current permalinks setting

Accordion Shortcodes

Breaks TinyMCE editor in Event Espresso 4 events and venues editor screens

All In One WP Security & Firewall

Uncheck both settings that break the CSV report feature.

  • WP Security > Firewall > Additional Firewall Rules > Bad Query Strings > Deny Bad Query Strings (uncheck to deactivate)
  • WP Security > Firewall > 6G Blacklist Firewall Rules > Enable legacy 5G Firewall Protection (uncheck to deactivate)


Advanced Custom Fields Pro

Conflicts with the datetime and ticket editor’s date & time fields. The following code snippet can be added to remove the conflicting script:

add_filter('acf/settings/enqueue_datepicker', '__return_false');

You can add the above to a functions plugin or, if available, into your WordPress child theme’s functions.php file.

Bad Behavior

The Bad Behavior is a plugin that is used on a lot of WordPress sites, and it does a great job of blocking communication from other sites. In practice, that’s a good thing, except when you’re expecting to receive communication from other sites like PayPal so you can receive an instant payment notification.

If you’d like to continue using Bad Behavior and receive IPN notifications from the payment gateway, you can whitelist the IP addresses of the payment gateway’s servers, and keep an eye on the Bad Behavior logs to stay up to date in case the payment gateway adds or changes the IP addresses they use to notify your site.

If you activate the Bad Behavior plugin, you can look at the log of blocked IP addresses under Tools>Bad Behavior log. Look for all blocked records that are associated with the payment gateway, and copy the IP addresses from the payment gateway’s servers and paste them into the Bad Behavior whitelist.

Divi Booster

Breaks the Event Espresso admin pages. You can fix the conflict by going to the Divi Booster plugin’s settings page, then look under “Page Builder”. Then you uncheck the box for “Enable Page Builder for posts and custom post types” and save.

Events Made Easy

Breaks the Event Espresso registration process

EventON (CodeCanyon)

Conflicts with Event Espresso 4 as it uses the same events page slug ‘events’ by default. This can be changed via myEventON -> Settings -> Events Paging

Juiz Social Post Sharer

Workaround: Disable Display counter of sharing? setting to avoid JavaScript errors when using the Safari browser

Log Emails

Breaks the venue editor and contact editor routes in the EE4 admin. Symptom “Cannot Load espresso_venues”. We recommend to use this plugin instead: WP Mail Logging.

Magic Liquidizer Responsive Table

Breaks the EE4 ticket selector when selecting tickets on mobile browsers

Memphis Documents Library

EE4: Highjacks the session resulting in “Nothing in Your Event Queue” and “Your form data could not be applied to any valid registrations” errors. You can set its “Disable Sessions” option (check the box) on the Memphis Docs > Options > Settings page like so:

Participants Database
Changes the timezone for times displayed on events. There’s a solution outlined here:
https://xnau.com/date-shifting-and-other-timezone-related-issues-in-participants-database/

Shortcodes Ultimate

Shortcodes Ultimate will remove the standard WordPress auto formatting and replace it with its own custom formatting. This will alter the appearance of the registration pages because it adds paragraph and break tags into the markup. Workaround: You go to the Shortcodes Ultimate settings page and set the option where you can disable its custom formatting. When you disable the custom formatting it will no longer add the extra paragraph and break tags everywhere.

Shortcodes Ultimate setting

Themify Portfolio Posts plugin

Breaks the venue editor route. Error message is “Cannot load espresso_venues” when saving a venue post.

Web 2.0 Directory

Breaks the Registrations CSV report feature

WEN’s Responsive Column Layout Shortcodes

Causes a problem with EE4’s checkout notification pop ups. Poorly targeted JavaScript strips out the P tags from our messages making them blank.

WordPress SEO by Yoast

Strips away Venue information from venue pages in Event Espresso 4. You can work around this if the Facebook and Twitter meta tags features are disabled. Alternatively you can set a custom excerpt on each Venue.

WP E-Commerce

The main WP query object gets destroyed by WP E-commerce during the pre_get_posts hookpoint. This is a known issue and reported elsewhere in the WordPress.org forums. We found a workaround that involves adding a little function to your custom functions.php file or into a site specific plugin:

function callback_that_does_nothing( $WP_Query ) {
    return $WP_Query;
}
add_action( 'pre_get_posts', 'callback_that_does_nothing', 8 );

Under normal circumstances the above code does nothing, however, when WP Ecommerce destroys the WP Query object, the above code will restore said object.

WP SpamShield

Workaround: Use the “Disable anti-spam for miscellaneous forms” setting to allow registrations to process.


Themes

Divi (Elegant themes)
You can set the Blog Style Mode to “Enable” to allow content from the events to display on the event list page.

PageLines
The Footer Scripts setting needs to be enabled so registration checkout works in Event Espresso 4.
From your WordPress dashboard (WP-admin), go to PageLines Settings and then click on Advanced in the menu and then place a checkmark in the Footer Scripts setting and save changes by clicking on the Save Changes button.

Note about ThemeForest:

Whilst we do not like to generalize, we must mention that we receive a lot of theme related issues due to themes purchased via Themeforest. This is not to say that all themes there are bad, but it is merely an observation that we feel you should be aware of.

Support Forum threads tagged with “themeforest”

3 Clicks (Themeforest)
Removes Event Espresso content from the single event posts. The solution is add this to your functions file

Central (Themeforest)
Breaks the javascript loading, making things only work intermittently. source. One possible fix is to turn off Page Transitions in the theme settings.

Driveme (Themeforest/jthemes)
Recommended to avoid because this theme:
Disables all plugin updates
Flushes rewrite rules on init

Purity theme (Themeforest)
Breaks registration process

Accent (Themeforest)
Breaks the calendar
Update: No longer available from Themeforest

Denoizzed (Themeforest)
Breaks the confirmation page due to using position:fixed on its grid system.

YellowProject Multipurpose Retina WP Theme (Themeforest)
Breaks toggle, datepicker and basically anything else that uses jQuery in the wp-admin

Fudge (Showthemes.com)
JavaScript conflicts
Januas (Showthemes.com)
Januas theme issue 1: JavaScript conflicts caused by the removal of the bundled version of the jQuery library. Recommended fix: Always use WordPress bundled version of the jQuery library. You can remove this code found in the /lib/januas.php file from the januas_enqueue_scripts() function:

wp_deregister_script('jquery');
wp_register_script('jquery', get_stylesheet_directory_uri() . '/lib/scripts/jquery-1.8.3.js');

Januas theme issue 2: Januas breaks the Event Slug option for Event Espresso. You can fix this by adding the following to a custom functions plugin, or a child theme’s functions.php file:

add_action('after_setup_theme', 'my_fix_januas_theme_breaking_ee_event_slug' );
function my_fix_januas_theme_breaking_ee_event_slug(){
    remove_filter( 'FHEE__EE_Register_CPTs__register_CPT__rewrite', 
        'januas_ee_event_slug', 
        10
    );
}

Then if you haven’t already done so, go to Event Espresso > Events > Templates and you can now change what’s set for the Event Slug option.


Hosting

Yes even your hosting environment can cause issues! If the servers are not set up correctly, or are overly restrictive, issues with Event Espresso and other themes and plugins can occur.

Not recommended:

  • GoDaddy Hosting
  • Yahoo
  • Crazy Domains (Australia)
  • HostPapa – forced server level caching with no option to disable or white list pages
  • most Windows/IIS based servers

Please see our list of recommended hosts here: https://eventespresso.com/requirements/

Posted in | Comments Off on Known Third Party Plugin & Theme Conflicts

Social Coupons Integration (formerly Groupon)

Did your site get featured on Groupon.com or LivingSocial.com? Do you need to use one-time use coupon codes? Now you can easily accept coupon codes for Groupon, LivingSocial, and many other systems for your events!

View quick links for this add-on –> 


Need to Buy a Support License for the Social Coupons Integration?
https://eventespresso.com/product/espresso-groupon/

Installation

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

This add-on is a plugin for WordPress and can be installed through your WP dashboard (WP-admin).

Download the latest version of the Social Coupons integration for Event Espresso 3 from your Event Espresso account.

Then login to your WordPress dashboard (WP-admin) and go to Plugins. Next, click on Add New –> Upload and browse to the plugin on your computer. Then select the zip file and begin the upload process. Wait for the plugin to upload and then click on Activate.

Setup and Configuration

Login to your WP dashboard and go to Event Espresso –> Groupon Codes.

This page (Manage Groupon Codes screen) shows all available coupon codes.

Usage

The Social Coupons integration will allow you to offer your registrants/attendees one-time use coupons for their event registrations.

When a coupon code is used it applies to all tickets in the order, so you’ll need to be sure to set the attendee limit to the number of tickets the deal is good for.

Create a One-time Use Coupon Code

Step 1: Browse to the Groupon Codes Screen
Begin by going to WP dashboard (WP-admin)) and go to Event Espresso –> Groupon Codes.

Image

Step 2: Click on Add New Groupon Code
On the next screen, click on the Add New Groupon Code button.

Image

Step 3: Enter the Details of the Coupon Code
Groupon Code – This is the actual one-time use code that an attendee/registrant will use.
Groupon Status – Set to Active unless you want to create an inactive coupon code.
Groupon Holder – Add a description for this code (e.g. spring promotion).

Then save changes.

Image

Step 4: Enable Social Coupons Codes for an Event
Go to Event Espresso –> Events Overview. Now locate your event and click on it. Then scroll down the page and look towards the right side of the screen for the Groupon Options widget. Set the Allow Groupon codes option to Yes and save changes to this event.

Image

When a code is redeemed, a 100% discount will apply toward the payment of the event and the registrant will receive a registration confirmation.

Managing Used Coupon Codes & Reporting

You can verify whether a code has been used by navigating to the Manage Coupon screen:

Image

The redeemed coupon code will display in the individual attendee payment record:

Image

Uploading Bulk Social Coupon Codes

Need to upload a large amount of social coupon codes at once? Our Voucher Import Tool (Coupon Codes Import Tool) can help you with that. Learn more about the Voucher Import Tool for Event Espresso 3.

Troubleshooting

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

The coupon code applies a 100% discount. Can that be changed?
Each coupon code created by the Social Coupon integration will create a one-time use coupon code that applies a 100% discount to the current balance due for any event registrations.

Customizations

Our support team cannot write custom coding for you. Below are some examples on customizing this add-on.
  • None at this time — check back soon!
Need to Buy a Support License for the Social Coupons Integration?
https://eventespresso.com/product/espresso-groupon/

Posted in | Comments Off on Social Coupons Integration (formerly Groupon)

Volume Discounts

Everyone loves a discount and it’s one of the best ways to help move tickets. What better way than to offer a discount on multiple ticket purchases. The Volume Discount add on does just that.

Choose from a variety of options including, discounts based on the number of tickets bought and discounts based on the total monetary amount.

Requirements
The Volume Discount add-on, only works when the Multiple Event Registration add-on is activated. It will not function correctly without it. Also, Volume Discounts can only be applied through the Multi Event Registration cart. Please see this guide for step by step instructions on how to use an ‘Add to Cart’ link instead of the default registration form.

Set up:

Download and install the Event Espresso Volume Discount (free for a limited time!) add-on from your account page. You will need to sign up to the Pre Release channel first.

Determining Factors

Start off by heading over to the Volume Discounts menu page. Here you will find various options to set your discounts at. These options help you set when the discount is applied.

Discount Based on:

Total Dollar Amount: If the ticket price reaches a certain amount, the discount is applied. For example, you set this at $500 and the tickets are $100 each, when 5 tickets are bought they trigger the discount.

Number of Registrations: Works only when you have allowed group registrations. Please make sure that the maximum number allowed for group registrations is the same or higher than the number set for this.

An Event Meta Field: Selecting this option will display further fields: the Event Meta Field and the Default meta field value. To use, set a default meta field value, lets say 4, and a discount threshold, lets say 24. In that example, a user would need to buy 6 tickets (24 divided by 4) to hit the discount threshold. By adding the Event field meta value into an meta field in an individual event you can over ride the default meta field value. For example, using the same figures, in an event you add a meta field that matches the one in the volume discount settings and give it a value of 8, the user will only need to buy 3 tickets for that individual event to enable the discount threshold.

Discount Threshold: This will either by the monetary amount if you have chosen Total Dollar amount above, or the number of registrants if you have chose Number of Registrations above.

The Actual Discount

This determines how much discount is applied and how.

Discount Amount: The value of the discount.

Discount Type: Whether the above figure is a percentage discount or a monetary discount.

Discount applied message: Customise the message that appears when the discount threshold kicks in.

Event Categories

The Volume Discount add on works alongside the Event Categories. By selecting a category you can limit and focus the discounts on core areas. If you want the discount to apply to everything or if you do not use categories, please make sure All Categories is ticked.

Posted in | Comments Off on Volume Discounts

Multiple Event Registration Add-on

The Multiple Event Registration add-on adds a shopping cart feature on your site. It will allow your attendees/registrants to purchase or register for multiple events with only one checkout process needed!

View quick links for this add-on –> 


Need to Buy a Support License for the Multiple Event Registration Add-on?
https://eventespresso.com/product/espresso-multiple/

Installation

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

This add-on is a plugin for WordPress and can be installed through your WP dashboard (WP-admin).

Download the latest version of the Multiple Event Registration add-on from your Event Espresso account.

Then login to your WordPress dashboard (WP-admin) and go to Plugins. Next, click on Add New –> Upload and browse to the plugin on your computer. Then select the zip file and begin the upload process. Wait for the plugin to upload and then click on Activate.

Setup and Configuration

You will not see any new WordPress administration menus for the add-on.

Usage

The Multiple Event Registration add-on will create a shopping cart experience on your site. Your registrants/attendees will be able to add several events to a shopping cart and then complete registration checkout once (instead of once per event).

Multiple Event Registration - spot the difference

Spot the difference!

The events on the event listing page will receive an add to cart link as shown in the image above.

Registration Checkout Workflow

After adding an item to the cart, your attendees/registrants will be shown the View Cart link on any event in the list that they have added. Clicking the View Cart link link will then take them to the cart confirmation page where they can select the number of tickets / pricing options they want, remove events they no longer want, and proceed to registration checkout.

The stop sign (red icon) in the top right corner of each event will remove the event from the shopping cart when clicked.

Multiple Event Registration - view cart

You may notice here that the customer can select multiple amounts of the same type of ticket! This is determined by the Max Group Registrants number in the individual events, so in the case above its set to 6.

This can be used to your advantage – by setting numerous pricing options in an event, your customers can buy various ticket types in varying numbers, allowing a greater degree of flexibility for you.

Need to collect information from all attendees/registrants? Go to WP-admin –> Event Espresso –> Event Overview. Now locate your event and click on it and you’ll be brought to the event editor. Towards the right area of the screen, you’ll see the Event Options widget. Look for the option for Additional Attendee Registration Info and set it to Full registration information. Then save changes to your event.

Using the MER Add-on with Single Event Pages

By default the Multiple Events Registration add-on will not affect single event pages. If you enable the add-on and browse to a single event page, then you’ll still see the registration form. You can change an event to use the shopping cart from the add-on in a few steps.

1) Login to your WordPress dashboard. Then go to Event Espresso –> Events Overview. Locate your event in the list and click on it.

2) You’ll now be viewing the event editor. Towards the right side of the page, you see an area for Event Options. Locate the Display registration form option and set it to No.

3) Add the shortcode below to the end of the event description area.

[ESPRESSO_CART_LINK]

Here is an alternative shortcode that will immediately take a registrant/attendee to the cart after they click on the link:

[ESPRESSO_CART_LINK anchor='Register for this Event' direct_to_cart=1 moving_to_cart='Redirecting to cart...']

4) Then save changes to your event.

Examples of Add to Cart Shortcodes

Most of the following shortcodes can be used on a WordPress page or post. Some shortcodes can only be used in the event description area.

  • Default shortcode; can only be used in the event description area
    [ESPRESSO_CART_LINK]
  • Create a Register link that will redirect to the shopping cart after being clicked; can only be used in the event description area
    [ESPRESSO_CART_LINK direct_to_cart=1 moving_to_cart='Redirecting to cart...]
  • Create a Register for this Event link that will add an event with an ID of 1 to the shopping cart
    [ESPRESSO_CART_LINK event_id=1 anchor='Register for this Event']
  • Create a link that will add multiple events to the shopping cart; Link text will say “Register for this Event”
    [ESPRESSO_CART_LINK event_id=1 anchor='Register for this Event']
  • Create a Register link for an event with an ID of 123 that will redirect to the shopping cart after being clicked
    [ESPRESSO_CART_LINK event_id=123 direct_to_cart=1 moving_to_cart='Redirecting to cart...']

Add to Cart Shortcode Parameters

anchor='text for link' (Specify the text for the add to cart link; default is Register)
event_id=1-2-3 (Specify the numeric IDs of the event(s) that should be added (e.g. 1-2-3 will add an event with an ID of 1, an event with an ID of 2, and an event with an ID of 3).
direct-to-cart=1 (Set to 1 to redirect an attendee/registrant to the shopping cart after they click the link)
moving_to_cart='text for message' (Specify the text that should be shown when the redirect to shopping cart begins)

Troubleshooting

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

Where is the menu screen for this add-on?
This plugin does not create any new menus in the WordPress admin screen. It can be used by adding a shortcode to a WordPress post or post. Please see the documentation in the usage section on this page.

I’m seeing a warning above my event pages.
Ensure that your Event Espresso software including core plugin and all add-ons are up to date. Then turn off WordPress debugging by changing a macro in your wp-config.php file.

Customizations

Our support team cannot write custom coding for you. Below are some examples on customizing this add-on.
  • None at this time. Check back soon!
Need to Buy a Support License for the Multiple Event Registration Add-on?
https://eventespresso.com/product/espresso-multiple/

Posted in | Comments Off on Multiple Event Registration Add-on

How to use the Custom Files to Create a Drop Down List of Recurring Events

This basic tutorial will show you how to create a dropdown menu for your recurring events. It can quite easily be used for your standard events as well!

What will be needed?

  • Event Espresso
  • Recurring Event Manager (REM) add-on
  • Custom Files add-on
  • Ability to edit a few files

 

Getting Started

The plugins above should be installed and activated.

Installation

The Custom Files add-on is not a plugin and should be unzipped and copied to your uploads/espresso/ directory using your preferred SFTP or FTP client. Cyberduck and FileZilla are two free options.

Start by creating some events using REM so that you have the correct number of recurring events that you need.

Next, create a new WordPress Page and add the following shortcode to it:

[EVENT_CSS_DROPDOWN]

Feel free to add other text and images as you feel fit.

Now we need to modify some files.

Download the css_dropdown_display.php and css_dropdown.php files from your server and open them in a text editor like Notepad, Notepad++ (not Word or any other Word Processor program)

css_dropdown_display.php

There’s not much in this file which is great.

<a title="<?php echo stripslashes_deep($event_name)?>" class="a_event_title" id="a_event_title-<?php echo $event_id?>" href="<?php echo $registration_url; ?>"><?php echo stripslashes_deep($event_name)?></a>

Change it to

<a id="a_event_title-<?php echo $event_id?>" class="a_event_title" title="<?php echo stripslashes_deep($event_name)?>" href="<?php echo $registration_url; ?>"><!--?php echo stripslashes_deep($event_name)?--> - <!--?php echo $start_date; ?--></a>

This will add the start date to the end of the events so you can tell them apart.

css_dropdown.php

A little bit more code here but the change we will make is really easy. On line 37 you will see this

extract(shortcode_atts(array('category_identifier' => 'NULL','show_expired' =>; 'false', 'show_secondary'=>'false','show_deleted'=>'false','show_recurrence'=>'false', 'limit' =>; '0', 'order_by' => 'NULL', 'template_name'=>'css_dropdown_display', 'button_text'=>'Choose an Event'),$atts));

Where it says

'show_recurrence'=>'false'

change it to say

'show_recurrence'=>'true'

Save these files and upload them to uploads/espresso/templates/css-dropdown and overwrite the existing files (or rename those existing files first to keep them as backups)

Now go to the page you made on your site (e.g. yoursite.com/dropdown) and you will see the drop down menu. Clicking it will show your recurring events with their start date and clicking one will take you to the events registration page.

the dropdown menu

Shortcode Attributes

[EVENT_CSS_DROPDOWN] 

[EVENT_CSS_DROPDOWN limit=1] 

[EVENT_CSS_DROPDOWN show_expired=true] 

[EVENT_CSS_DROPDOWN show_deleted=true] 

[EVENT_CSS_DROPDOWN show_secondary=true] 

[EVENT_CSS_DROPDOWN show_recurrence=true] 

[EVENT_CSS_DROPDOWN category_identifier=your_category_identifier] 

[EVENT_CSS_DROPDOWN limit=5 show_recurrence=true category_identifier=your_category_identifier]

Need to see the code in action?

Here is a copy of the modified files based on Custom Files 3.1 Download

Posted in | Comments Off on How to use the Custom Files to Create a Drop Down List of Recurring Events

Custom Email Tags

For customized confirmation emails, the following tags can be placed in the email form and they will pull data from the database to include in the email.

Custom email tags can only be used in the custom emails for Event Espresso 3 and will not work on WordPress pages and posts.
Shortcode Displays
[registration_id]
Registration ID
[fname], [lname]
First and Last name of the attendee
[event]
Name of the event
[event_link]
Name of the event, hyperlinked to the event URL
[event_url]
Hypertext link to the event URL
[ticket_type]
The ticket, or price option selected
[ticket_link]
Link to download ticket (ticketing add-on required)
[ticket_qty]
Used to display the number of tickets purchased (ticketing add-on required)
[qr_code]
A scannable QR code image (ticketing add-on required)
[description]
The description of the event as entered in the event editor
[cost]
The cost of the registration
[company]
Organization name as set in General Settings
[co_add1],[co_add2]
Organization address info
[co_city],[co_state],[co_zip]
Organization city, state, zip
[contact]
Primary contact email address as set in General Settings
[payment_url]
Link to view payment options/information
[invoice_link]
Link to download invoice (must have invoice option enabled)
[start_date], [start_time]
The start date and time of the event
[end_date], [end_time]
The end date and time of the event
[event]
Name of the event
[location]
The address of the venue
[location_phone]
The phone number of the venue
[google_map_link]
A link to view the venue location in Google Maps
[venue_title]
The name of the venue (Venue manager enabled)
[venue_address]
The address of the venue (Venue manager enabled)
[venue_url]
A link to the venue’s web page (Venue manager enabled)
[venue_image]
Venue image (enter a valid image URL in venue manager)
[venue_phone]
Venue phone number (Venue manager enabled)
[custom_questions]
Lists all the questions and answers from the reg. form
[meta_key]
The value of the specified meta key from the Event Meta
[seating_tag]
This email tag will display the seat tag, seat, and row. It is used for the Seating Chart add-on for Event Espresso 3.
[attendee_event_list]
A table of the attendee and event information
[question_Form question]
Displays a specific question from the registration form. Usage: If question is titled What is your weight, shortcode would be [question_What is your weight]. The question title and text after question_ must be exactly the same.
[answer_Form question]
Displays a specific answer from the registration form. Usage: If question is titled What is your weight, shortcode would be [answer_What is your weight]. The question title and text after answer_ must be exactly the same.
[add_to_calendar]
Adds the iCal link to your emails, allowing users to download an .ics file to import into iCal, Google Calendar and others calendar applications.
[edit_attendee_link]
Adds a link to the email message that allows the recipient to edit their registration info they filled out in the registration form.

Posted in | Comments Off on Custom Email Tags

Template Settings

The Template Settings options page allows you to control some of display options for your events, styles and customised templates.

Template Options

Display short descriptions in the event listings?: Allows the use of the short description in the event listings. By using the “More” tag in your event description you can limit what is

shown in the short description. Either type the following <!--more--> in the HTML tab after the text you want to display or use the more button.

Template Settings - more tag

Display event descriptions in the multiple event registration pages?: Same as above but for multiple event registration via the Multiple Event Registration add on.

Display addresses in the event listings?: Shows the address in the event listings.

Display the address in the registration form?: Shows the venue’s address. Note: Disable the address if you are using the venue manager shortcodes in your event description.

Use the custom post types feature?: Allows the use of the built-in Custom Post Type – Events. This will create a page of custom posts for all of your events. The Espresso Calendar can be set up to point to a post/page or directly to the event registration page by setting the Link to Post option to “Post”.

  1. Use the pre-made CPT templates (post-type-samples) that are located in the Event Espresso plugin directory. Copy the files from the ‘event-espresso/post-type-samples’ directory into your current theme directory. WordPress will then recognize the ‘page-event_list.php’ as a page template.
  2. Create a new page and assign it the “Espresso Events” template in the Page Attributes section. This will create a list of “Event Posts” page, once we have some CPT events.
  3. In the page Event Espresso > Template Settings > Use the custom post types features? select ‘Yes’ in the drop down. That enables the Custom Post Types feature.
  4. Create a new (or edit an existing) event.
  5. Under the Create a Post section, select ‘Yes’ to Add/Update post for this event? Then select ‘Espresso Event’ for the Post Type field.
  6. Go to WP Admin > Settings > Permalinks and “Save Changes” to flush the rewrite rules


Important!

The Espresso CPT uses the slug “events”, so if you enable the Custom Post type option there cannot be a published page with a page slug of “events”.


Display an “Add to my Calendar” icon/link in the event templates?: Default is yes. This will add a small icon (which can be changed in the templates) to allow a user to download an .ICS file which can be imported into numerous calendar programs such as iCal and Google calendar. See here for an How To to add the ics file to Google Calendar.

You can also add the iCal link to your emails by using the [add_to_calendar] shortcode.

iCal Example

iCal Example

iCal on the Registration Page

iCal on the Registration Page

Display featured images in the event list and registration pages?:  Default is no. When activated any image added as the featured image in the Event editor will be displayed on the registration page (the single event listing  and the Event list. The image can be modified via both CSS and the template files.

Version Requirement

Add to Calendar and Display featured images are only available from Event Espresso version 3.1.29 onwards.

Template Settings - template options

Template Settings – template options

Stylesheet Options

Currently Event Espresso provides two ways of styling the forms and plugin output: Legacy styles and Themeroller styles.


Legacy Styles

PLEASE DO NOT USE THESE UNLESS NECESSARY.

Legacy styles are for users still running older versions of Event Espresso and should not be used on newer versions of the plugin.

Removed by default since version 3.1.28.

Enable Legacy style sheets?: Turns on Legacy styles.

Remove the legacy style sheets option?: Completely removes the Legacy styles options from the dashboard.

Select Base stylesheet: Use a base stylesheet.

Select Optional colors: Select another stylesheet for additional colors.

Menu Guide - Template Settings - stylesheet options

Themeroller Styles

Themeroller is the preferred method of styling your Event Espresso forms and output.

Use Themeroller Style Sheets: Activate Themeroller.

Themeroller Style: Select a style for your forms.

Add a custom stylesheet: Upload a custom stylesheet.

Developers Only

The best way to modify Event Espresso template files is to copy them from your event-espresso/templates folder to uploads/espresso/templates.

This section lists which files have been copied over.


Menu Guide - Template Settings - developer only

Posted in | Comments Off on Template Settings

Promotional Codes

This guide explains how to use promotional/discount codes within Event Espresso 3.

As of Event Espresso 3.1.36 promotion codes can be either ‘Global’ or ‘Non-Global’.

Promo code builder

The Promotion/Coupon manager allows you to add/edit promotional codes. These codes need to exist before a registrant can use it during the registration process.

  • Promotional Code – This is actually the code that will be required for the registrant to receive the discount. The promotional code input here needs to be unique.
  • Price Discount – This is the amount that will be used to calculate a discount amount.
  • Is this a percentage discount? Y/N – This tells the system whether the price discount amount will reduce the price by a percentage amount or a whole dollar amount. If you want it to be a discount, select Yes. If you want the discount to be a whole dollar amount, select No.
  • Global (Apply to all events by default) Y/N – This tells the system if the promo code is to be available to all events that are accepting promo codes by default or only event’s which you specify to use that code. If you select Yes the promo code will be classed as global, selecting No will class the promo code as non-global.



The promotion codes do not expire with time or with use. If you are looking for coupons which do expire, you can try the Social Coupon integration which can be used to provide single use ‘100% discount’ codes.

Event editor promo code options

You can enable promo codes within the event editor using the ‘Event Promotions’ box in the side bar. Each event will allow a choice of 4 promotion code options:

  • ‘No Promo Codes’ – The event does not allow the use of any promo codes.
  • ‘Only Global Promo Codes’ – Allows all promo codes that have been classed as global to be used within the event.
  • ‘Global Promo Codes and Specific Ones’ – Allows all global promo codes and also allows you to select non-global codes which can used within the event.
  • ‘All Promo Codes (even Non-Globals)’ – All promo codes, regardless of type will be available for use within the event.


If you are using Multiple Event Manager, the cart by default does not allow codes to be used. You can turn on this feature by going to General Settings and changing the “Allow discounts in the shopping cart?” option to Yes and saving your settings.

As of Event Espresso 3.1.29.1, the promotional codes discount each ticket purchased, rather than the total of the tickets purchased which happens in versions prior to 3.1.29.1.

Also if you are looking to provide bulk discounts, we have the Volume Discount add-on.

Posted in | Comments Off on Promotional Codes

Question Groups

This section allows you to create groups of questions which can be displayed on your registration forms. A group must contain at least one question and if a question is not assigned to a group it cannot be shown on the registration form.

By default Event Espresso comes with two question groups: Personal Information and Address Information. The Personal Information group is required by the plugin and cannot be removed, and is added to every single event.

menu guide - question groups - manage question groups

Add New Group

There are two sections that need to be filled out in order to create a new group: Group Information and Add Questions.

Group Information

Group Name: Add a name for the overall group.

Group Order: Here you can numerically set the order of the question groups. A setting of 1 (one) will place it at the top.

Group Identifier: This will be created automatically after the group has been made.

Description: Add a description to help users understand the questions context, reason for those questions, more information, etc. Note: Personal Information will always be the first question group.

Show group name on registration page?: If ticked the group name will appear above the questions from that group.

Show group description on registration page?: If ticked the group description will appear above the questions from that group.

Add Questions

This section lists all the questions that have been created, including the core questions. Simply tick the ones that you want included within this question group.


menu guide - question groups - add new question group

Add Group

To finalize the question group, click the Add Group button.

Question Group List

Below the Group creation area is a list of all Question Groups created. You can quickly edit or delete Question Groups from this area. You can drag and drop the question groups here (or on the Manage Question Groups overview page) to change the order that the question groups are displayed on the registration page.

Posted in | Comments Off on Question Groups

Event Espresso