Woopra Installation Guide

Installing Woopra is a simple, five step process.

1

Sign Up for Woopra

Sign up for Woopra. Respond to the confirmation email, login to Woopra and add a website.

Please enter the website URL of the website you want tracked. Woopra currently does not track redirects. Woopra Plans are based on individual websites, not Member accounts.

 Sign up for Woopra
2

Choose Your Woopra Subscription Plan

For a description of the various Woopra pricing packages and plans, see our Woopra Plans. To update or change your Woopra plan, go to the Members Area > Woopra Package page.

For more information on how Woopra works and tips, see our Woopra FAQ. Check out our blog and Twitter account for updates.

You can upgrade or change your package at any time per your Woopra plan specifications.

 Woopra Plans
3

Install Woopra on Your Website

Install Woopra by placing the Woopra JavaScript in the footer of every page you want tracked. Specific instructions are for a variety of publishing platforms including WordPress, Joomla, Drupal, Invision Powerboard, Movable Type, TypePad, and Blogger. Woopra will not work on blog and website platforms which will not permit JavaScript. See the notes on Woopra Installation Tips for troubleshooting problems with installing and activating Woopra, and check our FAQ for more help and information.

Once installed, Woopra analytics can be tracked through the , the Woopra Web App in the Members Area, and the soon-to-be-released Woopra Mobile Versions.

NOTE: If you have been using the manual method of installing the Woopra JavaScript, then add the Woopra WordPress Plugin or another third-party add-on, you will get double entries. Delete the JavaScript first.
4

Download the Woopra Desktop Client

Visit the Download page to download the Woopra Desktop client for your operating system. The Woopra Desktop Client requires the latest version of Java. Update Java before installing Woopra.

Currently, Woopra runs on Windows, Mac, and Linux. For other operating systems, see the tips below on various operating systems for more helpful information and resources. Once installed, watch the real-time, live statistics and analytics come to life.

 Download Woopra
5

Need More Help?

 Woopra Forums

* Woopra’s subscription packages are subject to modification and change without notice. See Woopra Policies for more information.

 

Installing the Woopra JavaScript on Your Site

In order for Woopra to recognize and track your site, you must install the Woopra JavaScript from the Woopra Members area. It can be installed manually or with a Plugin or add-on.

To verify the success of your Woopra JavaScript installation, check the source code of the page in your browser and search for “Woopra” and match the results with the JavaScript in the Woopra Setup page. If you are having trouble, see Woopra Installation Tips and Woopra FAQ for troubleshooting problems with installing and activating Woopra, and check into the Woopra Forums.

The Woopra Plugins, add-ons, tips and articles below are generously supplied and supported by the Woopra Community, and may require the Woopra API Key in order to take advantage of Woopra features. Woopra currently supports the Woopra WordPress Plugin and Manual Installation. For support from other plugins and add-ons, please see their authors. For those wishing to customize the Woopra JavaScript or create a third-party script, Plugin, or add-on, check out the Woopra Developers guide.

The Woopra API key is found at Members > My Websites > Edit Settings > API Key for plugins and add-ons that require it.

The following are instructions for installing Woopra for specific website and blog platforms.

Install Woopra WordPress logo iweb logo Blogger logo Drupal logo WordPress logo MediaWiki logo Ruby on Rails logo cakePHP logo vBulletin logo rapidweaver-logo
bbPress logo MojoPortal logo phpBB logo habari-logo magneto-logo habari-logo tumblr-logo aspnet-logosm squarespace e107 cafepress

 

Platform

Installation Tips

Features
Install Woopra Manual Installation

To install Woopra manually:

  1. Copy the JavaScript code from within the Woopra Members administration settings.
  2. Place the JavaScript link in the footer before the </body> of your website on all the pages to be tracked.
  3. View your website pages’s source code to ensure Woopra’s JavaScript is installed properly.
 N/A
WordPress logo WordPress
  1. Install the Woopra WordPress Plugin.
  2. Activate it on single hosted versions (stand alone) of .
  3. Enter the API Key under the WordPress Administration Panels > Settings.
  4. Your WordPress Theme must have the <?php wp_footer(); ?> before the </BODY> element in the footer.php Theme template file found in your WordPress Theme directory under /wp-content.
  5. Verify the Woopra JavaScript installation by viewing the source code of any page on your blog.

NOTE: The Woopra WordPress Plugin is the only Plugin and add-on currently supported by Woopra. If you are having problems or errors with the Plugin, please deactivate and delete it and use the manual method for installing Woopra until we resolve a known issue impacting a few installations of WordPress.

 Visitor Analytics
System Analytics
Pages Analytics
Referrers Analytics
Searches
Event Tracking
Variable Visitor Timeouts
bbPress logo bbPress

See Woopra and bbPress notes in the Woopra Forum to install Woopra on bbPress with integration of the WordPress blog logins.

 See WordPress
Joomla  
iweb logo iWeb  
Blogger logo Blogger/Blogspot

Use the HTML/JavaScript gadget tool on Blogger as shown in the Blogger-Blogspot Layout Guide.

See also Woopra Tracker, though it might need updating.

  
Drupal logo Drupal

There are several choices to install Woopra on Drupal:

  • Use the Drupal Plugin.
  • See “Adding JavaScript to your theme or module” by Drupal with instructions to add the Woopra JavaScript to your Theme’s .info file.
  • Install it manually by opening the folder and file for your footer area in Drupal, paste the Woopra JavaScript before the </body> closing tag, and save the file.
  
Tumblr logo Tumblr
  1. On the Tumblr Dashboard, choose Customize.
  2. Go to Theme > Use Custom HTML.
  3. Scroll down to the bottom of the HTML file and place the Woopra JavaScript between the last </div> and the </body> HTML tags.
  4. Click Update Preview.
  5. Check the web page’s source code to ensure the Woopra JavaScript is visible at the bottom of the page, and correct.
  
WordPress logo Invision PowerBoard

See Installing Woopra on Invision Powerboard from the Woopra Forums.

  
MediaWiki logo MediaWiki

Woopra is listed as a beta among the Media Wiki AutoExtentionList for inclusion on MediaWiki sites.

  
MojoPortal logo mojoPortal

mojoPortal 2.2.9.2 now includes easy integration with Woopra via the Site Settings page. See the instructions guide for details.

  
phpBB logo phpBB

Use the current version of the Woopra JavaScript and the tips for installing Woopra on phpbb3 and phpbb2.

  
asp.net ASP.NET

See Embedding Localized Resources for a JavaScript File, and follow examples for installing Google Analytics. May also be able to use Woopra Tracker.

 
Ruby on Rails logo Ruby on Rails

See the Ruby on Rails Woopra Analytics Gem Installation Guide for the Ruby on Rails Woopra Analytics Gem.

  
Woltlab Wbb3 Woltlab Wbb3

Woltlab Wbb3 offers Integrating Woopra into Woltlab Wbb3.

  
cakePHP logo CakePHP

CakePHP Woopra Integration Installation

  
vBulletin logo vBulletin

The vBulletin Woopra Plugin applies to older versions of vBulletin and the Woopra JavaScript. We are awaiting an update from the author. Until then, use one of these guides for installing Woopra on vBulletin 4+.

  
habari-logo Habari

Habari Woopra Plugin

  
magneto-logo Magneto

Woopra for Magento Extension

  
rapidweaver-logo RapidWeaver
  1. Copy Woopra JavaScript
  2. In RapidWeaver, click on Site Setup Up > Advance
  3. Paste code into Google Analytics form option (above or below GA code if present)
  4. Click Okay.
  
squarespace-logo SquareSpace

Unfortunately, SquareSpace does not currently permit JavaScript, therefore Woopra is unable to be installed. We’d love to help you use Woopra on SquareSpace, but until they offer an option for Woopra…

  
e107-logo e107

Follow e107’s guide for installing Google Analytics and JavaScripts to install Woopra.

  
cafepress-logo CafePress

At this time, Woopra is unable to be used with subweb sites and platforms such as those offered by CafePress. The format of www.cafepress.com/storename will not work with Woopra. If they consider offering subdomains such as storename..com, Woopra will be able to be installed and track the site activity.

  

Woopra Installation Tips

If your site is not listed, here are some answers that might help you install Woopra manually on your site, as well as troubleshoot issues involving your Woopra JavaScript installation. Check out the Woopra FAQ for more indepth tips, techniques, and troubleshooting.

  • JavaScript Enabled Sites Only: Woopra requires a small JavaScript to be placed on every page you want tracked. It only works with sites with the ability to install JavaScript. It does not work with blogs and other “hosted” blog services that do not allow JavaScript.
  • Install JavaScript Before Woopra Client: Please install the Woopra JavaScript on your site before you install the Woopra Desktop Client to ensure the software will connect and track your site’s stats correctly.
  • Woopra Does Not Connect: Please check the Woopra JavaScript on your site to ensure it matches the script in the Woopra Members area. Also, run your site through a validation test to ensure there are no website code errors interfering with the Woopra JavaScript.
  • Woopra Can’t Find My Site: If you are using a redirect to your site, Woopra cannot currently work with redirects. It can only track activity on the page upon which the JavaScript is on and the URL associated with that JavaScript. It will not track redirected sites. To track the destination site, add it to Woopra.
  • Woopra Unable to Pass Firewall: Woopra’s firewall port is 11228. Please set your firewall security settings to permit Woopra access. Note: If you are trying to use Woopra’s Desktop Client through a public Internet connection, school, business, or other restricted access point, and they will not permit adding the Woopra firewall port, you can use the Woopra Web App.
  • Changing the API Key: If you need to change the Woopra API Key for any reason, go to the API Key page in the Woopra Members Settings and reset the key. Remember to copy and paste the new API key into the Woopra Plugin or add-on for your site.
  • Double Stats: If you are noticing double the number of stats and reports within the Woopra Client or Woopra Web App, you probably have the Woopra JavaScript installed twice. Check the generated web page’s source code.
  • Double Stats and the Woopra WordPress Plugin: If you have been using the Woopra WordPress Plugin and wish to use the manual installation method instead, please deactivate the Plugin first before adding the JavaScript manually. If you have been using the Manual installation method for the JavaScript, remove it first before activating the Woopra WordPress Plugin to avoid double stats.


Install Woopra Desktop Client

Live Tracking with WoopraThe Woopra Desktop Client is currently available for Windows, Mac, and Linux. For tips on installing Woopra on Ubuntu, see Installing and Running Woopra Desktop Client in Ubuntu from Techruminations.

As we move out of beta, we are working on the next upgrade to Woopra which will resolve some issues with some versions of Mac Snow Leopard. Thank you for your patience.

To install Woopra on your computer:

  1. Install the Woopra JavaScript on your website or blog.
  2. Install the latest version of Java from the Java official website.
  3. Download and install the appropriate version of Woopra for your computer’s operating system.
  4. Start Woopra and login with your member username and password when requested.
  5. Wait a few minutes and see the action live on your blog.

Woopra will not activate until you have installed the Woopra Plugin or manually installed the Woopra JavaScript code within your website.

Upgrading and Updating Woopra

Woopra automatically updates the desktop client version. To initiate the update, you will be asked to log out and back into the program to initiate the upgrade. Normally, a computer reboot is not required.

The update notification will be on the Woopra Desktop Client, and on the blog, social networking services such as our Twitter account, and the Woopra Forums.

To update or upgrade a plugin, add-on, extension, or other Woopra supported or third-party program, you may be required to download and install the program. Follow the instructions for updating and upgrading your specific tool or program.

Woopra Release Candidates

For those participating in testing new release candidates of Woopra, these are installed separately as they tend to be unruly children in the early stages of development. Testing release candidates is not for the cautious or timid.

Once the Woopra Release Candidate testing is finished and the full version is released, testers will be requested to uninstall the release candidate and manually download the new version. If the previous version was not uninstalled, start the program to initiate the automatic upgrade.

Upgrade Required: Announcements of Woopra Desktop Client upgrades are made on the blog and Twitter account. A message in the Woopra Desktop Client will say “Upgrade Required”, as well.

Currently, you can not use past versions of Woopra after a major release. We are only supporting the most recent version of Woopra.

 

Help!

If you’re having any problems with implementing Woopra, please stop by the section on the .

Things to Know About Woopra

  1. Server Maintenance: Occasionally, Woopra does maintenance on the servers. Announced on our account on Twitter, this may cause a slight disruption in service, but no data is lost.
  2. Woopra Free Invites: Invites for a free Woopra account are currently only available from Woopra Members. Get to know your friendly Woopra Member and ask them for an invite. Occasionally, we will open up Woopra for free registration without an invitation. Or, sign up for the basic Woopra plan for a month and give it a try. No waiting, no invite, immediate self-gratification.
  3. Help Others Learn with Woopra: Connect with fellow Woopra members and track Woopra news through social media, networks, and on the forum. Teach others how to use Woopra and pitch in on the forums and elsewhere to answer their questions. We appreciate your support and encouragement.
  4. Bug Reporting: Please report all bugs in Woopra in the Woopra Forums. Please search first to see if an issue has been reported previously.