{"id":385,"date":"2021-10-20T02:24:09","date_gmt":"2021-10-20T07:24:09","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar\/?p=385"},"modified":"2025-12-23T16:15:29","modified_gmt":"2025-12-23T22:15:29","slug":"my-calendar-display-options","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-display-options\/","title":{"rendered":"My Calendar Main Display Options"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">My Calendar creates a page for displaying the calendar on installation. This page will be created at <code>https:\/\/yourdomain.com\/my-calendar\/<\/code>, by default. You can edit this page to add additional content, change the page title, or change the slug using the standard WordPress editing features for a Page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">My Calendar can also be displayed in <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/category\/shortcodes\/\">shortcodes<\/a> or <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-widgets\/\">widgets<\/a>. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"shortcodes\">Editing the Main Calendar Options<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Located on the bottom of the &#8220;My Calendar&#8221; page you can find the <strong>My Calendar Display Options<\/strong> meta boxes. These options control the display of the calendar on the main page. <\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2018\/03\/My-Calendar-WordPress-plugin-Display-Options.jpg\" alt=\"Screenshot of the My Calendar Display Options panel in the WordPress content editor.\" class=\"wp-image-386\"\/><figcaption class=\"wp-element-caption\">Meta boxes. My Calendar page &#8211; Display Options<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Shortcodes are available for creating additional views of the calendar. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"main-calendar-shortcode\">Main Calendar Shortcode<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The default shortcode for displaying My Calendar. If you wish to display an additional calendar, you can create a custom shortcode and place it on any page of your site. It can be narrowed by category, author, location, host, or a search term so that it shows different events than your main calendar.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;my_calendar]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The above my calendar code is the same as this code, which shows the default parameter values:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;my_calendar category=\"all\" ltype=\"\" lvalue=\"\" format=\"calendar\"\nabove=\"\" below=\"\" time=\"month\" author=\"all\" host=\"all\" id=\"\" tem-\nplate=\"\" year=\"\" month=\"\" day=\"\" search=\"\"]<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"content-filters\">Content Filters<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Categories to display. <\/li>\n\n\n\n<li>Location filter type by:\n<ul class=\"wp-block-list\">\n<li><strong>All locations, <\/strong><\/li>\n\n\n\n<li><strong>Location Name, <\/strong><\/li>\n\n\n\n<li><strong>City,<\/strong><\/li>\n\n\n\n<li><strong>State, <\/strong><\/li>\n\n\n\n<li><strong>Postal Code, <\/strong><\/li>\n\n\n\n<li><strong>Country, or <\/strong><\/li>\n\n\n\n<li><strong>Region.<\/strong><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Location filter values &#8211; the value to limit to from the above types.<\/li>\n\n\n\n<li>Search keyword.\n<ul class=\"wp-block-list\">\n<li> Only events that use the keyword will be shown in this view.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"navigation\">Navigation<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Navigation keywords that can be used separated by commas in the &#8220;Navigation above calendar&#8221; and &#8220;Navigation below calendar&#8221; fields.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>toggle<\/strong> &#8211; Switch between list and grid views<\/li>\n\n\n\n<li><strong>timeframe<\/strong> &#8211; Toggle between day, week, and month view<\/li>\n\n\n\n<li><strong>jump<\/strong> &#8211; Jump to any other month\/year<\/li>\n\n\n\n<li><strong>nav<\/strong> &#8211; Primary Previous\/Next Buttons<\/li>\n\n\n\n<li><strong>calendar<\/strong> &#8211; The calendar<\/li>\n\n\n\n<li><strong>key<\/strong> &#8211; Categories (multi-selection buttons)<\/li>\n\n\n\n<li><strong>print<\/strong> &#8211; Link to printable view<\/li>\n\n\n\n<li><strong>feeds<\/strong> &#8211; iCal Subscription Links<\/li>\n\n\n\n<li><strong>exports<\/strong> &#8211; iCal Subscription Links<\/li>\n\n\n\n<li><strong>locations<\/strong> &#8211; Location (dropdown)<\/li>\n\n\n\n<li><strong>categories<\/strong> &#8211; Categories (single selection dropdown)<\/li>\n\n\n\n<li><strong>access<\/strong> &#8211; Access (dropdown)<\/li>\n\n\n\n<li><strong>search<\/strong> &#8211; Search<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The attributes will show up in the order they are listed. To remove the navigation add &#8220;<strong>none&#8221;<\/strong>. My Calendar will show the defaults if no attributes are added, but you can modify the defaults in the <strong>Settings &gt; <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-output-settings\/\">Output<\/a> screen<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"author-host-filters\">Author &amp; Host Filters<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Limit by Author<\/strong>: only show events published by a specific author.<\/li>\n\n\n\n<li><strong>Limit by Host<\/strong>: only show events with a specific host attached.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"formatting-timeframe\">Formatting &amp; Timeframe<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Format by: <\/strong>Grid, Card, List or Mini. Choose the initial view that users will see when visiting your calendar.<\/li>\n\n\n\n<li><strong>Time Segment:<\/strong> by Month, Next Month, Week or Day. Default time period seen when visiting.<\/li>\n\n\n\n<li><strong>Months to show<\/strong>: How many months will be visible by default?<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"initial-date-shown\">Initial Date Shown<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Choose the default start date. Set a specific year, month, and day that your calendar will start from. By default, it will start from the current day, but for special cases you can set it to start at an alternate date.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"example-customized-shortcode\">Example Customized Shortcode<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;my_calendar above=\"toggle, nav\" below=\"print, key\" format=\"list\" time=\"week\"]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The shortcode: <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Above calendar<\/strong>: A toggle between list\/grid view along with nav previous\/next navigation arrows.<\/li>\n\n\n\n<li><strong>Below calendar<\/strong>: a link to the printable view and category key.<\/li>\n\n\n\n<li><strong>Format<\/strong>: Changed the default grid to list.<\/li>\n\n\n\n<li><strong>Time<\/strong>: The calendar defaults to a week view.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"475\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/10\/My-Calendar-WordPress-plugin-shortcode-displayed-on-frontend-1024x475.jpg\" alt=\"View of the calendar list view with two dates having events.\" class=\"wp-image-389\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/10\/My-Calendar-WordPress-plugin-shortcode-displayed-on-frontend-1024x475.jpg 1024w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/10\/My-Calendar-WordPress-plugin-shortcode-displayed-on-frontend-300x139.jpg 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/10\/My-Calendar-WordPress-plugin-shortcode-displayed-on-frontend-768x356.jpg 768w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/10\/My-Calendar-WordPress-plugin-shortcode-displayed-on-frontend.jpg 1200w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Example output from the example shortcode<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-shortcodes\/\">Read about the Shortcode Generator<\/a>: My Calendar &gt; <a data-type=\"post\" data-id=\"400\" href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-shortcodes\/\">Shortcodes<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>My Calendar creates a page for displaying the calendar on installation. This page will be created at https:\/\/yourdomain.com\/my-calendar\/, by default. You can edit this page to add additional content, change the page title, or change the slug using the standard WordPress editing features for a Page. My Calendar can also be displayed in shortcodes or [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-385","post","type-post","status-publish","format-standard","hentry","category-shortcodes"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/385","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/comments?post=385"}],"version-history":[{"count":16,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/385\/revisions"}],"predecessor-version":[{"id":388,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/385\/revisions\/388"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/media?parent=385"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/categories?post=385"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/tags?post=385"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}