My Calendar Views – Overview

Grid

The grid view is the most traditional calendar layout option. By default, it’s a table with either five or seven columns for the days of the week. Each cell contains headings with the time and title of the events on that day, ordered by start time.

The title can be customized using the Display Settings for “Event title (Grid)”.

Grid view with seven columns, one event opened with minimal details.
Grid view showing seven days

List

The list view is organized the same way as the grid view. Each day is represented by a list item containing the events for that day. The list view has two different interaction options: using the date as a toggle to view the events on that day, or showing the event titles by default, and using the event titles to toggle the details for that event.

The title in list view can be customized using the Display Settings for “Event title (List)”. Enable the event titles view by checking “Show events in list view” under the “List Options” section on the same settings page.

List view showing event titles.
List view without titles. Current day expanded.

Mini/Compact

The mini or compact calendar uses a compact grid like the main grid calendar, using the current date as a toggle to show details for all events on that date.

Mini calendar; nothing expanded.

Script Options

The grid, list, and mini all support two options for interactions: a disclosure widget and a modal. These are configured at Design > Scripts. The screenshots above show the disclosure widget, which varies somewhat from view to view. The pop-up is largely the same for all views, except that some views show multiple events and others show only one.

Grid view with modal popup showing one event
Grid view using modal.

Upcoming

My Calendar also uses a variety of upcoming events lists, configurable either using widgets or shortcodes. Unlike the main calendar views, these are lists of events, rather than lists of dates. There are four of these available: Upcoming Events, Today’s Events, Now, and Next.

The shortcodes [my_calendar_now] and [my_calendar_next] each display only one event: the first only shows anything if there is an event currently happening; the second shows whatever event is the next up in the calendar.

Upcoming Events and Today’s Events are documented in the Shortcodes and Widgets pages.

Settings – Display

Display Settings is located under My Calendar > Settings > Display.

Main Display Settings: view titles, fields shown in different views.

Grid

Event title (Grid) {time}: {title}

Example with adding in the word “Event Title” into the Event title (Grid) field.
I added shortcode: {time} Event Title: {title}

Frontend view:

My Calendar > Settings > Text > Event title (Grid). Frontend view.


Single

Event title (Single) {title}

Example with adding in the word “Event Single Title: ” into the Event title (Single) field. I added the shortcode: Event Single Title: {title}

Frontend view:

My Calendar > Settings > Text > Event Title (Single). Frontend view.


List

Event title (List) {title}

Example with adding in the word “Event List Title” into the Event title (List).
I added the shortcode: Event List Title: {title}

Frontend view:

My Calendar > Settings > Text > Event title (List). Frontend view.

These are the changes I made:

My Calendar > Settings > Text - Templating fields.
My Calendar > Settings > Text – Templating fields.

Event Display Fields

The series of check boxes gives you the ability to display or hide a variety of different fields directly in the frontend for Single Event, Calendar Popup/List View, and Mini Calendar Popup.

Settings for Single Event, Main View (Popup or List) and Mini Calendar Popup.

Choose fields to show in the various frontend views. Adjusting the templates can override these settings. Unclicking/Unsetting all the values will bring back the default values.

Single Event

My Calendar > Settings > Display – Event Display Fields – Single Event

Default frontend fields for the Single Event.

My Calendar > Settings > Display – Event Display Fields – Single Event. (Theme: Twenty Twenty One.)

Main View (Popup or List)

My Calendar > Settings > Display – Event Display Fields – Main View (Popup or List)

Default frontend view for the Main View: Popup.

My Calendar > Settings > Display – Event Display – Main View – Popup. (Theme: Twenty Twenty One.)

Default frontend view for the Main View: List.

My Calendar > Settings > Display – Event Display Fields – Main View – List (Theme: Twenty Twenty One.)

Mini Calendar Popup

My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup

Default frontend view for the Mini Calendar Popup.

My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup. (Theme: Twenty Twenty One.)

Clicking the event the Mini Calendar Popup.

My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup is open. (Theme: Twenty Twenty One.)

Calendar Navigation

Update calendar layout
Define a default layout for calendars. Use the arrow icons to move fields up or down or use drag and drop to rearrange the order these are seen in. Click the eye to hide fields. These settings will be overridden if you customize the field settings in the My Calendar shortcodes.

My Calendar > Display > Calendar Links and Update calendar layout

Default Frontend view containing one event:

My Calendar > Settings > Display. Viewing default calendar layout on frontend. (Theme: Twenty Twenty One.)

View Options

How many months of events to show at a time: Sets how many months will be shown at one time by the main calendar shortcode in list, grid, and mini view. Also configurable via the shortcode.

Grid Options

Calendar Links

Open links as a pop-up
Opens a pop-up card and one can click “Read more” to continue to the single event view.

Open event links in single event view
Bypasses the pop-up card and goes straight to the single event. Improves performance with large numbers of events.

Disable calendar links
This option will disable all event links in the main calendar. Useful for a minimal-information view.

Mobile View: Adjusts how the calendar will be rendered on mobile devices. It can switch to list view, switch to mini calendar view, or have no change.

Show Weekends on Calendar: If enabled, Saturday and Sunday (weekend days) will be included in the calendar grid.

List Options

Show the first event’s title and the number of events that day next to the date. In the list view, the toggle to expand events for a day is normally just the current date. Use this to show more information.

Show all event titles next to the date. Instead of just showing the first event, show all event titles for the date.

Mini Calendar Options

Target link for mini calendar dates – This URL is the destination you want links from the mini calendar to use.

Link action for mini calendar: Event pop-up, daily view page (above), in-page anchor on main calendar page (list), in-page anchor on main calendar page (grid).

My Calendar > Settings > Display – Grid Options – List Options – Mini Calendar Options.

Next: My Calendar > Settings > Input.