Requirements: EventKoi Pro.
Overview
This is the attribute reference for [eventkoi_event_submission]. For how to turn submissions on, choose who can submit, and get notified, see “How to Let Visitors Submit Events in EventKoi Pro.“
[eventkoi_event_submission]Attributes
| Attribute | Type | Default | What it does |
|---|---|---|---|
show_description | bool | yes | Shows the description field. show_summary is an older alias for the same thing. If both are set, show_description wins. |
require_description | bool | no | Makes the description field required. require_summary is the matching older alias. |
show_location | bool | yes | Shows the location field. |
require_location | bool | no | Makes the location field required. |
show_all_day | bool | yes | Shows the all-day toggle. |
show_image | bool | yes | Shows the featured image uploader. |
require_image | bool | no | Makes the featured image required. |
show_calendar | bool | yes | Shows a dropdown letting the submitter choose which calendar the event belongs to. Has no effect if calendar is set to a non-zero ID, see below. |
show_recurring | bool | yes | Shows recurring options. Only actually appears if “Allow recurring submissions” is also turned on in Settings. Both have to allow it. |
show_tbc | bool | yes | Shows a “date and time not confirmed” toggle, which hides the date fields and shows a to-be-confirmed notice instead. |
require_start | bool | yes | Makes the start date required. |
require_end | bool | no | Makes the end date required. |
calendar | int | 0 | Pins every submission through this shortcode to one calendar. When set to anything other than 0, the calendar dropdown never shows, regardless of show_calendar. |
button_label | string | “Submit event” | Text on the submit button. |
hide_after_success | bool | no | Hides the whole form after a successful submission, instead of showing a success message in place. |
success_heading | string | “Submission received” | Heading shown after a successful submission. |
success_message | string | none | Message shown after a successful submission. If left empty, EventKoi fills in a default message depending on whether the event was auto-published or is pending review. |
Examples
- Basic:
[eventkoi_event_submission] - Pinned to one calendar, no picker:
[eventkoi_event_submission calendar="4"] - Require a description and a location:
[eventkoi_event_submission require_description=1 require_location=1] - Custom button and success message:
[eventkoi_event_submission button_label="Add your event" success_message="Thanks, we'll take a look shortly."] - Hide the form after submitting instead of showing a message:
[eventkoi_event_submission hide_after_success=1]
More shortcodes
For the full list of EventKoi shortcodes, see EventKoi Shortcodes Reference Guide: Start Here.