Settings

Settings#

Configure the plugin from Events > Settings. Settings are organized into eight tabs: General, Display, Tickets, Check-in, PDF Tickets, Google Maps, Emails, and Advanced.

General tab#

Date & Time Options#

Date Format Date format for event dates. Uses PHP date format characters. Defaults to your WordPress date format.

Time Format Time format for event times. Use g:i a for 12-hour or H:i for 24-hour. Defaults to your WordPress time format.

Default Timezone Timezone for new events. Defaults to your WordPress timezone. Can be overridden on each event.

Pages#

Events Archive Page Optional. Pick a page to use as the main events archive instead of the default archive.

The event URL base is not on this tab. Set it on Settings > Permalinks under Event Permalinks > Event base. Default: event.

Display tab#

Display Options#

Events Per Page Number of events on archive pages, shortcode listings, and grids. Default: 12. Range: 1 to 100.

Show Past Events Include past events in archive pages and calendar views. Default: off.

Default Calendar View Initial view for the calendar shortcode: Month, Week, Day, or List. Default: Month.

Countdown Timers

Show countdown to event start on single event pages. Default: on.
Show countdown to ticket sales start/end. Default: on.

Single Event Page#

Content Display Checkboxes for which sections appear on single event pages. All default to on:

Show location/map section on event pages
Show seat selection section on event pages
Show speakers section on event pages
Show social share buttons
Show “Add to Calendar” buttons

SEO & Schema#

Structured Data Add Event schema markup (JSON-LD) to event pages. Default: on.

Tickets tab#

Ticket Options#

Waitlist Enable waitlist by default for new ticket products. Default: off.

Waitlist Offer Expiry Hours a customer has to buy after a spot opens. 0 means no expiry. Default: 24.

Attendee Information Collect individual attendee details during checkout. When on, customers enter a name and email for each ticket. Default: off. Can also be turned on per product.

Default Min Tickets Minimum tickets per order. Default: 1.

Default Max Tickets Maximum tickets per order. Default: 10.

Default Persons Per Ticket How many people each ticket admits. Default: 1.

Waitlist Options#

Auto Notifications Automatically notify the next person on the waitlist when a spot opens. Default: on.

Ticket Code Format#

Ticket Code Prefix Short prefix added to all ticket codes. Default: EMWC. Example: EMWC-ABC12XYZ.

Code Length Characters in the unique part of the code: 6, 8, 10, or 12. Default: 8.

Check-in tab#

Check-in Options#

Sound Feedback Play a sound on successful or failed check-in. Default: on.

Auto Clear Automatically clear the check-in result. Default: off.

Clear Delay Seconds to show the result before clearing. Default: 5. Range: 2 to 30.

Multiple Check-ins Allow checking in the same ticket more than once, for re-entry events. Default: off.

Access Control#

Login Required Require users to be logged in to access check-in. Default: on.

Allowed Roles Checkboxes for each user role on your site. Default: Administrator and Shop Manager.

PDF Tickets tab#

Ticket Appearance#

Primary Color Color used in ticket headers and buttons. Default: #2563eb.

Ticket Content#

Display Options

Show venue address on tickets. Default: on.
Show QR code on tickets. Default: on.

QR Code Size Small (100px), Medium (150px), Large (200px), or Extra Large (250px). Default: Medium.

Footer Text Text at the bottom of tickets. Default: “Present this ticket at the event entrance for check-in.”

Tickets are generated as printable HTML pages. Customers use the browser print function to save them as PDF.

Google Maps tab#

Google Maps API#

Google Maps API Key Required for maps. Enable both the Maps JavaScript API and the Geocoding API in Google Cloud Console.

Default Zoom Level 1 is world view, 20 is building level. Default: 15.

Map Height Height in pixels. Default: 300. Range: 200 to 600.

Map Style Standard, Silver, Retro, Dark, Night, or Aubergine. Default: Standard.

Display Options

Show map on single event pages. Default: on.
Show “Get Directions” link below maps. Default: on.

Shortcode Usage#

Use [emwc_venue_map id="123"] to show a venue map anywhere. Replace 123 with the venue ID.

Emails tab#

Email Sender Options#

“From” Name Sender name for event emails. Defaults to your site name.

“From” Email Sender address for event emails. Defaults to the admin email.

Email Notifications#

Registration Email Send a registration confirmation email to attendees. Default: on.

Reminder Email Send an event reminder email to attendees. Default: on.

Reminder Timing Days before the event to send reminders. Default: 1. Range: 1 to 30.

A Manage Email Templates in WooCommerce button links to WooCommerce > Settings > Emails, where each event email has its own enable toggle, subject, heading, and settings. The emails are:

Event Registration Confirmation
Event Ticket Delivery
Event Reminder
Event Update Notification
Event Cancellation
New Event Registration (Admin)

The reminder cron runs daily and uses the Days Before Event value saved on the Event Reminder email in WooCommerce. The Reminder Timing field on this tab is not used by the cron.

Advanced tab#

Feature Toggles#

Seating Charts Enable seating chart management. Default: off.

Speakers/Presenters Enable speaker management. Default: on.

API Options#

REST API Enable REST API endpoints. Default: on.

Webhooks Enable webhook notifications. Default: on.

Calendar Export Enable iCal/ICS export for events. Default: on. When on, the Calendar Feed URL is shown here so users can subscribe in their calendar app.

Data Management#

Attendee Data Retention Number of days attendee data is kept after an event ends. 0 means keep forever. The field shows 365 until you save it. This value appears in the suggested privacy policy text under Settings > Privacy; the plugin does not delete attendee records on its own.

Max Recurring Instances Maximum occurrences generated for recurring events. Default: 52. Range: 1 to 365.

Debug Logging Write debug information to WooCommerce > Status > Logs. Default: off.

Uninstall Behavior Delete all plugin data when uninstalling. Default: off. When on, deleting the plugin removes all events, attendees, tickets, and settings.

System Status#

Read-only table showing the plugin, WordPress, WooCommerce, and PHP versions, whether debug mode is on, and whether the Google Maps API key is configured.

Product settings#

Ticket settings live on each product under Product data > Event Ticket: event selection, quantity limits, sales dates, attendee fields, and pricing rules. See Ticket Sales.

Saving settings#

Click Save changes at the bottom of a tab. The button is active once you change something. Each tab saves separately.

Resetting settings#

There is no reset button. To restore a default, clear the field or pick the default option and save.

Settings API#

Settings are stored as WordPress options:

// Get a setting
$events_per_page = get_option( 'emwc_events_per_page', 12 );

// Update a setting
update_option( 'emwc_events_per_page', 20 );

Setting keys#

Key	Description
`emwc_events_per_page`	Events Per Page
`emwc_default_calendar_view`	Default Calendar View
`emwc_event_slug`	Event base (Permalinks page)
`emwc_google_maps_api_key`	Google Maps API Key
`emwc_ticket_code_prefix`	Ticket Code Prefix
`emwc_enable_reminder_email`	Reminder Email
`emwc_reminder_days_before`	Reminder Timing
`emwc_enable_seating_charts`	Seating Charts toggle
`emwc_enable_debug_mode`	Debug Logging

Permissions#

The Events menu and its settings page require the manage_woocommerce capability. By default, Administrators and Shop Managers can access them.