Wordpress Plugin Implementation

The SimpleReach Analytics plugin provides a convenient and quick way for WordPress-powered sites to get up and running with SimpleReach.

DOWNLOAD THE PLUGIN 

If you have not received the plugin .zip file via email, you may visit this page and click on 'Source code (zip)' (as seen in the screenshot below) to download the most recent version.

UPLOAD TO YOUR SITE 

You may upload the plugin in one of two ways:

METHOD 1: UPLOAD THE PLUGIN TO YOUR SITE VIA THE WORDPRESS INTERFACE

1. Go to ‘Plugins’ -> ‘Add New’ and choose the ‘upload’ option.

2. Find the file on your computer (make sure it still has the .zip extension or you won’t be able to upload it). Once you’ve selected the file, click ‘Install Now’ to install the plugin.

3. Once the plugin has been installed successfully, click ‘Activate Plugin.’

You can also activate the plugin from the plugin listing (‘Plugins’ -> ‘Installed Plugins')

4. With the plugin installed and activated, navigate to ‘Settings’ -> ‘SimpleReach Analytics’

and enter your Publisher ID into the PID field. Your PID will look something like this:

pid: '4fc608fea782f333ea0000fb'

The PID below (using 24 zeros) is used for testing, but otherwise this is where you would place your PID:

(You should have been provided with a PID via email, but if not, please feel free to email us and ask!)

METHOD 2: UPLOAD THE PLUGIN TO YOUR SITE VIA FTP

1. Unzip the plugin and, using your favorite FTP program, upload the unzipped plugin to the plugin directory of your site (‘wp-content’ -> ‘plugins’)

2. Log in to your WordPress site and navigate to ‘Plugins’ -> ‘Installed Plugins’.

3. Find ‘SimpleReach Analytics’ in the list and activate it

4. With the plugin installed and activated, navigate to ‘Settings’ -> ‘SimpleReach Analytics’

and enter your Publisher ID into the PID field. Your PID will look something like this:

pid: '4fc608fea782f333ea0000fb'

The PID below (using 24 zeros) is used for testing, but otherwise this is where you would place your PID:

(You should have been provided with a PID via email, but if not, please feel free to email us and ask!)

CONFIGURATION 

Set any additional tracking settings you’d like to use for your site.

Please leave these fields unchecked unless you are certain that you need them—if you're not sure, please feel free to email us and ask!

IFRAME SETTINGS

Disable iFrame loading of the SimpleReach code: We strongly suggest that you do not disable iFrame loading of the SimpleReach code. We load in an iFrame in order to capture the most accurate data. This is also a security precaution we take for publishers to make sure our code never impacts page load time given that it loads in an iFrame. Additionally, having our page view request fire in the iFrame helps ensure that other scripts on the page do not impact it.

ADVANCED TRACKING SETTINGS

Track pages: 'Pages' are those created from the 'pages' link in the left sidebar (such as an 'About' page). These pages generally do not contain content (such as articles or blog posts) that would benefit from being tracked.

Track attachment pages: These are the pages created in the 'media' link on the left sidebar. Generally, attachment pages do not contain content (such as articles or blog posts) that would benefit from being tracked.

Track author, category, and tag pages: This includes WordPress, author, category, tag, attachment, and search results pages. These pages generally do not contain content (such as articles or blog posts) that would benefit from being tracked.

Track everything, including the home page: This would track all of the above options in addition to the home page, none of which generally contain content (such as articles or blog posts) that would benefit from being tracked.

Send URLs as HTTP: enable this option only if your site uses a combination of both HTTP and HTTPS.

ADVANCED IMPLEMENTATION 

If you have an unconventional setup, our plugin provides a few WordPress filters you can use to change the data before it gets sent to us. The list of filters we provide are:

sranalytics_title
sranalytics_url
sranalytics_date
sranalytics_channels
sranalytics_tags
sranalytics_authors

For example, if you wanted an author's name to be sent to us prepended by an honorific such as 'The Amazing ', you could use the sranalytics_authors filter by including it in your WordPress theme code (typically inside 'functions.php') like so:

add_filter( 'sranalytics_authors', function( $authors ) {
  $new_authors = array();
  foreach ( $authors as $author ) {
      $new_authors[] = "The Amazing " . $author;
  }
  return $new_authors;
} );

If you need more information on how to use WordPress filters in general, you can check out the documentation here.