Arlo home

Arlo WordPress plugin

The Arlo plugin shows your Arlo events, venues, presenters and categories on your WordPress site. It includes a set of themes, page templates and shortcodes, so you can have a working site quickly and then customize it.

You can download the plugin from the WordPress Plugin Directory or install it from the Plugins menu in WordPress. For common questions, see the frequently asked questions.

What the plugin is for

You manage your training in Arlo: scheduling events, presenters and venues, and publishing them. The plugin connects your WordPress site to your Arlo account so you can promote that training on your own website, in pages that match your site's design.

The plugin supports the browse part of your visitors' journey, and Arlo's own hosted processes carry it through to a booking:

  1. Manage in Arlo. You create and schedule your courses, events, online activities, presenters and venues in Arlo.
  2. Promote on your site. The plugin shows them as lists and as dedicated pages for each course, presenter and venue, with filters, search and regions.
  3. Visitors browse. They explore your catalogue, schedule and upcoming events on your site, in your design.
  4. Register in Arlo. When a visitor chooses to register, a Register link takes them to Arlo's hosted checkout, which handles registration, payment and confirmation. You can change how it looks in your Arlo account.

How it works

  • The plugin keeps a copy of your published Arlo data in its own tables in your WordPress database. Your pages are built from that copy, so showing a page does not call Arlo.
  • An import refreshes the copy on a schedule. Your live pages are not affected while it runs, and new data is published when it completes. If Arlo cannot be reached, your pages keep showing the last copy.
  • Each kind of page, such as the catalogue or the upcoming events list, is a normal WordPress page that holds one global shortcode. A template you can edit decides how it looks. See Shortcodes below, and Pages and routing for how pages map to addresses.

Shortcodes: how pages are built

A shortcode is a WordPress feature: a short tag in square brackets, such as [gallery], that you put in a page and WordPress replaces with generated content when the page is shown. Plugins add their own shortcodes. The Arlo plugin uses them to display your Arlo data, and to let you control exactly how it appears, without writing any PHP.

Arlo uses shortcodes at two levels:

  • In a WordPress page. You put one global shortcode, such as [arlo_event_template_list], on a page. It shows the whole list of events, using the saved template for that kind of page.
  • In a template. A template is HTML with Arlo's template level shortcodes mixed in. Each one outputs one piece of your data, such as a name, date, price, venue or presenter. Some wrap a block that repeats for every item in the list.

This is a small template for a list of courses:

<ul>
[arlo_event_template_list_item]
  <li>
    <h3>[arlo_event_template_name]</h3>
    <p>[arlo_event_template_summary]</p>
    [arlo_event_template_permalink wrap='<a href="%s">View course</a>']
  </li>
[/arlo_event_template_list_item]
</ul>

The shortcodes between [arlo_event_template_list_item] and [/arlo_event_template_list_item] are repeated for each course, and each one is replaced with that course's data. Everything else is plain HTML that you control.

  • Attributes change what a shortcode shows, for example [arlo_event_start_date format="j M Y"] chooses the date format. The shortcode reference lists every attribute.
  • Change the look by editing the HTML around the shortcodes and adding CSS. Change the content by adding, removing or reordering shortcodes. Both are done from the Pages tab in the settings, with no code files to edit.
  • The bundled themes already provide working templates, so you only need to learn shortcodes when you want something different.
  • Each shortcode works only in certain templates, and the shortcode reference says which. It also explains how self-closing and enclosing shortcodes differ.

Getting started

The plugin needs PHP 7.4 or later and WordPress 7.0 or later. The System requirements tab in Arlo's settings checks your server for you.

Your WordPress permalinks must be a pretty structure that ends with a slash, such as Post name. Plain, Numeric and structures starting with index.php are not supported, and Arlo shows a notice if yours is one of them.

  1. Install and activate the plugin.
  2. Publish the draft pages it creates (see Pages and posts).
  3. Go to Arlo's settings, enter your platform name on the General tab and save. This starts your first import.
  4. Check each page is assigned on the Pages tab, then adjust the theme and templates to suit your site.

If imports fail, the cause is usually a firewall or security plugin blocking Arlo's callback. See Fixing blocked callbacks. We strongly recommend a cron job on your server for reliable synchronization.

Pages and posts

When you activate the plugin, it creates any of these pages that are missing, as drafts, and assigns each to its Arlo page type:

Each built-in global shortcode is designed to be mapped to one page, and that page's address is the address of that kind of page. The defaults are /events/, /schedule/, /upcoming/, /eventsearch/, /oa/, /presenters/ and /venues/. To change one, change the page's slug in WordPress and then save the Arlo settings. The shortcode's template holds the HTML layout that is shown wherever the shortcode is used.

Publish the drafts you use. You do not have to use every page: leave any you do not need as a draft and set its host page to (None), but keep the Catalogue, Venues and Presenters pages published if you use event, venue or presenter pages. If a page with the same address already existed, the plugin reuses it without changing it, and you assign it yourself. See Host pages. When you assign a page, the plugin checks its body contains the matching shortcode, because a wrong mapping can break filtering and paging.

The pages above are list pages. The importer also creates a WordPress post for each event template, presenter and venue, which are the single pages for one course, presenter or venue. They use the Event, Presenter and Venue templates. There is one for every item, so you do not map them to a page. Each takes its address from the list page that is its parent: an event is under the Catalogue (/events/123-course-name/), a venue under Venues and a presenter under Presenters, so renaming the parent renames them all. Keep one global shortcode on each page. To add more pages of the same kind, such as a catalogue page for a single category with its own template, use a custom shortcode. For the full picture, see Pages and routing.

Custom style

To change the look of the plugin, add your CSS in WordPress's Additional CSS, not in the plugin's own files. On a classic theme it is under Appearance > Customize, and on a block theme under Appearance > Editor > Styles. Sites that still have CSS in the plugin's Custom CSS tab can migrate it.

The "Powered by Arlo" link in the bundled templates only appears if you turn it on in the settings.

The importer creates a WordPress post for each event template, presenter and venue, so WordPress's built-in search can find them. The date shown in those results is the date the post was created, not the date of an event. If you do not want it, remove or hide it in your theme's search results.

More