Settings

Configure the plugin from Events > Settings. Settings are organized into tabs for easy navigation.

General tab

Event display

Events Per Page Number of events shown on archive pages. Default: 12.

Default Calendar View Initial view when loading calendars:

• Month View
• List View

Events URL Slug URL base for events. Default: events. Change requires permalink refresh.

Date Format How dates display. Options follow WordPress date formats.

Time Format How times display. 12-hour or 24-hour format.

Event defaults

Default Event Status Status for new events. Default: Scheduled.

Default Event Type Type for new events. Options:

• In-person
• Virtual
• Hybrid

Default Timezone Timezone for new events. Defaults to WordPress timezone.

Registration tab

General settings

Enable Registration Master switch for ticket sales and attendee tracking.

Order Status for Tickets Which order status creates attendee records:

• Processing
• Completed
• Both

Capacity settings

Track Capacity Enable capacity limits on events.

Show Remaining Spots Display how many spots are left on event pages.

Capacity Warning Threshold Percentage at which to show "Almost full" message.

Check-in settings

Allowed Roles Which user roles can access check-in:

• Administrator
• Shop Manager
• Custom roles

Allow Check-out Enable check-out functionality for re-entry tracking.

Display tab

Single event page

Show Countdown Display countdown timer on event pages.

Show Map Display Google Map for venue (requires API key).

Show Organizer Display organizer information.

Show Speakers Display assigned speakers.

Show Related Events Display related events at bottom of page.

Archive page

Layout Style

• Grid
• List

Columns Number of columns for grid layout.

Show Past Events Include past events on archive pages.

Social features

Enable Social Sharing Show social share buttons on event pages.

Share Platforms

• Facebook
• Twitter/X
• LinkedIn
• Email

Enable Add to Calendar Show calendar buttons for adding events.

Maps tab

Google Maps API

API Key Your Google Maps API key. Required for map display.

Map Style Visual style for maps:

• Standard
• Silver
• Retro
• Dark
• Night
• Aubergine

Map display

Default Zoom Initial zoom level. Default: 14.

Map Height Height of maps in pixels. Default: 300.

Notifications tab

Event reminders

Enable Reminders Send reminder emails before events.

Reminder Days How many days before to send. Default: 1.

Reminder Time Time of day to send reminders. Default: 9:00 AM.

Admin notifications

Enable Admin Notifications Notify admins of new registrations.

Admin Email Email address for notifications. Multiple addresses separated by commas.

Notification Frequency

• Every registration
• Daily digest
• Weekly digest

Export tab

iCal settings

Enable Calendar Feed Allow subscription to event calendar.

Feed URL The URL for calendar subscriptions (read-only display).

CSV export

Include Past Events Include past events in CSV exports.

Default Fields Which fields to include in exports.

Webhooks tab

Active webhooks

List of configured webhooks with:

• Name
• URL
• Triggers
• Status
• Actions (edit, delete, test)

Add webhook

Button to create new webhook. Opens webhook configuration form.

See Webhooks for details.

WooCommerce integration

Some settings are in WooCommerce:

Email settings

WooCommerce > Settings > Emails

Event-related emails:

• EMWC Registration Confirmation
• EMWC Ticket Delivery
• EMWC Event Reminder
• EMWC Event Update
• EMWC Event Cancellation
• EMWC Admin New Registration

Each email has:

• Enable/disable toggle
• Subject line
• Heading
• Template customization

Product settings

Event ticket settings are on individual products:

Product Data > Event Ticket tab

• Event selection
• Quantity limits
• Sales dates
• Attendee fields
• Dynamic pricing

Saving settings

Click Save Changes at the bottom of any settings tab. Changes take effect immediately.

Resetting settings

To restore defaults:

• Go to the relevant tab
• Clear fields or select default options
• Save changes

There is no "reset all" button to prevent accidental data loss.

Settings API

Access settings programmatically:

// 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

Permissions

Settings require the manage_options capability. By default, only Administrators can access settings.

To allow other roles:

add_filter( 'emwc_settings_capability', function( $cap ) {
    return 'manage_woocommerce'; // Allow Shop Managers
} );