{"id":1442,"date":"2025-08-30T16:20:13","date_gmt":"2025-08-30T21:20:13","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar\/?p=1442"},"modified":"2025-12-23T10:53:53","modified_gmt":"2025-12-23T16:53:53","slug":"updating-my-calendar","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar\/updating-my-calendar\/","title":{"rendered":"Updating My Calendar"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Updated versions of My Calendar are shipped fairly regularly. Minor updates are any change in the 3rd digit (e.g. updating from 3.5.6 to 3.5.7). In a minor update, very little will change; almost always only bug fixes. This doesn&#8217;t mean that nothing can go wrong, but generally the changes are slight.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Major updates contain more significant changes. These changes may impact the front-end of your site.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There is no significant difference between a second digit change (3.4 to 3.5) and a first digit change (3.9 to 4.0). <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Upgrade Path Policies<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">My Calendar has upgrade processes that run whenever you do an update that requires significant changes. These updates may migrate options to a different format, add default values for new options, or modify the database.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Upgrade paths are not maintained indefinitely. Any given upgrade path will be kept in place for approximately five years. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Right now (August 30th, 2025), the oldest version with a full upgrade path is version 3.1.13, released in August 2019. This will be removed when version 3.7 is released.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Accessibility-first Development<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Since version 3.5, My Calendar is developed with an accessibility-first mindset. This means that if I need to make a breaking change for accessibility reasons, I will do this. Breaking changes will still only occur in major releases, and will never occur in a 3rd-digit release. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Most accessibility changes will be modifications to the My Calendar HTML output, and the primary change that will occur on your site is that custom styles may break. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">I updated, and everything looks wrong!<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Most likely, this is a caching issue. While something could go wrong in an update, the most common problem is that you have updated HTML or settings, but out of date CSS or JavaScript. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you have any caching plugins in your environment, clear those caches, then go and view your site in a private tab in your browser. This helps ensure that you&#8217;re not seeing it with either a cache from the site or a cache from your browser.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Updated versions of My Calendar are shipped fairly regularly. Minor updates are any change in the 3rd digit (e.g. updating from 3.5.6 to 3.5.7). In a minor update, very little will change; almost always only bug fixes. This doesn&#8217;t mean that nothing can go wrong, but generally the changes are slight. Major updates contain more [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[78],"tags":[],"class_list":["post-1442","post","type-post","status-publish","format-standard","hentry","category-updates"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1442","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=1442"}],"version-history":[{"count":4,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1442\/revisions"}],"predecessor-version":[{"id":1443,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/1442\/revisions\/1443"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/media?parent=1442"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/categories?post=1442"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/tags?post=1442"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}