Events Calendar Plus (Calendar+) Shortcodes
Requirements
- Events Calendar Plus (Calendar+) version: 1.0.9.
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
,agenda
expired
— include expired/past events. Allowed:true
/false
filters
— 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
filters
and 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"
.