Woopra Installation Guide

Activating and installing Woopra is an easy, three step process.

  1. Step One: Activate Woopra
  2. Step Two: Install Woopra on Your Website
  3. Step Three: Installing Woopra on Your Computer

Woopra API Key: The Woopra API key is found at Members > My Websites > Edit.

By installing Woopra during the closed private beta testing phase, there are some responsibilities and restrictions you need to know about:

  • Woopra for Beta Testers Only: You are signing up as a beta tester to help us improve Woopra. See our member guide for beta testers for more information on our expectations and responsibilities during the beta testing phase.
  • Beta Testing is Not for Sissies: Woopra is under beta testing development. There will be downtimes. There will be problems. There will be a great number of successes due to your detailed feedback and help. Be patient with us. Only download and use Release Candidates if you are code savvy and willing to provide the input we need to improve Woopra.
  • Woopra Status: You can track the status of Woopra via the on Twitter.
  • Restricted to 10K Pageviews: Understand that Woopra is currently restricted to 10,000 pageviews per day during this beta testing phase. This allows us to offer more approvals and maximize resources during development.
  • Approvals: Approvals are announced randomly when we have resources available. Monitor our Woopra blog or blog feed for news updates. There are no specific waiting times. We choose randomly from those signed up, approving typically no more than 2-3 sites per beta tester. We currently have more than 65,000 approved beta testing users. When Woopra comes out of beta testing, there will be no approvals nor wait.
  • Use the Woopra Forums: Report all bugs, problems, feature requests, and suggestions in the Woopra Forums.
  • WordPress.com and Hosted Blogs: Woopra does not currently work on WordPress.com or other hosted blog services unless the service has added Woopra to it’s options. We are working with many of these services to incorporate Woopra, so please let them, and us, know that you want Woopra.
  • Upgrading Woopra: Woopra has an auto-update feature and notification service. You will be asked to restart the program in order for the update to occur. You will not be asked to download a new version unless you are participating in the alpha-testing phase. Plugins, extensions, add-ons, and other third-party programs may require downloading and installing. See Woopra Upgrades for more help and information.

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.

In addition to our popular Woopra desktop client, you can also track live statistics on the web through the Members area for your site. Click View Stats to see the new Woopra Web Analytics version.

Step One: Activate Woopra

If you’ve signed up for Woopra and receive a confirmation email, you can add a website to Woopra through the Members panel on this site.

  1. Click Add a Website on the Members Panel.
  2. Type in the direct address to your website. Redirects are not permitted. Subdomains are treated as a domain, one per Member. Be very careful and specific with your URL/address.
  3. Select the estimated pageviews per day (most sites have less than 1,000).
  4. Enter the GMT time zone for you and your blog. You can use the Time Zone Converter to determine your GMT time reference. If you make a mistake or want to change time zones later, click the Time Zone link on your website management panel.
  5. Click Add Website. When you receive a confirmation email, proceed to the next steps.

Once approved, you can either install Woopra on your website, forum, or blog using a Woopra Plugin in Step Two or manually install Woopra.

To manually install Woopra to your website, see the manual instructions.

Step Two: Install Woopra on Your Website

In order for Woopra to identify your website, you must install Woopra on your site using a Woopra Plugin or manually adding the JavaScript.

Install the appropriate Woopra Plugin for your website or blog platform, or use the Manual Installation on your forum, website, or blog to activate it for use with Woopra.

Site and platform specific installation instructions include:

Step Three: Install Woopra on Your Computer

To install Woopra on your computer:

  1. Install the latest version of Java from the Java official website.
  2. Download and install the appropriate version of Woopra for your computer’s operating system.
  3. Start Woopra and login with your member username and password when requested.
  4. 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.

Download Woopra

For more versions of Woopra, see the Download Woopra page.

Woopra Installation Methods

The following are site specific instructions for installing Woopra.
 

WordPress (Stand Alone) Installation

Woopra currently works with WordPress 2.5+ versions.

  1. Download the
  2. Unzip it and upload woopra.php or Woopra folder to the /wp-content/plugins/ directory.
  3. Go to the Plugins panel in WordPress and activate Woopra.
  4. Under the Dashboard panel, click on the Woopra tab.
  5. On the Woopra Panel in WordPress, you may optionally allow Woopra to track your WordPress Administration Panel pages, or auto tag commentators (highly recommended) by checking the appropriate options.
  6. Update the configuration page and your installation is complete!
  7. Move to Step Three: Installing Woopra on Your Computer

Important Note: In order for the WordPress Plugin to work, 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.

You can use the Theme Editor in the WordPress administration panel to select the footer.php theme file and manually add this line. After you save it, Woopra should work perfectly. If you still have problems you can also use the Manual Installation method.

 

Manual Installation

If you were successful at installing Woopra with a Woopra Plugin, you do NOT need to use this manual method.

  1. Copy the JavaScript code from within the My Websites page. It looks like:

    <script type="text/javascript" src="http://static.woopra.com/js/woopra.js"></script>

    If you are using https on your website, use the following JavaScript:

    <!-- Woopra Code Start -->
    <script type="text/javascript">
    var _wh = ((document.location.protocol=='https:') ?
    "https://sec1.woopra.com" : "http://static.woopra.com");
    document.write(unescape("%3Cscript src='" + _wh + "/js/woopra.js' type='text/javascript'%3E%3C/script%3E"));
    </script>
    <!– Woopra Code End –>

  2. Place the JavaScript link in the footer before the </body> of your website on all the pages to be tracked.
  3. Move to Step Three: Installing Woopra on Your Computer

Important Note: This method of installation will not integrate the user tracking functionality. It will not add Woopra features to your WordPress Administration Panels or any other blog or website interface. Plugins are required to pass specific user identifiable details.

Manual Installation for Specific Blog and Website Platforms

Some plugins and add-ons require the Woopra API. The number is found on the Woopra Members > My Websites > Edit panel.

In general, the Manual Installation should work for most websites and blogs without using a Plugin or add-on. However, there are some systems which do not accept JavaScript kindly.

Sites and hosting services which do not allow JavaScript or independent plugins or add-ons, like , will currently not work with Woopra. If you would like to use Woopra on their services, please contact them and us so we can work together to make this happen.
  

Third-party Woopra Plugins, Extensions, Add-ons, and Tools

The Woopra API makes it easy for third-parties to add features to Woopra, including plugins, add-ons, extensions, and tools to meet the needs of specific blogging, CMS, and website platforms. The Woopra API key is found at Members > My Websites > Edit.

The following tools are available from third-party services. If you are having a problem with these, please contact the hosting organization or individual.

After installing the Woopra Plugin for your site, go to Step Three: Installing Woopra on Your Computer.

To use Woopra on other CMS, blog, and website platforms, check the Woopra Forums and the blog for announcements. Until then, please use the Manual Installation method.
 

Upgrading and Updating Woopra

Woopra automatically updates the desktop client version.

To initiate the update, you will be asked to exit the program and restart it, and Woopra will download and install all the files you need to your computer.

The update notification will be on the blog, social networking services, the Woopra Forums, and on the Woopra desktop client program.

Remember, Woopra is undergoing intensive testing and development. During the beta testing phase, there maybe a loss of historical data and settings as major modifications are made to the underlying code. These changes do not impact your website or blog.

If you are having trouble with the automatic upgrade and restarting the program does not resolve the issue, search the Woopra Forums for others having the same issues and leave a detailed explanation of your operating system and version in order to help us resolve this issue if no one has reported it yet.

Occasionally, Woopra must update the code on servers during the beta testing phase, so server downtime maybe experienced. You will be able to login or access statistics on your site through Woopra. We keep these to a minimum, but do let us know in the forums if you are offline for more than 24 hours. When possible, we warn you in advance.

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.
 

Help!

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