Events Calendar Plus (Calendar+) Shortcodes

Requirements

• Events Calendar Plus (Calendar+) version: 1.0.9.
• Purchase the Events Calendar+ Shortcodes add-on (available in the All Access plan or à la carte)
• Download the Events Calendar + Shortcodes add-on from your account page in the Event Espresso Customer Portal.
• Install both Calendar+ and the Shortcodes plugins on your WordPress website.

The Calendar+ Shortcodes plugin for Events Calendar Plus (Calendar+) provides a single, versatile shortcode that renders the Calendar+ interface on any page or post and passes options to Calendar+ via a data-props       JSON payload.

Dependencies

• Required: Events Calendar Plus (Calendar+) plugin active
• Optional: Event Espresso for sourcing events

No additional configuration is required—just insert the shortcode with the attributes you need.

Installation

1. Install and activate Events Calendar Plus (Calendar+), optionally Event Espresso.
2. Upload and activate Events Calendar Plus Shortcodes.
3. Add the shortcode to any page or post (examples below).

Main Calendar Shortcode

[EVENTS_CALENDAR_PLUS]      

This renders the Calendar+ app container and passes options via data-props      . All attributes are optional.

Attributes

• view       — starting view for the calendar. Allowed: month      , week      , day      , agenda      
• expired       — include expired/past events. Allowed: true       / false      
• filters       — quick way to enable multiple filter widgets. Allowed values:
  • true       = show all available filters
  • false       = hide all filters
  • comma-separated list of specific filters, e.g. filters="location,category,search"       Available filters: category      , location      , search      , tag      , venue      
• cat       — pre-filter by category (slug or ID, depending on your Calendar+ setup)
• tag       — pre-filter by tag (slug or ID)
• venue       — pre-filter by venue (ID or slug depending on your data source)

Tip: If you use both filters       and the individual filter-*       attributes, the individual ones will explicitly toggle their respective filter widgets. Using filters="false"       hides all filters unless individually re-enabled with filter-*="true"      .

Examples

Basic calendar:

[EVENTS_CALENDAR_PLUS]

Start in Month view:

[EVENTS_CALENDAR_PLUS view="month"]

Show all filter widgets:

[EVENTS_CALENDAR_PLUS filters="true"]

Hide all filter widgets:

[EVENTS_CALENDAR_PLUS filters="false"]

Show only Location, Category, and Search filters:

[EVENTS_CALENDAR_PLUS filters="location,category,search"]

Equivalent using individual filter toggles:

[EVENTS_CALENDAR_PLUS filter-location="true" filter-category="true" filter-search="true"]

Pre-filter by a Venue (e.g., venue ID 29):

[EVENTS_CALENDAR_PLUS venue="29"]

Pre-filter by a Category (slug or ID):

[EVENTS_CALENDAR_PLUS cat="C2"]

Pre-filter by a Tag:

[EVENTS_CALENDAR_PLUS tag="T1"]

Pre-filter by Tag and enable only the Tag filter widget:

[EVENTS_CALENDAR_PLUS tag="T1" filters="false" filter-tag="true"]

Include expired (past) events:

[EVENTS_CALENDAR_PLUS expired="true"]

Start in Week view with select filters:

[EVENTS_CALENDAR_PLUS view="week" filters="venue,search"]

Lock down the UI to a specific venue and hide all filters:

[EVENTS_CALENDAR_PLUS venue="29" filters="false"]

Combine multiple pre-filters:

[EVENTS_CALENDAR_PLUS cat="workshops" tag="beginner" venue="29" view="agenda"]

FAQ

= Do I need Event Espresso? =

No. This plugin requires Events Calendar Plus (Calendar+). If your Calendar+ configuration is set up to source Event Espresso data, the shortcode works seamlessly with it.

What does the shortcode output? =

A <div id="calendar-plus" class="calendar-plus" data-props="...">       container. Calendar+ reads the JSON in data-props       to configure itself (filters, view, pre-filters, etc.).

Can I combine the filters       attribute with filter-*       attributes? =

Yes. filters       provides a bulk on/off or a quick list; filter-*       gives you explicit control over individual widgets.

= What are valid values for view      ? =

month      , week      , day      , agenda      .

= How do I pass multiple filters in filters      ? =

Use a comma-separated list with no spaces or with spaces (both work), e.g. filters="location,category,search"       or filters="location, category, search"      .