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 core OWA server software. Rather this integration plugin assumes that you have already installed an instance of OWA server accessible over the web 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 facing URL of your OWA server instance (i.e. https://somedomain.com/path/to/owa/). If you have not yet installed an OWA server instance please see the install documentation in the OWA Server repository.
  5. Input your OWA Server user API key. This API key is found within your OWA server instance (Settings > Users > User > Edit).
  6. Save the configuration 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 server 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