Arlo home

Global level shortcodes

Global shortcodes are the page-level shortcodes you put in a WordPress page or post. Each one is replaced by the saved template for that kind of page, and that template then builds the list from the shortcodes in Template shortcodes.

Each global shortcode is designed to be mapped to one page, and the page's address is the address of that kind of page. The plugin creates these pages for you, with default addresses such as /events/, and puts the bare shortcode in them. Add attributes when a page should show only part of the list. You assign the pages, and add more of them as custom shortcodes, on the Pages tab. See Pages and routing.

Keep one global shortcode on each page. A page's address carries one set of filters and one page number, and every Arlo shortcode on the page reads that same set, so two cannot each apply their own. This matters most for lists with filters. See One global shortcode per page.

The HTML shown is indicative, with line breaks and indentation added for readability. The real markup comes from your saved template; the examples show the overall shape of the bundled default.

Contents

Filtering

The catalogue, schedule, upcoming, event search and online activities shortcodes accept filter attributes that limit what the page lists, and the template's list and its pagination follow them. Most filters have a …hidden twin that excludes the matching items instead of showing only them. Use filters for a page that should always show a fixed subset, such as one category or one location.

Filters chosen by the visitor (they arrive in the address) override the same filter set as a shortcode attribute, and a filter set for the page on the Pages tab (Page filtered by) applies only when the shortcode does not set it.

Filters take one value, except category, categoryhidden and venue, which also accept a comma-separated list. Values are Arlo IDs or names, not WordPress slugs or IDs. The venue and presenter shortcodes have no filters.

Filter attributes

AttributeType / valuesDefaultDescription
All list shortcodes
category Comma-separated list of Integers (Arlo category IDs) None Shows only templates in these categories, and limits the category filter dropdown to them. Sub-categories are included when the list item sets show_child_elements="true".
categoryhidden Comma-separated list of Integers (Arlo category IDs) None Hides templates in these categories.
templatetag Text (a template tag as written in Arlo) None Shows only templates with this tag.
templatetaghidden Text (a template tag as written in Arlo) None Hides templates with this tag. Not used by the event search page.
Catalogue, schedule, event search and upcoming
location Text (an event location name as written in Arlo, such as Sydney) None Shows only events at this location.
locationhidden Text (an event location name) None Hides events at this location.
delivery
  • 0 Workshop
  • 1 Online
  • 99 Online Activity
None Shows only this kind of delivery. Upcoming lists events only, so 99 does not apply there.
deliveryhidden Option: 0199 None Hides this kind of delivery.
venue Comma-separated list of Integers (Arlo venue IDs) None Shows only events at these venues.
state Text (a state as written in the venue address) None Shows only events at venues in this state.
Catalogue, schedule and event search
search Text None Shows only templates matching this text. On the event search page it normally comes from the search form.
Upcoming only
eventtag Text (an event tag as written in Arlo) None Shows only events with this tag.
eventtaghidden Text (an event tag as written in Arlo) None Hides events with this tag.
templateid Integer (an Arlo event template ID) None Shows only the events of this one template. It is the Arlo ID, not the WordPress page ID.
presenter Integer (an Arlo presenter ID) None Shows only events with this presenter.
month Text in the form YYYY-MM-DD:YYYY-MM-DD None Shows only events that start between these two dates, inclusive.

See the attribute values and attribute types reference for the notation used here.

[arlo_event_template_list]

The catalogue page: a list of your event templates, usually grouped by category, with the category list, filters and paging.

Use in: the page assigned to the Catalogue on the Pages tab. The page is replaced by the Catalogue template.

Structure

[arlo_event_template_list category="12" delivery="0"]

Output (example)

A page containing the shortcode above shows the saved template's output, here limited to category 12 and workshops:

<div class="arlo-categories">…category list…</div>
<form class="arlo-filters">…filter dropdowns…</form>
<table class="table event-templates">
  <tr>…column headings…</tr>
  <tr>…one row for each event template…</tr>
</table>
<div class="arlo-pagination">…page links…</div>

Usage

  • Filters apply to the list and its pagination in the template. Sub-categories are only listed when the list item sets show_child_elements="true".
  • The page size, grouping and columns are set in the template by [arlo_event_template_list_item] and [arlo_event_template_list_pagination], not here.
  • Edit the template on the Templates tab; the Pages tab sets which page it appears on.

Attributes

Only the filter attributes: category, categoryhidden, templatetag, templatetaghidden, location, locationhidden, delivery, deliveryhidden, venue, state and search. Also accepts the universal attributes.

[arlo_schedule]

The schedule page: the same kind of list as the catalogue, with its own template, page and settings, so you can present the dates differently.

Use in: the page assigned to the Schedule on the Pages tab. The page is replaced by the Schedule template.

Structure

[arlo_schedule location="Sydney" delivery="0"]

Output (example)

A page containing the shortcode above shows the saved template's output, here limited to workshops in Sydney:

<div class="arlo-categories">…category list…</div>
<form class="arlo-filters">…filter dropdowns…</form>
<table class="table event-templates">
  <tr>…column headings…</tr>
  <tr>…one row for each event template…</tr>
</table>
<div class="arlo-pagination">…page links…</div>

Usage

Attributes

The same filter attributes as [arlo_event_template_list]. Also accepts the universal attributes.

[arlo_upcoming_list]

The upcoming events page: individual events in date order, usually grouped by month, with filters and paging.

Use in: the page assigned to Upcoming events on the Pages tab. The page is replaced by the Upcoming events list template.

Structure

[arlo_upcoming_list location="Sydney" eventtag="Open enrolment"]

Output (example)

A page containing the shortcode above shows the saved template's output, here limited to events in Sydney with the tag:

<form class="arlo-filters">…filter dropdowns…</form>
<ul class="arlo-list upcoming">
  <li class="arlo-group-divider">December 2026</li>
  <li>…one entry for each event…</li>
</ul>
<div class="arlo-pagination">…page links…</div>

Usage

  • It lists events, not templates, so a template with several events appears once for each event.
  • The page size and grouping come from [arlo_upcoming_list_item] in the template.
  • When no event matches, the template's no-events message is shown.

Attributes

The filter attributes: category, categoryhidden, templatetag, templatetaghidden, location, locationhidden, delivery (0 and 1), deliveryhidden, venue and state, plus the ones that only apply here: eventtag, eventtaghidden, templateid, presenter and month. Also accepts the universal attributes.

[arlo_venue_list]

The venues page: a list of your venues.

Use in: the page assigned to Venues on the Pages tab. The page is replaced by the Venue list template.

Structure

[arlo_venue_list]

Output (example)

A page containing the shortcode shows the saved template's output:

<ul class="arlo-list venues">
  <li>…name, address, map for each venue…</li>
</ul>
<div class="arlo-pagination">…page links…</div>

Usage

Attributes

None. Accepts the universal attributes.

[arlo_presenter_list]

The presenters page: a list of your presenters.

Use in: the page assigned to Presenters on the Pages tab. The page is replaced by the Presenter list template.

Structure

[arlo_presenter_list]

Output (example)

A page containing the shortcode shows the saved template's output:

<ul class="arlo-list presenters">
  <li>…name and profile for each presenter…</li>
</ul>
<div class="arlo-pagination">…page links…</div>

Usage

Attributes

None. Accepts the universal attributes.

[arlo_event_template_search_list]

The event search page: a search form and the event templates that match the visitor's search, with paging.

Use in: the page assigned to Event search on the Pages tab. The page is replaced by the Event search list template.

Structure

[arlo_event_template_search_list category="12"]

Output (example)

A page containing the shortcode above shows the saved template's output, here searching only within category 12:

<form class="arlo-search">…search field and button…</form>
<table class="table event-templates">
  <tr>…one row for each matching event template…</tr>
</table>
<div class="arlo-pagination">…page links…</div>

Usage

  • The search text arrives from the search form in the template, [arlo_search_field], so you do not set search yourself.
  • The list is built by [arlo_event_template_list_item], as on the catalogue.
  • Page filters from the Pages tab are not available for this page.

Attributes

The filter attributes of [arlo_event_template_list], except templatetaghidden. Also accepts the universal attributes.

[arlo_onlineactivites_list]

The online activities page: a list of your online activities, usually grouped by category, with filters and paging. The shortcode name is spelled onlineactivites, as in the plugin.

Use in: the page assigned to Online activities on the Pages tab. The page is replaced by the Online activities list template.

Structure

[arlo_onlineactivites_list category="12" templatetaghidden="Internal"]

Output (example)

A page containing the shortcode above shows the saved template's output, here limited to category 12 and without the tagged activities:

<form class="arlo-filters">…filter dropdowns…</form>
<ul class="arlo-online-activities arlo-list">
  <li class="arlo-online-activity arlo-group-divider">Category name</li>
  <li class="arlo-online-activity">…one entry for each online activity…</li>
</ul>
<div class="arlo-pagination">…page links…</div>

Usage

  • The page size and grouping come from [arlo_onlineactivites_list_item] in the template.
  • Online activities have no location or delivery, so only the category and template tag filters apply.

Attributes

Only the filter attributes category, categoryhidden, templatetag and templatetaghidden. Also accepts the universal attributes.

Custom shortcodes

Custom shortcodes let you add more pages of the same kinds, for example a second catalogue page that shows only one category. You create them on the Pages tab. For a worked example, see a landing page for one category.

Use in: any page you assign to the new entry on the Pages tab.

Structure

Create a shortcode named mycourses with the type Catalogue, then use:

[arlo_mycourses category="12"]

Output (example)

The output is that of the chosen type, built from the custom shortcode's own template, so the page looks like the catalogue example above.

Usage

  • Enter a name of up to 15 letters, numbers and underscores. It becomes [arlo_name] and must not already be a shortcode.
  • Choose one of the types Catalogue, Schedule, Upcoming, Online Activities, Presenters or Venues. The type decides which attributes the shortcode accepts.
  • The new entry starts from the default template for its type, not from any changes you made to the original page's template, and has its own template, page and Page filtered by settings, so changing it does not affect the original page.
  • Delete a custom shortcode from its own tab on the Pages tab.

Attributes

The same as the shortcode for its type: the filter attributes for Catalogue, Schedule and Upcoming, the online activities filters for Online Activities, and none for Presenters and Venues. Also accepts the universal attributes.