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 tags support the “format” attribute: format=”M, Y”, where the value is a PHP formatted date string. Only dtstart and dtend include the full date/time information for formatting.

Example: {title before="<h3>" after="</h3>"}

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

Template tags in PHP templating

If you’ve switched to My Calendar’s PHP templating system, these template tags can be retrieved using mc_template_tag( $event, $key ), where $key is the portion of the template tag between the curly braces. E.g., mc_template_tag( $event, 'title' ). 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() echoes the value, mc_get_template_tag() returns it.

Event Template Tags

{title}
Displays the title of the event.

{link_title}
Displays title of the event as a link if a URL is present, or the title alone if no URL is available.

{link_image}
Displays featured image of the event as a link if a URL is present, or the image alone if no URL is available.

{time}
Displays the start time for the event.

{time24}
Displays the start time using the 24 hour clock.

{runtime}
Human language estimate of how long an event will run.

{date}
Displays the date on which the event begins.

{datebadge}
Shows the output used for the date badge format (month abbreviation and day number, stacked.)

{began}
Displays the date on which the series of events began (for recurring events).

{enddate}
Displays the date on which the event ends.

{endtime}
Displays the time at which the event ends.

{daterange}
Displays the beginning date to the end date for events. Does not show end date if same as start date.

{timerange}
Displays the beginning and end times for events. Does not show end time if same as start or if marked as hidden.

{datespan}
Displays the full span from the initial date/time to the end date/time for long events.

{userstart}
Outputs the start date & time for manipulation by JS to display dates & times in the current visitor’s time zone.

{userend}
Outputs the end date & time for manipulation by JS to display end dates & end times in the current visitor’s time zone.

{userstartdate}
Outputs the starting date for manipulation by JS to display dates in the current visitor’s time zone.

{userenddate}
Outputs the ending date for manipulation by JS to display dates in the current visitor’s time zone.

{userstarttime}
Outputs the starting timefor manipulation by JS to display times in the current visitor’s time zone.

{userendtime}
Outputs the ending time for manipulation by JS to display times in the current visitor’s time zone.

{dtstart}
Timestamp for beginning of event.

{dtend}
Timestamp for end of event.

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

{related}
List of other events in the same event group. (Only on single event views.)

{recurring}
List of recurring dates on this event.

{author}
Displays the WordPress author who posted the event.

{gravatar}
Displays the gravatar image for the event author.

{host}
Displays the name of the person assigned as host for the event.

{host_email}
Displays the email address of the person assigned as host for the event.

{host_gravatar}
Displays the gravatar image for the event host.

{shortdesc}
Displays the short version of the event description if provided.

{shortdesc_raw}
Displays short description without converting paragraphs.

{shortdesc_stripped}
Displays short description with any HTML stripped out.

{excerpt}
Like the_excerpt(); displays short description if provided, otherwise excerpt from description.

{autoexcerpt}
Like the_excerpt(); display truncated excerpt from description.

{description}
Displays the description of the event.

{description_raw}
Displays description without converting paragraphs.

{description_stripped}
Displays description with any HTML stripped out.

{access}
Unordered list of accessibility options for this event.

{image}
Image associated with the event. (HTMl)

{image_url}
Image associated with the event. (image URL only)

{full}
Event post thumbnail, full size, full HTML

{thumbnail} / {thumbnail_url}
Event post thumbnail, thumbnail size, full HTML / image URL only

{medium} / {medium_url}
Event post thumbnail, medium size, full HTML / image URL only

{medium_large} / {medium_large_url}
Event post thumbnail, medium_large size, full HTML / image URL only

{large} / {large_url}
Event post thumbnail, large size, full HTML / image URL only

{link}
Displays the URL provided for the event.

{ical}
Produces the URL to download an iCal formatted record for the event.

{ical_html}
Produces a hyperlink to download an iCal formatted record for the event.

{gcal}, {office}, {outlook}
URL to submit event to Google Calendar/Office 365/Outlook.

{gcal_link} , {office_link}, {outlook_link}
Link to submit event to Google Calendar, Office 365, Outlook.

{recurs}
Shows the recurrence status of the event. (Daily, Weekly, etc.)

{repeats}
Shows the number of repetitions of the event (older events) or the date the event repeats until (newer events)

{details}
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.

{details_link}
Raw URL for the details link; empty if target URL not defined.

{permalink}
Alias for {details_link}. Raw URL for the details link; empty if target URL not defined.

{linking}
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.

{linking_title}
Like {link_title}, but uses {linking} instead of {link}.

{event_tickets}
URL to ticketing for event.

{event_registration}
Registration information about this event.

{event_status}
Displays the current status of the event: either “Published” or “Reserved” – primary used in email templates.

Location Template Tags

{location}
Displays the name of the location of the event.

{street}
Displays the first line of the site address.

{street2}
Displays the second line of the site address.

{city}
Displays the city for the location.

{state}
Displays the state for the location.

{postcode}
Displays the postcode for the location.

{region}
Shows the custom region entered for the location.

{country}
Displays the country for the event location.

{sitelink}
Output the URL for the location link.

{phone}
Output the stored phone number for the location.

{sitelink_html}
Output a hyperlink to the location’s listed link with default link text.

{hcard}
Displays the event address in hcard format.

{link_map}
Displays a link to a Google Map of the event, if sufficient address information is available. If not, will be empty.

{map_url}
Produces the URL for the Google Map for the event location if sufficient address information is available. If not, will be empty.

{map}
Output Google Map if sufficient address information is available. If not, will be an empty string.

{location_access}
Unordered list of accessibility options for this location.

Category Template Tags

{category}
Displays the name of the category the event is in.

{categories}
Returns an HTML formatted list of the categories for this event.

{icon}
Produces the address of the current event’s category icon.

{icon_html}
Produces the HTML for the current event’s category icon.

{color}
Produces the hex code for the current event’s category color.

{color_css}
Returns <span style='background-color: $event->category_color; color: $inverse'>

{close_color_css}
Returns </span>

{inverse}
Returns the WCAG compliant contrasting color with the category color.

{cat_id}
Displays the ID for the category the event is in.

Special use Template Tags

{dateid}
A unique ID for the current instance of an event.

{id}
The ID for the event record associated with the current instance of an event.

{skip_holiday}
The string literal ‘true’ or ‘false’ indicating whether the skip holiday flag is enabled.

{event_status}
Returns the human-readable label representing the event status: “Draft”, “Published”, “Trash”, etc.

Custom Fields in Template Tags

Custom fields created either using the custom field manager in My Calendar Pro 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.