Form settings

To edit your form’s settings go to Events > Event Form Submissions, select the appropriate form and click “Edit Form”.

Form customiser, settings tab

General settings

These appear under the Settings tab.

Name

This allows you to give the form a recognisable name to distinguish it from any other submission forms you may create. It is not used for any other purpose.

Title

This is the title of the event form, displayed just above the form itself.

Event Status

When events are submitted, which status should they be allocated. If you want to publish events immediately you should select publish. If you want to an admin to approve submissions before they published you should select pending. Alternatively you may assign any custom status you’d like to.

Redirect after submission

Where to send the user after successfully submitting an event. You can return them to the form with a confirmation message (see below), or alternatively select a page you’d like to send them to.

Confirmation message

If you are returning the user to the form after successfully submitting an event, this confirmation message will appear above the form.

Allow guest submissions

Whether to allowed logged-out users to submit events.

Guest organiser

If logged-out users can submit an event, select a user to be assigned as the “event organiser”. In practise this means which user owns the event in the admin, and can edit the event details. (Typically users with admin roles can edit events and posts they do not own anyway).

Error & notice classes

Provide the CSS class to user for error messages. If you theme users a particular class for error messages, this will help the form fit in with your chosen theme.

The notice CSS class is the same, except for notice classes.

Notification settings

These settings appear under the Notifications tab, and relate to post-submission notifications.

Form customiser, notifications tab

Notify admin

Whether to notify the site admin of a submission. You can alter the e-mail address used with the option below.

Admin email

The site admin’s email, solely for the purposes of submission e-mails (see above).

Send confirmation email

Whether a confirmation e-mail should be sent to the submitter. This is sent to the submitter immediately after a successful submission (and not when the event is published, if time of these differ).

You can alter the subject and content of the e-mail with the options below

Confirmation e-mail subject

The subject of the confirmation e-mail sent to the submitter.

Confirmation e-mail

The content of the confirmation e-mail sent to the submitter.

This can contain placeholder tags, which include:

Submitter details

Details of the individual who submitted the event

  • %submitter_display_name% – Submitter’s display name
  • %submitter_first_name% – Submitter’s first name
  • %submitter_last_name% – Submitter’s second name
  • %submitter_email% – Submitter’s email
  • %submission_date% or %submission_date{format}% where format is replaced by PHP date format.

Event details

Details of the submitted event

  • %event_id% – The event ID
  • %event_title% – The event title
  • %event_url% – The event’s url
  • %event_start_date% or %event_start_date{date-format}{time-format}% – The event start date of the event. Optionally provide the date-format and time format (using PHP date format).

    //Format date in '18th February 2012' format. No time format.  
     %event_start_date{jS M Y}%
    
    //Format date in '18th February 2012 at 1:30pm' format. 
     %event_start_date{jS M Y}{ at g:i:a}% 
    
    //Format date-time as given in WordPress' general settings. 
     %event_start_date% 
    
  • %event_end_date% or %event_end_date{date-format}{time-format}% – The end date of the event. If the event reoccurs this will be the end date of the first occurrence.

  • %event_last_start_date% or %event_last_start_date{date-format}{time-format}% – The start date of the event’s last occurrence

  • %event_last_end_date% or %event_start_date{date-format}{time-format}% – The end date of the event’s last occurrence

Venue details

Details of the event’s associated venue (if any):

  • %event_venue% – the name of the venue
  • %event_venue_url% – the URL of the venue
  • %event_venue_address% – the (first line of the) venue address
  • %event_venue_city% – city of the venue
  • %event_venue_state% – state of the venue
  • %event_venue_postcode% – postcode of the venue
  • %event_venue_country% – country of the venue

Other

  • %event_meta{meta-key}& or %event_meta{meta-key}{delimiter}% – the value of the custom field (post meta) with the specified meta-key, for the submitted event. (E.g. the meta-key supplied to a field in the form). If you expect multiple values (e.g. from checkboxes), you should pass a delimiter as the second argument (e.g. see below).

     //Assume values for 'colours' are "red", "blue" and "green".  
    
     //Used without a delimiter, returns "red"
     %event_meta{colours}%
    
    //Used with space delimiter, returns "red blue green"
     %event_meta{colours}{ }%
    
    //Used with " and " delimiter, returns "red and blue and green"
     %event_meta{colours}{ and }%