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


  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"    .

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.