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
- Install and activate Events Calendar Plus (Calendar+), optionally Event Espresso.
- Upload and activate Events Calendar Plus Shortcodes.
- 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,agendaexpired— include expired/past events. Allowed:true/falsefilters— quick way to enable multiple filter widgets. Allowed values:true= show all available filtersfalse= 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
filtersand the individualfilter-*attributes, the individual ones will explicitly toggle their respective filter widgets. Usingfilters="false"hides all filters unless individually re-enabled withfilter-*="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" .