{"id":309,"date":"2021-11-05T10:00:56","date_gmt":"2021-11-05T15:00:56","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar\/?p=309"},"modified":"2025-12-23T19:49:11","modified_gmt":"2025-12-24T01:49:11","slug":"my-calendar-locations","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-locations\/","title":{"rendered":"Locations"},"content":{"rendered":"\n

Locations is located under My Calendar > Locations<\/code>.<\/p>\n\n\n\n

\"Screenshot:
My Calendar > Locations<\/figcaption><\/figure>\n\n\n\n

Update location permalinks<\/h2>\n\n\n\n

This option only appears if there is no value currently saved for the location permalinks. The default is ‘mc-locations’. Clicking Update location permalinks<\/strong> takes you to the Settings > Permalinks screen. Here we can change the slug part of mc-locations to a custom value.<\/p>\n\n\n\n

\"Custom
My Calendar: Setting Permalinks for Events and Locations.<\/figcaption><\/figure>\n\n\n\n

Quick edit actions<\/strong><\/h2>\n\n\n\n

Using the mouse button to hover over the location will bring up the actions area.<\/p>\n\n\n\n

\"A
My Calendar: Locations quick edit<\/figcaption><\/figure>\n\n\n\n

One can View, Edit, Set as Default or Delete the location.<\/p>\n\n\n\n

View<\/h3>\n\n\n\n

View will show the location singular page on the front end of your website. If you have a Google Maps API key and the location has sufficient information, it will show a map to the location. The default singular location page also shows a list of upcoming events at that location and the location’s address. The available accessibility features are also visible here, if selected.<\/p>\n\n\n\n

\"Screenshot
My Calendar > Locations > View (Frontend)<\/figcaption><\/figure>\n\n\n\n

Edit<\/h3>\n\n\n\n

Will bring up the Edit Location screen to where one can edit the location.<\/p>\n\n\n\n

Set as Default<\/h3>\n\n\n\n

When creating an event, the location field will be preset to this default location. Strongly advised if you have only one location – location is a required part of Google’s structured data for events.<\/p>\n\n\n\n

Delete <\/h3>\n\n\n\n

Will remove the location. Removing a location automatically updates any events referencing that location.<\/p>\n\n\n\n

Edit Location<\/h2>\n\n\n\n

Clicking to edit the location will show the edit screen. With a Google Maps API key, you will see a location map at the bottom of the Edit Location screen.<\/p>\n\n\n\n

\"Editing
My Calendar > Locations > Edit Location<\/figcaption><\/figure>\n\n\n\n

Update GPS Coordinates
<\/strong>Adjusting the location and clicking the Update GPS Coordinates checkbox will update the map along with the rest of the location information on Save Changes.<\/p>\n\n\n\n

Using a shortcode to view a location<\/h2>\n\n\n\n

There are shortcodes available to create lists of locations. The shortcode
[my_calendar_show_locations sort=\"country\"]<\/code><\/code>, for example, will show a list of locations sorted alphabetically by country. Sorting options are name<\/strong>, city<\/strong>, state<\/strong>, zip<\/strong>, country <\/strong>and region<\/strong>.<\/p>\n\n\n\n

Here is a front end example of the Locations List:<\/p>\n\n\n\n

\"Example<\/figure>\n\n\n\n

The location shortcode also accepts a template<\/code> parameter. The template parameter can adjust how the list is displayed. If no template is passed, the hcard<\/code> will be used, as shown below. You can also pass map<\/code> to show a map with all locations included on it.<\/p>\n\n\n\n

Any other template should contain My Calendar template tags<\/a> with location values, and will be custom output.<\/p>\n\n\n\n

Supported Template Tags<\/h3>\n\n\n\n

{id}, {label}, {street}, {street2}, {city}, {state}, {postcode}, {region}, {url}, {country}, {longitude}, {latitude}, {zoom}, {phone}, {phone2}<\/code><\/p>\n\n\n\n

Next: My Calendar > Locations > Add New Location<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Locations is located under My Calendar > Locations. Update location permalinks This option only appears if there is no value currently saved for the location permalinks. The default is ‘mc-locations’. Clicking Update location permalinks takes you to the Settings > Permalinks screen. Here we can change the slug part of mc-locations to a custom value. […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[22],"class_list":["post-309","post","type-post","status-publish","format-standard","hentry","category-locations","tag-locations"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/309","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=309"}],"version-history":[{"count":24,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/309\/revisions"}],"predecessor-version":[{"id":485,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/309\/revisions\/485"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/media?parent=309"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/categories?post=309"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/tags?post=309"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}