My Calendar Display Options

My Calendar has two primary methods for displaying events: Shortcodes and Widgets.

Shortcodes are small pieces of code intended to be placed in posts or pages. Some examples of using shortcodes are, adding a standard grid-format calendar, a list-formatted calendar, showing the events for the month, the week, or the day. Continue reading below to learn more about shortcodes.

Widgets are a convenient method to add information to sidebars and footer areas. Using widgets one can display a version of the calendar formatted for small spaces (the “mini” calendar), a list of upcoming events, a list of events happening today, or a specific single event. To learn more about widgets read our My Calendar widget documentation.

Shortcodes

Located on the bottom of the default “My Calendar” page is the My Calendar Display Options meta boxes. (Click the top right arrow of the meta boxes to view the options.)

Meta boxes. My Calendar page – Display Options

Main Calendar Shortcode

The default shortcode for displaying My Calendar.

[my_calendar]

The above my calendar code is actually the same as this code:

[my_calendar category="all" ltype="" lvalue="" format="calendar"
above="" below="" time="month" author="all" host="all" id="" tem-
plate="" year="" month="" day="" search=""]

Content Filters

Categories to display.
Location filter type by
All locations, Location Name, City, State, Postal Code, Country or Region.
Location filter values.
Search keyword. – Only events that use the keyword will be visible in the calendar.

Navigation keywords that can be used separated by commas in the “Navigation above calendar” and “Navigation below calendar” fields.

toggle – Switch between list and grid views
timeframe – Toggle between day, week, and month view
jump – Jump to any other month/year
nav – Primary Previous/Next Buttons
calendar – The calendar
key – Categories
print – Link to printable view
feeds – iCal Subscription Links
exports – iCal Subscription Links
locations – Location (dropdown)
categories – Categories (dropdown)
access – Access (dropdown)
search – Search

The attributes will show up in the order they are listed.
To remove the navigation add “none”.
My Calendar will show the defaults if no attributes are added.
Defaults can be configured in the Settings > Output screen.

Author & Host Filters

Limit by Author.
Limit by Host.

Formatting & Timeframe

Format by Default, Grid, List or Mini.
Time Segment by Default, Month, Next Month, Week or Day.
Months to show in list view.

Initial Date Shown

Select the start date of events going forward.
Year by Default or the next 5 years.
Month by Default or a specific month.
Day by Default or from 1 to 31.

Example Customized Shortcode

[my_calendar above="toggle, nav" below="print, key" format="list" time="week"]

The shortcode:
Above calendar: A toggle between list/grid view along with nav previous/next navigation arrows.
Below calendar: a print icon and key categories.
Format: Changed the default grid to list.
Time: The calendar is seen in a week view.

The result which includes two events is seen on the frontend of the site.

Shortcode displayed on frontend

Reset Shortcode button
Go back to the backend and click the “Reset Shortcode” button (to the right of the Shortcode field) and refresh the browser window to see the Shortcode field reset.

Read about the Shortcode Generator.
Next: My Calendar > Shortcodes.

Search Events

My Calendar includes a simple search form that can be used in a few different ways. The main parameter for the search form is a target URL. By default, searches will be targeted to the main My Calendar page, where your calendar is displayed. In that case, they’ll display in whatever default view your calendar uses.

If you target a URL that does not contain the my_calendar shortcode, then the results will display in a numbered list showing the events that match the search in date order from soonest to farthest out.

Widget

The search widget is documented on the widgets page.

Shortcode

You can insert the search form using the shortcode [my_calendar_search url="https://yourdomain.com/target/"]

My Calendar Navigation

The search can be added as a navigation item above or below the calendar’s main view. This method only queries the calendar view. Use the key search to insert it in the main My Calendar shortcode.

Shortcodes

Shortcodes is located under My Calendar > Shortcodes.
Main, Upcoming and Today.

Main

The general Calendar. Will show the default calendar view based on the selections in the Main tab screen. You can also go directly to the backend My Calendar page and modify the shortcodes seen on the bottom in the meta boxes.

[my_calendar]
My Calendar > Shortcodes > Main

Content Filters

Categories to display. Select All or specific categories to display.
Location filter type. Select a specific location area to filter by.
Location values. Fill in a specific value.
Search keyword. Shows events containing a specific keyword.

Navigation keywords that can be used separated by commas in the “Navigation above calendar” and “Navigation below calendar” fields.

toggle – Switch between list and grid views
timeframe – Toggle between day, week, and month view
jump – Jump to any other month/year
nav – Primary Previous/Next Buttons
calendar – The calendar
key – Categories
print – Link to printable view
feeds – iCal Subscription Links
exports – iCal Subscription Links
locations – Location (dropdown)
categories – Categories (dropdown)
access – Access (dropdown)
search – Search

The attributes will show up in the order they are listed. To remove all navigation add “none”. My Calendar will show the default settings if no attributes are added.
Defaults can be configured in the Settings > Display screen.

Author & Host Filters

Limit by Author.
Limit by Host.

Formatting & Timeframe

Format. Choose from Grid, List or Mini.
Time Segment. Month, Next Month, Week, Day
Months to show in list view. Select the amount of months to be seen in list view.

Initial Date Shown

Select the start date of events going forward.
Year. By Default or the next 5 years.
Month. By Default or a specific month.
Day.
By Default or from 1 to 31.

Upcoming

Upcoming events you can show events coming up in the future, or include past events.

My Calendar > Shortcodes > Upcoming

Today

How todays events are seen.

My Calendar > Shortcodes > Today