{"id":1172,"date":"2023-01-06T11:44:30","date_gmt":"2023-01-06T17:44:30","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar\/?p=1172"},"modified":"2026-08-18T16:07:44","modified_gmt":"2026-08-18T21:07:44","slug":"my-calendar-views-overview","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-views-overview\/","title":{"rendered":"My Calendar Views &#8211; Overview"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The main My Calendar has three available views: Grid, List, or Card. The Mini\/Compact view can be enabled in the shortcode. Upcoming Events are a separate view configured through the Upcoming Events shortcode or widget. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Grid<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The grid view is the most traditional calendar layout option. By default, it&#8217;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. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The title can be customized using the <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-display-options\/\" data-type=\"post\" data-id=\"385\">Display Settings<\/a> for &#8220;Event title (Grid)&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"910\" height=\"612\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-12.png\" alt=\"Screenshot with a classic 7-column grid calendar view. Day of the week is the column header.\" class=\"wp-image-1653\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-12.png 910w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-12-300x202.png 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-12-768x517.png 768w\" sizes=\"auto, (max-width: 910px) 100vw, 910px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">List<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The title in list view can be customized using the <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-display-options\/\" data-type=\"post\" data-id=\"385\">Display Settings<\/a> for &#8220;Event title (List)&#8221;.  Enable the event titles view by checking &#8220;Show events in list view&#8221; under the &#8220;List Options&#8221; section on the same settings page.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-8f761849 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"589\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-5-1024x589.png\" alt=\"View of the event list view with event titles shown.\" class=\"wp-image-1175\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-5-1024x589.png 1024w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-5-300x173.png 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-5-768x442.png 768w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-5.png 1260w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">List view showing event titles.<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"517\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-6-1024x517.png\" alt=\"View of the event list without event titles shown.\" class=\"wp-image-1176\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-6-1024x517.png 1024w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-6-300x151.png 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-6-768x388.png 768w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-6.png 1292w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">List view without titles. Current day expanded.<\/figcaption><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Card View<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The card view shows individual events in date order. It collapses recurring events so that only one instance of each event will appear.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"490\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/09\/image-1024x490.png\" alt=\"Screenshot of the card view\" class=\"wp-image-1465\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/09\/image-1024x490.png 1024w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/09\/image-300x143.png 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/09\/image-768x367.png 768w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2021\/09\/image.png 1322w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">My Calendar: Card view, front end.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Mini\/Compact<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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. <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"450\" height=\"460\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-7.png\" alt=\"View of the mini calendar, with buttons to expand modals showing dots to indicate presence of multiple events.\" class=\"wp-image-1177\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-7.png 450w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-7-293x300.png 293w\" sizes=\"auto, (max-width: 450px) 100vw, 450px\" \/><figcaption class=\"wp-element-caption\">Mini calendar; nothing expanded.<\/figcaption><\/figure>\n<\/div>\n\n\n<h2 class=\"wp-block-heading\">Script Options<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The grid, list, and mini all support two options for interactions: a disclosure widget and a modal. These are configured at <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-design-scripts\/\" data-type=\"post\" data-id=\"317\">Design &gt; Scripts<\/a>. 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.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"712\" src=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-3-1024x712.png\" alt=\"Grid view with modal popup showing one event\" class=\"wp-image-1173\" srcset=\"https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-3-1024x712.png 1024w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-3-300x209.png 300w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-3-768x534.png 768w, https:\/\/docs.joedolson.com\/my-calendar\/wp-content\/uploads\/sites\/3\/2023\/01\/image-3.png 1160w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Grid view using modal.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Upcoming<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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&#8217;s Events, Now, and Next.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The shortcodes <code class=\"shortcode\">&lsqb;my_calendar_now&rsqb;<\/code> and <code class=\"shortcode\">&lsqb;my_calendar_next&rsqb;<\/code> 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. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Upcoming Events and Today&#8217;s Events are documented in the <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-shortcodes\/\" data-type=\"post\" data-id=\"400\">Shortcodes<\/a> and <a href=\"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-widgets\/\" data-type=\"post\" data-id=\"368\">Widgets<\/a> pages.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The main My Calendar has three available views: Grid, List, or Card. The Mini\/Compact view can be enabled in the shortcode. Upcoming Events are a separate view configured through the Upcoming Events shortcode or widget. Grid The grid view is the most traditional calendar layout option. By default, it&#8217;s a table with either five or [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[58],"tags":[],"class_list":["post-1172","post","type-post","status-publish","format-standard","hentry","category-views"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1172","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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/comments?post=1172"}],"version-history":[{"count":4,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1172\/revisions"}],"predecessor-version":[{"id":1654,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1172\/revisions\/1654"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/media?parent=1172"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/categories?post=1172"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/tags?post=1172"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}