Template level shortcodes
Template level shortcodes build the Arlo pages and widgets. You use them in the plugin's templates to lay out each event, session, category, venue or presenter that the plugin shows, and each family of shortcodes has its own article, listed below.
This page also documents the utility shortcodes that belong to no family: they add group headings, labels, conditions, the event search form and the Powered by Arlo credit. To put a whole list or page in a post, use the global level shortcodes instead.
The HTML shown for each shortcode is what the plugin outputs, with line breaks and indentation added for readability. Names, IDs and URLs are examples.
Contents
- Shortcode families – one article for each kind of data
- [arlo_group_divider] – heading at the start of each group in a list
- [arlo_label] – label or wrapper that hides itself when empty (an enclosing shortcode)
- [arlo_condition_return] – output one thing or another depending on another shortcode (and
[arlo_condition_return_level1]to_level4) - [arlo_powered_by] – optional Powered by Arlo credit
- [arlo_search_field] – event search form
Shortcode families
| Article | What the shortcodes are for |
|---|---|
| Event template related | The event templates (the courses) in the Catalogue, Schedule and Event search lists and on the Event page: name, summary, image, price, duration, filters and paging. |
| Upcoming event related | The Upcoming events list and the upcoming events widget: one row for each upcoming event, with its filters, offers and paging. |
| Event related | A single scheduled event or session: dates, location, delivery, presenters, price, registration and availability. |
| Online activity list related | The Online activities list: one row for each online activity, with its filters and paging. |
| Online activity related | A single online activity: name, delivery, offers, credits, registration and structured data. |
| Category related | The category tree, the breadcrumb trail, and the title, header and footer of the selected category. |
| Venue related | The Venues list and the Venue page: name, address, map, directions, parking and the events held there. |
| Presenter related | The Presenters list and the Presenter page: name, profile, qualifications, social links and the presenter's events. |
[arlo_group_divider]
Outputs a heading text on the first item of each group in a list, and nothing on the other items.
Use in: the Catalogue, Schedule and Event search templates, inside [arlo_event_template_list_item]; the Online activities template, inside [arlo_onlineactivites_list_item]; and the Upcoming events template, inside [arlo_upcoming_list_item].
Structure
[arlo_event_template_list_item group="category"]
[arlo_group_divider wrap="<h2 class='arlo-group-divider'>%s</h2>"]
…
[/arlo_event_template_list_item]
Output (example)
Rendered as HTML. The divider appears once, before the first item of each category:
<h2 class="arlo-group-divider">Level 1 Beginners</h2> … <h2 class="arlo-group-divider">Level 2 Intermediate</h2> …
Usage
- The text depends on the list: the category name or the first letter of the name when the list item has
group="category"orgroup="alpha", and the month and year (for exampleDecember 2026) in the Upcoming events list, which is always grouped by month. - Without a
groupattribute, the Catalogue, Schedule, Event search and Online activities lists have no groups and the divider is empty. - Always use
wrap: it is only applied when there is a divider, so no empty heading is left on the other items.
Attributes
None. Accepts the universal attributes; wrap is used in the example above.
[arlo_label]
Outputs the shortcodes and markup placed inside it, with an optional label or wrapper that is shown only when there is something to show.
Type: Enclosing. Put your markup and other shortcodes between [arlo_label] and [/arlo_label].
Use in: any template.
Structure
[arlo_label label="<h4>Address</h4>"]
[arlo_venue_address layout="string" items="line1"]
[arlo_venue_address layout="string" items="suburb,city" wrap="<br>%s"]
[/arlo_label]
Output (example)
Rendered as HTML, for a venue with an address:
<label><h4>Address</h4></label> 1 Example Street<br>Berlin
Usage
- The label (and
wrap) is output only when the enclosed content is not empty. Use it to show a heading above a group of optional shortcodes, such as a venue address or a presenter's events, without leaving an empty heading when they have no output. - The label is placed in a
<label>element before the content.
Attributes
None. Accepts the universal attributes; label and wrap are what it is for.
Examples
With wrap instead of a label, to group the start time and end time in one element:
[arlo_label wrap="<span class='arlo-event-time'>%s</span>"]
[arlo_event_start_date format="%a %I:%M %p"] - [arlo_event_end_date format="%a %I:%M %p"]
[/arlo_label]
<span class="arlo-event-time">Tue 10:00 AM - Wed 05:00 PM</span>
[arlo_condition_return]
Runs another shortcode, compares what it outputs with a value, and outputs one thing when they match and another when they do not.
Type: Enclosing when you use return_content="true": put your markup and other shortcodes between [arlo_condition_return] and [/arlo_condition_return]. Otherwise it is self-closing.
Use in: any template.
Structure
[arlo_condition_return param="Online" shortcode_value="arlo_event_location" cond="contains" return_content="true"]
[arlo_event_location wrap="<div class='arlo-event-location'>%s</div>"]
[/arlo_condition_return]
Output (example)
Rendered as HTML, for an online event (the enclosed content):
<div class="arlo-event-location">Online</div>
For an event at a venue the condition is not met, and nothing is output.
Usage
- The shortcode named in
shortcode_valueis run, and its output is compared withparam. With an emptyparamandcond="equal"the condition tests whether that shortcode has no output at all. - For a short value use
trueandfalse. For a block of markup usereturn_content="true"and put the block inside the shortcode. - WordPress cannot nest an enclosing shortcode inside another with the same name. To nest conditions, use
[arlo_condition_return_level1]inside[arlo_condition_return],[arlo_condition_return_level2]inside that, and so on to_level4. They accept the same attributes. - The result is filtered like WordPress post content, and any shortcodes in it are run.
Attributes
| Attribute | Type / values | Default | Description |
|---|---|---|---|
| shortcode_value | Text | None | The shortcode to run, written without square brackets and with any attributes, for example arlo_event_location. Use the other kind of quote inside it from the one that surrounds the attribute. |
| param | Text | Empty | The value to compare the shortcode output with. Leave it empty to test for no output. |
| cond | Option:
|
equal |
How the output is compared with param. |
| true | Text; HTML as allowed in a WordPress post | Empty | Output when the condition is met. It can contain shortcodes. |
| false | Text; HTML as allowed in a WordPress post | Empty | Output when the condition is not met. It can contain shortcodes. |
| return_content | Option: true |
Not set | Outputs the enclosed content instead of true when the condition is met. |
Also accepts the universal attributes.
Examples
Choosing between two pieces of text with true and false, here to change a wrapper when an event template has no image:
[arlo_condition_return param="" shortcode_value="arlo_event_template_hero_image" cond="equal"
true="<div class='arlo-event-basic noimage'>"
false="<div class='arlo-event-basic'>"]
<div class="arlo-event-basic">
Nesting: show a different location icon for online events and for events at a venue, inside a block that is itself conditional:
[arlo_condition_return param="" shortcode_value="arlo_event_name" cond="nequal" return_content="true"]
[arlo_condition_return_level1 param="Online" shortcode_value="arlo_event_location" cond="equal" true="Online" false="At a venue"]
[/arlo_condition_return]
At a venue
[arlo_powered_by]
Outputs a small "Powered by Arlo" logo that links to arlo.co.
Use in: any template. The bundled templates include it at the end of each page.
Structure
[arlo_powered_by]
Output (example)
Rendered as HTML, when the credit is enabled:
<div class="arlo-powered-by">
<a aria-label="Arlo Powered By" href="https://www.arlo.co/…" target="_blank">
Powered by <img src="…/public/assets/img/Arlo-logo.svg" alt="Arlo training & Event Software">
</a>
</div>
Usage
- Since 5.2.0 the credit is off by default. A site administrator turns it on with the Powered by Arlo link enabled setting on the Misc tab of the Arlo settings (see Settings).
- When the setting is off the shortcode outputs nothing, so you can leave it in your templates.
Attributes
None. Accepts the universal attributes.
[arlo_search_field]
Outputs a search form that sends the visitor to the Event search page.
Use in: the Event search template. It also works in the Catalogue and other templates, and in a post or page.
Structure
[arlo_search_field placeholder="Search events" showbutton="true" buttontext="Search" buttonclass="arlo-button" inputclass="my-search-input"]
Output (example)
Rendered as HTML:
<form class="arlo-search" action="https://example.com/search/">
<input type="hidden" id="arlo-nonce" name="arlo-nonce" value="…" />
<input type="hidden" name="_wp_http_referer" value="/search/" />
<input type="text" class="arlo-search-field my-search-input" placeholder="Search events"
aria-label="Search events" name="arlo-search" value="">
<input type="submit" class="arlo-search-button arlo-button" value="Search">
</form>
Usage
- The form is shown only when your site has an Event search page (set on the Pages tab of the Arlo settings); otherwise nothing is output.
- The search term is sent to the Event search page, and the field shows the current term when you are already on a search results page.
- The button is only shown when
showbuttonistrue;buttontextandbuttonclassapply only to the button.
Attributes
| Attribute | Type / values | Default | Description |
|---|---|---|---|
| placeholder | Text | Search for an event | Placeholder text for the search field, also used as its accessible label. |
| showbutton | Boolean | true |
Shows the submit button. Use false to search by pressing Enter. |
| buttontext | Text | Search | The text on the submit button. |
| buttonclass | Text | None | An extra CSS class for the submit button. |
| inputclass | Text | None | An extra CSS class for the search field. |
Also accepts the universal attributes.