The current version of EE3 is 3.1.36.5.P [ download | view changelog | demo ]

The current version of EE4 is 4.2.8.p [ download | view changelog | demo ]

Add New Event

Add New Event


Event Espresso version 3 Documentation for Adding a New Event

This guide covers all the options within the Add New Event options page.

It is split into three main segments: Basic Details, Sidebar Options, and Advanced Options. Only the core plugin options are covered here, please see the individual Add On documentation to view what additional functionality they provide.

Basic Options

This segment consists of the of the basic event data; description, times and prices.

Event Title: Add a title or name for your event.

Unique Event Identifier: This is system generated but is used in other places such as shortcodes.

Event Description: Add a description of your event. You can use the edit box’s tools to format the text and add images, just like a normal WordPress post.

Event Date/Times

Registration Dates: Add the start and end date for registration. Normally registration ends before the event starts but it can carry over until the event ends. You can set events to Expired when the registration date has gone, in  General Settings.

Registration Times: Not a requirement. If set registration is limited to those times.

Event Dates: When your event starts and ends, can be the same day. Required.

Event Times: What times the event starts and finishes.

Qty: (Quantity) This option will only appear if you have turned on the “Use registration limits on time slots?” option in General Settings. It allows you to allocate a number of tickets to a time slot. Experimental feature.

Add Additional Time: Want to add multiple time slots to day? Click the Add Additional Time button and more fields will appear, this can be done multiple times.

Current Time: Shows you the current time/date format as per WordPress.

Event Pricing

Standard Pricing

Without the WP User Integration (Members) add on, you will just see the Standard pricing system. You can still create multiple prices for each event.

Name 1: The Prices name – this is visible on your website.

Price: The actual price (please include the trailing zeros, e.g. 10.00)

Surcharge: If you need to add an additional cost to the event price, such as a tax, VAT, fuel costs, etc add it here.

Surcharge Type: Determines if the above figure is a percentage of the event price or a figure to add on top of the event price.

Add A Price: Add additional price levels.

Image

Member Pricing

Very similar to the standard pricing you can add multiple member prices.

You must still add a Standard price otherwise it will default to zero (free) for non members. Likewise if you fail to set a price for Members, any logged in users will be able to get the events for free.

The surcharge is automatically applied to the Member price if it is set within the Standard price.

Sidebar Options

The options in the sidebar allow you to tweak your events even more, allowing more flexibility for you and your customer.

New Event/Quick Overview

If this is just a new event, this box will only contain the Submit New Event button, which saves and publishes the event.

If you are editing an existing event, you will see the Quick Overview information, which consist of the Event start date, the current status of the event, how many attendees are signed up and the attendee limit, and a quick link to email all the attendees of the event.

Event Options

Attendee limit: cap how many people can attend, leave blank for unlimited.

Allow group registrations?: This means that one person can buy tickets for a group.

Max group registrations: You can cap how many tickets someone can buy in one go.

Additional Attendee Registration Info?: Do you need to collect question information from everyone in a group or just the buyer? If you need everyone’s, select one of the options available here.

Is this an active event?: The default is yes. If set to no, the event becomes unavailable to users and an expiry message is displayed.

Event Status: Public: live and accessible, Waitlist: used as an overflow for limited capacity events, Ongoing:live and accessible, Draft:live and accessible but has a draft warning, Deleted:removed from the site and the event list. It can still be accessed by filtering the dashboard event list for deleted events, it also remains in the database.

Display Description?: Default is yes, if set to no the event description is hidden when viewed from the site.

Display Registration Form?:  Default is yes, if set to no the registration form is hidden when viewed from the site. Useful when using the Multiple Event Registration add on.

Default Payment Status for Event: If set to anything other than No Change the payments will be set to the appropriate status no matter whether payment has been received or not. Settings are – No Change, Incomplete, Pending, Completed

Alternative Registration Page (optional): Allows you to set an alternative page that the user is directed to when they click on the event, or visit the event registration page directly.

Alternative Email Address (optional): Add an alternative email to send admin notifications to. This can be a comma separated list and include the admin email.

Featured Image

Add a featured image to your event. This is primarily used in the Calendar display if the option to allow images has been turned on. From Event Espresso version 3.1.29 onwards, the Featured image will also display in the event listings page and on the event registration page (individual event page) so long as it is turned on in the Template Settings options.

Featured image

Featured image

Event Category

If you have created Event Categories, you can select which ones the event belongs to. This allows you to list events by category, like you would with normal WordPress posts. The Manage Categories link takes you to the Event Categories setting page.

Event Promotions

Here you can set basic discounts for your event

Early Registration Discount: This is an Early Bird discount, so if a customer registers before a certain date they get a discount applied to their purchase. Only one Early Bird discount can be set per event.

End Date: This is the date when the promotion ends. So if you set this as 1st October, then a customer visiting the site at the start of 1st October (00:00) would not get the discount.

Amount: The discount amount.

Percentage: Is the above figure a percentage or full figure?

Allow Discount Codes?: If you have created discount codes via the Promotional Codes options page, you can allow this event to make use of them. Simply tick the boxes next to the promotional codes listed.

Manage Promotional Codes: A link to the Promotional Codes options page.

Event Questions for Primary Attendee

Choose which question groups need to be shown to the Primary Attendee (the person making the purchase). Note that Personal Information is always required so cannot be de-selected.

Event Questions for Additional Attendees

Choose which question groups are shown for Additional Attendees (group bookings). Note that Personal Information is always required. However, the Additional Attendee question groups do not have to be the same as the Primary Attendees question groups.

Event Staff/Speakers

This is unlocked via the Event Espresso General Settings.

If you have set this up, simply tick the box next to the relevant staff members names and it will show the information in the Event description.

Advanced Options

Additional Event/Venue Information

This section allows you to attach a venue to the event, the details of which can be displayed on both the event registration page, and ticket.

Select from Venue Manager list: Choose from a pre created venue, see the Venue Manager documentation for details.

Virtual Location

This information can be used to add non physical locations, such as for webinars, live chat discussions, online gaming etc

Phone: Phone number of a contact

URL of Event: The web address of the event

Call in Number: Used for virtual events.

Event Meta

Exactly like standard WordPress meta fields, these boxes allow you to add custom information to your events  and used in templates and custom pages.

This extra information can also be displayed in your event listings or registration pages via shortcodes.

The Shortcodes take the form of:

<code>[EE_META type="event_meta" name="my_meta_key"]</code>

The name parameter is the the first box labeled ‘Key‘ and allows the shortcode to identify which meta box is to be displayed; the ‘Value‘ is the actual content you wish to be shown.

If you are using custom templates (moved to the uploads folder) you can add the shortcode directly to the template, this would take the form of:

<?php echo do_shortcode('[EE_META type="event_meta" name="my_meta_key"]'); ?>

Email Confirmation

This section allows you to over rule the default confirmation email on a per event basis.

Send custom confirmation emails for this event?: This must be changed to Yes if you want to over ride the default confirmation email for this event.

Use a pre-existing email?: If you have defined an email in the Email Manager screen you can choose one of those pre-defined emails here. If the option states “No Results” you have not created any emails yet

Create a custom email: If you have not already defined an email you can create a custom email directly in the event.

Emails created in an event will not be available to other events. In order to allow custom confirmation emails to be available to all events, they must be created via the Email Manager screen.

Create a Post

This section allows you to create (or remove) an additional Post or Custom post related to the event. Creating a Post for the event can be very useful, as the events are outside of the normal WordPress loop, so they will not show up in your blog or other feed. By creating a Post, which is in effect a duplicate of the event, you can insert this information into your blog or feed.

Add/Update post for this event?: If changed to Yes, a post will be created when the event is saved or updated.

If no, delete current post?: Once a Post has been created, you can delete it by changing the above option to No and selecting the tick box for this option and updating the event.

Author: Select an author for the post if the site has more than one author. Default is admin

Tags: Add tags to the post, these are the same as the standard WordPress tags and will add to that list. Comma separated.

Post Categories: Select or add a new category for the Post. These are standard WordPress categories and are separate from Event Categories.


Event Espresso version 4 Documentation for Adding a New Event(In Progress)

Add New Event

In order to add a new event you need to click the Add New Event button in the Events menu.

This will take you to the Add New Event page.

This page contains 4 tabs: Add Event, Overview, Import and Default settings.


Please note that if you click anything other than the Add Event tab, you will be taken away from that page and any data entered will be lost.

Event Title – add a title for the event, this is visible on the front end

Permalink – add a custom permalink for the event, if nothing is entered, it will use the event title.

Event Description – this is a standard WordPress editor and you can add a description and format it as well as add images etc.

Event Datetimes – add in the start date, end date, times, and limit for each Event Datetime. An event can have more than one Datetime. Click the “Add Datetime” button to add more Datetimes. Click the ticket icon to assign tickets to a datetime. Click the the copy icon to duplicate a Datetime. Click the garbage can icon to trash the icon.

Available Tickets – enter the price and quantity for each ticket type; click the “Create Ticket” button to add more tickets. Click the gear icon to toggle the advanced options where you can assign a ticket to a date time, set minimum/maximum purchase limits, and set price modifiers.

Image

Name – The name that site visitors will see for this Price.

Description – An internal description for your benefit

Amount – The monetary or percentage amount

Triggered by Date – If set to yes, then the pricing will be subject to dates

Start Date – If the Triggered by Date option has been set, this is the date that pricing will become active

End Date – If the Triggered by Date option has been set this is the date that the price will expire. Please note, if you set the date to January 31st for example, the price will expire at 00:01 January 31st, so the beginning of that day.

Active – is this price in use? If so it will be displayed on the site, if not it will not be displayed.

When a price has been saved, its basic details will be shown. Next to those are two icons: The Cog icon will allow you to edit the price; the Trashcan/Bin icon will delete the price.

Venue Details

The Venue Manager is not available in the “decaffeinated” version of Event Espresso 4.X

Here you can add details of where the event will be held, which will be displayed on the event registration page, and you can even add a Google Map to help visitors find the location.

Venue Information

  • Title – name of the location
  • Website – website for the location if it differs from your own
  • Phone – locations telephone number
  • Image – add a URL to an image to add a logo, picture of the building, staff etc.

Physical Location

This is the address details of the location

Virtual Location

If the location isn’t actually a building or physical place, you can still show information regarding it.

Phone – your contact telephone number

URL of Event – the website, hangout, chat room location

Call in number – a specific number to be used to contact you during the event.

Google Map Link (for email) – details coming soon

Enable event address in Google Maps?

If this is set to Yes, then a Google map is also shown on the registration page. Click here to see documentation about the different options for Google Maps.

Notifications

This area controls how emails are dealt with on an event specific basis. If you don’t need to control the individual events emails, and are happy to use the same ones across all your events, you can happily ignore this section.

There are 3 main emails for the event:

Payment Email

this is sent when payment has been made

Registration Email

This is sent after the user registers regardless of payment status (see the Settings section for an override option) LINK

Resend Registration Email

This is sent via the Attendee Overview section LINK

By default the event will use the emails created in the Messages area LINK, but you can swap these to a custom email by clicking the Switch to Custom Templates button.

When you do this, a pop up will appear and you can create the custom email. This email will only be useable by this particular event and cannot be allocated to another event.

 

Event Registration Options

These control important aspects of the event.

Active Status

Shows the current status for an event. A status will appear as Active, Upcoming, Postponed, Inactive, Sold Out, Expired, or Cancelled. Please see the help tab in the for a list with definitions of the event statuses.

Maximum number of tickets allowed per order for this event

Control how many tickets can be purchased in a single order. If the ticket limit allows, the ticket quantity selector will allow a quantity selection up to what’s set here.

This defaults to 10, which is a change from Event Espresso 3′s default where Allow Group Registrations defaulted to No.
If you set this option to 1 a radio button will appear instead of a ticket quantity selector.

Alternate Registration Page

Takes a URL to a different event. If this is set when the user clicks the link to go to this events registration page, they will be redirected to the alternative URL.

Event Phone Number

Enter a phone number for this event. This field is optional.

Default Registration Status

Select the default registration status for this event only. This will override the global setting that’s set in the Default settings tab. The options are Approved, Not Approved, and Pending Payment. An explanation of each setting can be found in the Default Settings help tab.

Display Ticket Selector

Show the ticket selector or don’t. This can be useful to set to no when registration isn’t required to attend an event.

Questions for Primary Attendee

Here you can select which question groups LINK are shown to the Primary Attendee upon registration. The default Personal Information question group is always selected.

If you have any other question groups created they will show here, and you can select them as necessary.

Questions for Additional Attendees

Just like the questions for the Primary Attendee, here you can select question groups to be shown to the Additional Attendees. These questions are over ruled by the Additional Attendee Registration info? Option above, so even if you select all the question groups here, if the Additional Attendee Registration info? Option is set not to show them, then the will not appear in the registration form.

Event Category

Event categories help you to split up your events into manageable groups. If you have any event categories created you can select them here.


Need more help?

  • Ask the Event Espresso community and our support team questions in the Forums (included with your plugin purchase)
  • Purchase a Priority Support Token and get email support from the Event Espresso Staff (additional fee)
  • Go back to Documentation