Arlo home

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

ArticleWhat 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" or group="alpha", and the month and year (for example December 2026) in the Upcoming events list, which is always grouped by month.
  • Without a group attribute, 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_value is run, and its output is compared with param. With an empty param and cond="equal" the condition tests whether that shortcode has no output at all.
  • For a short value use true and false. For a block of markup use return_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

AttributeType / valuesDefaultDescription
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 Output is the same as param
  • nequal Output is different from param
  • contains Output contains param
  • ncontains Output does not contain param
  • large_than Output is a number greater than param
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 showbutton is true; buttontext and buttonclass apply only to the button.

Attributes

AttributeType / valuesDefaultDescription
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.