The frontend submission form is the heart of this plugin — it’s what your visitors actually see and fill in. It’s designed to feel effortless: clear labels, sensible field order, and built-in validation so incomplete or malformed events never reach your calendar.

Displaying the Form

Add this shortcode to any page, post, or widget-ready area:

[xylus_event_submit_form]

Note: the older alias [eec_event_submit_form] also works and renders the exact same form, in case you’ve already used it elsewhere.

Customizing a Single Form with Shortcode Attributes

Need one page to behave differently from your global settings — say, a dark-themed form on one landing page, or a page that publishes instantly instead of holding for review? Add attributes directly to the shortcode. These override your global Settings for that specific instance only.

Attribute	Example	What it does
theme	theme="dark"	Renders a dark-mode version of the form on this page only.
status	status="publish"	Overrides the default post status (pending, draft, or publish) just for this page.
guest	guest="no"	Overrides whether logged-out visitors can submit on this page.
redirect	redirect="https://example.com/thank-you"	Sends the user to a custom URL after a successful submission instead of showing the default success message.
class	class="my-custom-form"	Adds your own CSS class to the form wrapper for further custom styling.

Example — a dark-themed, instantly-published form for VIP members:

[xylus_event_submit_form theme="dark" status="publish" guest="no"]

Tip: The admin Shortcode settings tab has a one-click “Copy” button for the base shortcode and shows you a live list of every page currently using it — see the Shortcode Reference page.

What Information Can Users Submit?

• Event Title & Description: A rich text editor for a compelling, fully formatted event write-up.
• Date & Time: Friendly date/time pickers for the start (and end, where supported) of the event.
• Featured Image: Users upload a cover photo that becomes the event’s featured image once approved.
• Organizer & Venue: Users can pick from your existing organizers/venues or, if you allow it, add a brand-new one on the spot.
• Source ID (optional): A technical field, hidden by default, used when migrating or de-duplicating events from an external system — see Settings: General.
• Terms & GDPR checkboxes (optional): Shown only if you’ve enabled them under Settings: Compliance.

Smart Behaviour for Logged-In vs. Guest Users

The form adapts automatically to who’s viewing it:

• Logged-in users: Name and email are skipped entirely — the event is linked straight to the submitter’s WordPress account, which also makes it show up on their personal “My Submissions” page.
• Guests (if allowed): They’ll see extra Name and Email fields so you always know who to contact about their event. Guest submissions never appear on a “My Submissions” page, since there’s no account to attach them to.

Built-In Protection (Always On)

Every submission — regardless of your Anti-Spam settings — is automatically checked for a valid security token, a hidden honeypot field, and a minimum fill-in time before it’s accepted. You don’t need to configure anything for this baseline protection; it just works. See Settings: Anti-Spam & Security for the optional extra layers you can turn on.