Skip to content

Home

Jump to bottom
Peter Adams edited this page Sep 18, 2021 · 5 revisions

Installation

The WordPress plugin does not install the OWA software. Rather this integration plugin assumes that you have already installed an instance of OWA on either the same or a remote server.

Steps to Install

  1. Download the plugin from the WordPress.org plugin repository.
  2. Activate the plugin
  3. Navigate to the plugin's admin page
  4. Input the public url of your OWA instance. Read this if you have not yet installed an OWA instance.
  5. Input your OWA admin user API key. (found within your OWA instance at Settings > Users > Edit).
  6. Save those settings
  7. Choose a website to track to use from the drop down list. If your website is not already present in the list then you need to add it to your OWA instance (Settings > Tracked Websites > Add)

WordPress Theme Compatibility

In order for OWA's WordPress plugin to work, your WordPress theme needs have the following line of php somewhere in your theme's template files:

<?php wp_head(); ?>

Most WordPress themes are well formed and come with this Wordpress API call in their templates already, so most people will not need to modify their theme to make OWA work. For more information on how to make sure that your themes work with WordPress plugins see: http://codex.wordpress.org/Theme_Development

Incompatible WordPress Plugins

  • WP-Cache - OWA does not currently work if WP-Cache is active. Specifically it breaks tracking and the geolocation reports due to it's instance on a setting text/html Content-Type HTTP header.
Clone this wiki locally