Soapberry

Description

Soapberry makes it possible to use an externally hosted Ackee analytics instance with your WordPress site without editing any code. It provides a settings page in WP Admin to add the required JavaScript tracking elements to your site’s footer.

To use this plugin, one must have access to an Ackee instance set up with a Domain ID and CORS headers matching that of the WordPress domain.

The upstream Ackee project describes the project as a:

Self-hosted, Node.js based analytics tool for those who care about privacy. Ackee runs on your own server, analyses the traffic of your websites and provides useful statistics in a minimal interface.

The plugin’s current functionality is limited to the essential features of addding the JavaScript tracker to the footer with an option to disable tracking of logged in visits. In the future, this functionality might extend to tracking based on user roles or the ability to use Ackee’s personalization analytics with the visitor’s consent.

Screenshots

  • Soapberry Settings Page in WP Admin.

Installation

The quickest method for installing Soapberry is:

  1. Visit Plugins -> Add New in the WordPress admin
  2. Search for “Soapberry”
  3. Click “Install Now”
  4. Once the install is complete, click “Activate”.
  5. Go to the Settings -> Soapberry to add your Ackee settings.

If you would prefer to do things manually, then follow these instructions:

  1. Upload the soapberry folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to the Settings -> Soapberry to add the Ackee settings.

FAQ

Why Soapberry?

The Ackee plant is in the Sapindaceae (soapberry) family. The name Soapberry strives to indicate this plugin is complementary to the work by the Ackee project while by unique enough to make clear that the two are not formally associated. Fun fact, the fruit of the Soapberry plant is used to make soap which is where Sapindus got its secondary name.

The plugin is active but I do not see the tracking code.

First, make sure your theme has the wp_footer() function added before the closing body tag. The plugin hooks into the WordPress footer, making this template tag required.

If you’re still not seeing the tracking code, make sure your settings have been saved, and you do not have the “Exclude Logged In” checkbox enabled. If you are excluding logged in visits, then try loading your site in a private tab or another browser.

Contributors & Developers

“Soapberry” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Soapberry” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0

  • Inital release