All 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>"}

Using 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.

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

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

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

{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.)

{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}
URL to submit event to Google Calendar

{gcal_link}
Link to submit event to Google Calendar, with class “gcal”

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

{repeats}
Shows the number of repetitions of the event.

{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 empty.

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

Category Template Tags

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

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

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