Skip to main content

Placeholders

Events Manager has a templating syntax that lets you customise events information in the events list and pages. You can use this syntax both in the Events Manager Settings page and in the template tags or shortcodes that you might insert in your theme templates or pages/posts. The syntax is quite simple, just write your html code in the usual way, then you can add a number of placeholders corresponding to the information you want to show.

See the bottom of this page for a few examples.

When you'd like to show information pertaining to events, you can choose from the following. In all cases, you should also be able to call location related placeholders.

[em_placeholders type="events"]

When you'd like to show information pertaining to locations, you can choose from the following.

[em_placeholders type="locations"]

In most cases you should also be able to use event and location placeholders when able to use these, which will show the event and corresponding location that has been booked for.

[em_placeholders type="bookings"]

Category Placeholders​

When displaying category lists, or formatting a single category page, you can choose from the following:

[em_placeholders type="categories"]

Tag Placeholders​

When displaying tag lists, or formatting a single tag page, you can choose from the following:

[em_placeholders type="tags"]

Conditional Placeholders​

For those of you asking "I'd only like to show something IF", then you should read up on our conditional placeholders too, which works much in the same way as normal placeholders.

Examples​

If you look at the default events page format, which is found in Events > Settings > Formats/Layouts > Events Format in your admin area:

<div style=”float:right; margin:0px 0px 15px 15px;”>#_MAP</div>
<p>
<strong>Date/Time</strong><br/>
Date(s) – #_EVENTDATES<br /><i>#_EVENTTIMES</i>
</p>
<p>
<strong>Location</strong><br/>
#_LOCATIONLINK
</p>
<p>
<strong>Category(ies)</strong>
#_CATEGORIES
</p>
<br style=”clear:both” />
#_NOTES
{has_bookings}
<h3>Bookings</h3>
#_BOOKINGFORM
{/has_bookings}

this is how it appears on a single event page:

Single Event Placeholder Example

Here is an example where you combine shortcodes and placeholders to display customized information about events happening tomorrow. Note that this is pasted into your page content in HTML view of the editor.

<ul>[events_list scope=”month”]<li>#_EVENTLINK – Dates : #_EVENTDATES, Times : #_EVENTTIMES</li>[/events_list]</ul>

This is what it would look like:

Placeholder example of events list shortcode with custom placeholders