Configure Pro custom fields, calendar subscriptions, and styling

Open the Pro configuration tools

An Administrator can open Events & Bookings > Tools > Configuration to manage activity types, custom fields, and the public calendar subscription. Open Events & Bookings > Tools > Styling for custom CSS.

These screens require the WordPress manage_options capability and active Pro access. Duration choices are a shared Free setting; use the link in Configuration to manage them on the Free Settings screen.

Choose activity types

1. Open Events & Bookings > Tools > Configuration.
2. Under Activity types, enable the types used by the website: Event, Class, and/or Session.
3. Keep at least one type enabled.
4. Select Save configuration.

Disabling a type does not delete existing content. When only one type is enabled, the public activity-type filter is hidden because there is no choice to make.

Add custom fields

Configuration contains separate sections for activities, locations, and teachers. Activity fields apply to Event, Class, and Session records on both one-time and recurring schedules.

1. Open the relevant Custom activity fields, Custom location fields, or Custom teacher fields section.
2. Select Add field.
3. Enter a visible Label.
4. Enter a stable Unique key using lowercase letters, numbers, dashes, or underscores.
5. Choose Text, Textarea, Number, Dropdown, Checkbox, URL, or Date.
6. For a Dropdown, enter one option per line.
7. Enable Required when editors must complete the field.
8. Enable Show on frontend when populated values should appear publicly.
9. Drag fields to set their order.
10. Select Save configuration.

The field then appears in the corresponding activity, location, or teacher editor. Values are validated according to the chosen type. Public values are escaped; URL fields render as external links and date fields use the WordPress date format.

Choose the Unique key carefully. It identifies the stored value. Changing or deleting a definition does not automatically migrate an old value to a new key.

Enable the public iCal subscription

1. In Configuration, find Calendar subscription.
2. Enable Show the Subscribe link.
3. Select Save configuration.
4. Open the public Events page and confirm that Subscribe appears with the calendar views.
5. Download the iCal response and test it in the calendar application your audience uses.

The subscription contains up to 100 public occurrences from now through the next two years. Disabling it removes the Subscribe link and makes the feed unavailable. Individual Google Calendar links remain available when the complete subscription is disabled. The subscription feed requires active Pro access.

Add scoped custom CSS

1. Open Events & Bookings > Tools > Styling.
2. Start each rule with .drecha-events-app when styling the public calendar.
3. Use the reference beside the editor for classes such as .drecha-events-toolbar, .drecha-events-grid, .drecha-event-card, and .drecha-events-empty.
4. Select Save styling.
5. Check List, Grid, Month, and Week views on desktop and mobile.

Custom CSS is loaded after the standard Free and Pro event styles. The editor removes NUL bytes and <style> tags and limits the stored value to 100,000 characters, but it does not validate every CSS declaration. Only trusted Administrators should edit it. Invalid or overly broad CSS can damage the calendar layout or affect other elements that match the same selector.

Understand URLs and translations

The plugin creates or migrates an editable Events page at /events/ and uses individual activity URLs such as /events/{event-slug}/. WordPress controls the saved page and post slugs, permalink base behavior, locale, and translations. Installed multilingual plugins can provide their normal locale URL behavior; Events Pro does not include a separate translation editor.

After changing WordPress permalink or multilingual settings, open the Events page and an individual activity to verify the final URLs. Do not create a second Events page merely to change its visible title; edit the managed page through WordPress.

Free and Pro differences

Free supplies the shared event data, public calendar, duration choices, one-time editor, standard styles, and individual Google Calendar links. Pro adds the Configuration custom-field editor, selectable enabled activity types, complete schedule subscription, and custom CSS screen.

If Pro becomes inactive, definitions, values, and CSS remain stored. Premium configuration screens and the Pro subscription runtime require restored access; ordinary Free event records and standard styling continue.

Troubleshoot configuration and styling

Configuration refuses to save activity types

At least one of Event, Class, or Session must remain enabled. Select one and save again.

A custom field does not appear

Confirm that it has a non-empty Label and a unique valid key, then look in the editor matching its scope. Activity fields do not appear in the Location or Teacher editor, and vice versa.

A custom value is missing publicly

Enable Show on frontend, save Configuration, fill the field on the relevant published record, and update that record. Empty values are not rendered.

Subscribe is missing or returns an error

Confirm that Show the Subscribe link is enabled, Configuration was saved, Pro access is active, and the public page is using the Drecha Events calendar.

CSS changed more than expected

Prefix rules with .drecha-events-app or another listed Drecha selector. Remove broad selectors such as button, a, or div, save, and retest every calendar view.