Skip to main content

Calendar Configuration

Display events in a beautiful, interactive calendar using the [lre_calendar] shortcode.

Overview

The calendar integration uses FullCalendar to provide:

  • Monthly grid view
  • Click-to-view event details
  • Smooth month navigation
  • Mobile-responsive design
  • Multi-day event support
  • Custom theming

Calendar Overview

Basic Usage

Add the calendar to any page or post:

[lre_calendar]

That's it! The calendar displays all events with "Display in calendar" enabled.

Shortcode Attributes

Customize the calendar with attributes:

[lre_calendar theme="dark" height="600px" event_display="link"]

Available Attributes

AttributeDescriptionDefaultOptions
themeColor themedefaultdefault, minimal, dark
primary_colorOverride primary colorAny hex color
event_bgEvent background colorAny hex color
event_textEvent text colorAny hex color
event_displayClick behavioroffcanvasoffcanvas, link, popup, none
popup_idBricks popup template ID (when event_display="popup")Template ID
heightCalendar heightautoauto, 600px, 80vh, etc.
post_typeFilter by post typeallevent, workshop, etc.
taxonomyFilter by taxonomyevent_category, etc.
termsTerms to filter by (requires taxonomy)Comma-separated slugs or IDs
taxonomiesMultiple taxonomy filterPipe-separated groups
idCustom calendar ID for targetingAny string
viewInitial viewdayGridMonthdayGridMonth
classCSS classAny class name

Theme Presets

Default Theme

Clean, professional blue styling.

[lre_calendar theme="default"]

Minimal Theme

Subtle borders, clean aesthetic.

[lre_calendar theme="minimal"]

Dark Theme

Dark background for low-light environments.

[lre_calendar theme="dark"]

Custom Colors

Override theme colors per-calendar:

[lre_calendar primary_color="#e74c3c" event_bg="#ff6b6b" event_text="#ffffff"]

Event Click Behavior

Offcanvas (Default)

Slides in a panel from the side with event details.

[lre_calendar event_display="offcanvas"]

The offcanvas panel shows:

  • Event title
  • Date and time
  • Featured image (optional)
  • Excerpt (optional)
  • "View Event" button
  • Add to Calendar button (if enabled)

Navigates directly to the event page.

[lre_calendar event_display="link"]

Bricks Popup

Opens a Bricks Builder popup template with the clicked event's post as context, so dynamic data tags in the popup resolve against that specific event.

[lre_calendar event_display="popup" popup_id="1234"]

Create a Bricks popup template for your event detail layout, then reference its template ID. The plugin automatically injects the popup template into Bricks' active templates.

Disabled

Events display but aren't clickable.

[lre_calendar event_display="none"]

Calendar Height

Control calendar dimensions:

[lre_calendar height="600px"]
[lre_calendar height="80vh"]
[lre_calendar height="auto"]
  • auto — Expands to fit content
  • Fixed pixel value — Specific height
  • Viewport height — Percentage of screen

Filtering by Post Type

Show events from specific post types:

[lre_calendar post_type="workshop"]
[lre_calendar post_type="event,workshop,class"]

Multiple Calendars

Add multiple calendars with different configurations:

[lre_calendar post_type="workshop" theme="minimal"]

[lre_calendar post_type="meeting" theme="dark"]

Each calendar operates independently.

Global Settings

Configure defaults in Recurring Events → Settings → Calendar:

View Settings

  • Week Starts On: Sunday or Monday
  • Default Height: Auto or fixed
  • Initial View: Starting calendar view

Theme & Styling

  • Theme Preset: Default theme for all calendars
  • Custom Navigation Icons: Upload custom arrow images

Event Display

  • Click Behavior: Default offcanvas/link/none
  • Show Featured Image: In offcanvas panel
  • Show Excerpt: In offcanvas panel
  • Show Time: In offcanvas panel
  • Button Text: "View Event" button label
  • Open in New Tab: Link behavior

Offcanvas Settings

  • Position: Left or Right
  • Width: Panel width (e.g., 400px)
  • Background Color: Panel background
  • Text Color: Auto-calculated for contrast

Default Display

  • Default Display for [Post Type]: Auto-enable calendar display for new posts

Per-Event Colors

Set custom colors on individual events. Colors can be configured in Settings → Calendar.

Event Color

You can change the color headings from here as well.

Calendar UX Features

Today Button

The calendar header includes a "Today" button for quick return to the current month. On the mini calendar (Event Occurrences element), a dot button appears between the navigation arrows when viewing a different month.

Single-Event Day Shortcut (Mobile)

On mobile devices, tapping a day with exactly one event goes directly to the event page instead of showing a list with a single item.

Location in List View

When "Display location" is enabled, the venue name or virtual event label appears beneath the event title in all list views.

Virtual Event Labels

Virtual events display a friendly label such as "Join us online via Zoom" (or whichever platform is configured) in the calendar grid, list view, and offcanvas panel, instead of the raw calendar label.

Taxonomy Filtering

Filter which events appear on a calendar by taxonomy:

[lre_calendar taxonomy="event_category" terms="yoga,pilates"]

Filter by multiple taxonomies using pipe-separated groups:

[lre_calendar taxonomies="event_category:yoga|event_tag:beginner"]

Use the id attribute to assign a custom identifier when placing multiple calendars on the same page:

[lre_calendar id="yoga-cal" taxonomy="event_category" terms="yoga"]
[lre_calendar id="fitness-cal" taxonomy="event_category" terms="fitness"]