{"id":11,"date":"2021-11-02T04:45:33","date_gmt":"2021-11-02T09:45:33","guid":{"rendered":"http:\/\/docs.joedolson.com\/my-calendar\/?p=11"},"modified":"2026-05-22T19:06:03","modified_gmt":"2026-05-23T00:06:03","slug":"my-calendar-template-tag-index","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar\/my-calendar-template-tag-index\/","title":{"rendered":"Template Tag Index"},"content":{"rendered":"\n

Legacy Template Tags<\/h2>\n\n\n\n

Legacy templates are managed at My Calendar > Design > Templates if PHP templating is not enabled. <\/p>\n\n\n\n

\n
Migrating from Legacy Templates to PHP Templates<\/a><\/div>\n<\/div>\n\n\n\n

All legacy template tags support two attributes: before=”value” and after=”value”. The values of the attributes will be placed before and after the output value. These attribute values must<\/strong> be wrapped in double quotes.<\/p>\n\n\n\n

Date\/Time template tags support the “format” attribute: format=”M, Y”, where the value is a PHP formatted date string. Only dtstart<\/code> and dtend<\/code> include the full date\/time information for formatting.<\/p>\n\n\n\n

Example:<\/strong> {title before=\"<h3>\" after=\"<\/h3>\"}<\/code><\/p>\n\n\n\n

Legacy template tags don’t support any logical operators, but the before<\/code> and after<\/code> attributes values will only be returned if the tag returns content. Otherwise, tags should be wrapped in HTML to format the structure. <\/p>\n\n\n\n

Template tags in PHP templating<\/h2>\n\n\n\n

If you’ve switched to My Calendar’s PHP templating system<\/a>, these template tags can be retrieved using mc_template_tag( $event, $key )<\/code>, where $key<\/code> is the portion of the template tag between the curly braces. E.g., mc_template_tag( $event, 'title' )<\/code>. Template tag attributes are not supported in the PHP templating system; all logic in PHP templates should be written in PHP. Tip: mc_template_tag()<\/code> echoes the value, mc_get_template_tag()<\/code> returns it.<\/p>\n\n\n\n

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

{title}<\/code>
Displays the title of the event.<\/p>\n\n\n\n

{link_title}<\/code>
Displays title of the event as a link if a URL is present, or the title alone if no URL is available. <\/p>\n\n\n\n

{link_image}<\/code>
Displays featured image of the event as a link if a URL is present, or the image alone if no URL is available.<\/p>\n\n\n\n

{time}<\/code>
Displays the start time for the event. <\/p>\n\n\n\n

{time24}<\/code>
Displays the start time using the 24 hour clock.<\/p>\n\n\n\n

{runtime}<\/code>
Human language estimate of how long an event will run. <\/p>\n\n\n\n

{date}<\/code>
Displays the date on which the event begins.<\/p>\n\n\n\n

{datebadge}<\/code>
Shows the output used for the date badge format (month abbreviation and day number, stacked.)<\/p>\n\n\n\n

{began}<\/code>
Displays the date on which the series of events began (for recurring events).<\/p>\n\n\n\n

{enddate}<\/code>
Displays the date on which the event ends. <\/p>\n\n\n\n

{endtime}<\/code>
Displays the time at which the event ends. <\/p>\n\n\n\n

{daterange}<\/code>
Displays the beginning date to the end date for events. Does not show end date if same as start date. <\/p>\n\n\n\n

{timerange}<\/code>
Displays the beginning and end times for events. Does not show end time if same as start or if marked as hidden.<\/p>\n\n\n\n

{datespan}<\/code>
Displays the full span from the initial date\/time to the end date\/time for long events.<\/p>\n\n\n\n

{userstart}<\/code>
Outputs the start date & time for manipulation by JS to display dates & times in the current visitor’s time zone.<\/p>\n\n\n\n

{userend}<\/code>
Outputs the end date & time for manipulation by JS to display end dates & end times in the current visitor’s time zone.<\/p>\n\n\n\n

{userstartdate}<\/code>
Outputs the starting date for manipulation by JS to display dates in the current visitor’s time zone.<\/p>\n\n\n\n

{userenddate}<\/code>
Outputs the ending date for manipulation by JS to display dates in the current visitor’s time zone.<\/p>\n\n\n\n

{userstarttime}<\/code>
Outputs the starting timefor manipulation by JS to display times in the current visitor’s time zone.<\/p>\n\n\n\n

{userendtime}<\/code>
Outputs the ending time for manipulation by JS to display times in the current visitor’s time zone.<\/p>\n\n\n\n

{dtstart}<\/code>
Timestamp for beginning of event. <\/p>\n\n\n\n

{dtend}<\/code>
Timestamp for end of event. <\/p>\n\n\n\n

{multidate}<\/code>
For multi-day events displays an unordered list of dates and times for events in this group. Otherwise, beginning date\/time. <\/p>\n\n\n\n

{related}<\/code>
List of other events in the same event group. (Only on single event views.) <\/p>\n\n\n\n

{recurring}<\/code>
List of recurring dates on this event.<\/p>\n\n\n\n

{author}<\/code>
Displays the WordPress author who posted the event. <\/p>\n\n\n\n

{gravatar}<\/code>
Displays the gravatar image for the event author. <\/p>\n\n\n\n

{host}<\/code>
Displays the name of the person assigned as host for the event. <\/p>\n\n\n\n

{host_email}<\/code>
Displays the email address of the person assigned as host for the event.<\/p>\n\n\n\n

{host_gravatar}<\/code>
Displays the gravatar image for the event host.<\/p>\n\n\n\n

{shortdesc}<\/code>
Displays the short version of the event description if provided.<\/p>\n\n\n\n

{shortdesc_raw}<\/code>
Displays short description without converting paragraphs. <\/p>\n\n\n\n

{shortdesc_stripped}<\/code>
Displays short description with any HTML stripped out. <\/p>\n\n\n\n

{excerpt}<\/code>
Like the_excerpt();<\/code> displays short description if provided, otherwise excerpt from description.<\/p>\n\n\n\n

{autoexcerpt}<\/code>
Like the_excerpt();<\/code> display truncated excerpt from description.<\/p>\n\n\n\n

{description}<\/code>
Displays the description of the event. <\/p>\n\n\n\n

{description_raw}<\/code>
Displays description without converting paragraphs. <\/p>\n\n\n\n

{description_stripped}<\/code>
Displays description with any HTML stripped out.<\/p>\n\n\n\n

{access}<\/code>
Unordered list of accessibility options for this event. <\/p>\n\n\n\n

{image}<\/code>
Image associated with the event. (HTMl) <\/p>\n\n\n\n

{image_url}<\/code>
Image associated with the event. (image URL only) <\/p>\n\n\n\n

{full}<\/code>
Event post thumbnail, full size, full HTML <\/p>\n\n\n\n

{thumbnail}<\/code> \/ {thumbnail_url}<\/code>
Event post thumbnail, thumbnail size, full HTML \/ image URL only <\/p>\n\n\n\n

{medium}<\/code> \/ {medium_url}<\/code>
Event post thumbnail, medium size, full HTML \/ image URL only <\/p>\n\n\n\n

{medium_large}<\/code> \/ {medium_large_url}<\/code>
Event post thumbnail, medium_large size, full HTML \/ image URL only <\/p>\n\n\n\n

{large}<\/code> \/ {large_url}<\/code>
Event post thumbnail, large size, full HTML \/ image URL only <\/p>\n\n\n\n

{link}<\/code>
Displays the URL provided for the event.<\/p>\n\n\n\n

{ical}<\/code>
Produces the URL to download an iCal formatted record for the event. <\/p>\n\n\n\n

{ical_html}<\/code>
Produces a hyperlink to download an iCal formatted record for the event. <\/p>\n\n\n\n

{gcal}<\/code>, {office}<\/code>, {outlook}<\/code>
URL to submit event to Google Calendar\/Office 365\/Outlook.<\/p>\n\n\n\n

{gcal_link}<\/code> , {office_link}<\/code>, {outlook_link}<\/code>
Link to submit event to Google Calendar, Office 365, Outlook.<\/p>\n\n\n\n

{recurs}<\/code>
Shows the recurrence status of the event. (Daily, Weekly, etc.) <\/p>\n\n\n\n

{repeats}<\/code>
Shows the number of repetitions of the event (older events) or the date the event repeats until (newer events)<\/p>\n\n\n\n

{details}<\/code>
Provides a link to an auto-generated page containing all information on the given event. Requires that the site URL has been provided on the Settings page<\/strong>.<\/p>\n\n\n\n

{details_link}<\/code>
Raw URL for the details link; empty if target URL not defined. <\/p>\n\n\n\n

{permalink}<\/code>
Alias for {details_link}<\/code>. Raw URL for the details link; empty if target URL not defined.<\/p>\n\n\n\n

{linking}<\/code>
Provides a link to the defined event URL when present, otherwise the {details}
link. Requires that the site URL has been provided on the Settings page<\/strong>.<\/p>\n\n\n\n

{linking_title}<\/code>
Like {link_title}, but uses {linking} instead of {link}. <\/p>\n\n\n\n

{event_tickets}<\/code>
URL to ticketing for event. <\/p>\n\n\n\n

{event_registration}<\/code>
Registration information about this event. <\/p>\n\n\n\n

{event_status}<\/code>
Displays the current status of the event: either “Published” or “Reserved” – primary used in email templates.<\/p>\n\n\n\n

Location Template Tags<\/h2>\n\n\n\n

{location}<\/code>
Displays the name of the location of the event. <\/p>\n\n\n\n

{street}<\/code>
Displays the first line of the site address. <\/p>\n\n\n\n

{street2}<\/code>
Displays the second line of the site address. <\/p>\n\n\n\n

{city}<\/code>
Displays the city for the location. <\/p>\n\n\n\n

{state}<\/code>
Displays the state for the location. <\/p>\n\n\n\n

{postcode}<\/code>
Displays the postcode for the location. <\/p>\n\n\n\n

{region}<\/code>
Shows the custom region entered for the location. <\/p>\n\n\n\n

{country}<\/code>
Displays the country for the event location. <\/p>\n\n\n\n

{sitelink}<\/code>
Output the URL for the location link.<\/p>\n\n\n\n

{phone}<\/code>
Output the stored phone number for the location. <\/p>\n\n\n\n

{sitelink_html}<\/code>
Output a hyperlink to the location’s listed link with default link text. <\/p>\n\n\n\n

{link_map}<\/code>
Displays a link to a Google Map of the event, if sufficient address information is available. If not, will be empty. <\/p>\n\n\n\n

{map_url}<\/code>
Produces the URL for the Google Map for the event location if sufficient address information is available. If not, will be empty. <\/p>\n\n\n\n

{map}<\/code>
Output Google Map if sufficient address information is available. If not, will be an empty string.<\/p>\n\n\n\n

{location_access}<\/code>
Unordered list of accessibility options for this location.<\/p>\n\n\n\n

Category Template Tags<\/h2>\n\n\n\n

{category}<\/code>
Displays the name of the category the event is in. <\/p>\n\n\n\n

{categories}<\/code>
Returns an HTML formatted list of the categories for this event.<\/p>\n\n\n\n

{icon}<\/code>
Produces the address of the current event’s category icon. <\/p>\n\n\n\n

{icon_html}<\/code>
Produces the HTML for the current event’s category icon. <\/p>\n\n\n\n

{color}<\/code>
Produces the hex code for the current event’s category color. <\/p>\n\n\n\n

{color_css}<\/code>
Returns <span style='background-color: $event->category_color; color: $inverse'><\/code><\/p>\n\n\n\n

{close_color_css}<\/code>
Returns <\/span><\/code><\/p>\n\n\n\n

{inverse}<\/code>
Returns the WCAG compliant contrasting color with the category color.<\/p>\n\n\n\n

{cat_id}<\/code>
Displays the ID for the category the event is in.<\/p>\n\n\n\n

Special use Template Tags<\/h2>\n\n\n\n

{dateid}<\/code>
A unique ID for the current instance of an event. <\/p>\n\n\n\n

{id}<\/code>
The ID for the event record associated with the current instance of an event.<\/p>\n\n\n\n

{skip_holiday}<\/code>
The string literal ‘true’ or ‘false’ indicating whether the skip holiday flag is enabled.<\/p>\n\n\n\n

{event_status}<\/code>
Returns the human-readable label representing the event status: “Draft”, “Published”, “Trash”, etc.
<\/p>\n\n\n\n

Custom Fields in Template Tags<\/h2>\n\n\n\n

Custom fields created either using the custom field manager<\/a> in My Calendar Pro<\/a> or the custom field API will be automatically added to the template tag array. They’ll be available in either legacy templates or using the PHP function for template tags.<\/p>\n","protected":false},"excerpt":{"rendered":"

Legacy Template Tags Legacy templates are managed at My Calendar > Design > Templates if PHP templating is not enabled. All legacy template tags support two attributes: before=”value” and after=”value”. The values of the attributes will be placed before and after the output value. These attribute values must be wrapped in double quotes. Date\/Time template […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[26],"tags":[],"class_list":["post-11","post","type-post","status-publish","format-standard","hentry","category-design"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/11","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=11"}],"version-history":[{"count":14,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/11\/revisions"}],"predecessor-version":[{"id":12,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/posts\/11\/revisions\/12"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/media?parent=11"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/categories?post=11"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar\/wp-json\/wp\/v2\/tags?post=11"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{hcard}<\/code>
Displays the event address in hcard<\/a> format. <\/p>\n\n\n\n