Title: Soapberry
Author: Brooke.
Published: <strong>January 2, 2020</strong>
Last modified: July 4, 2020

---

Search plugins

![](https://ps.w.org/soapberry/assets/banner-772x250.jpg?rev=2221318)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/soapberry/assets/icon-256x256.png?rev=2221318)

# Soapberry

 By [Brooke.](https://profiles.wordpress.org/brookedot/)

[Download](https://downloads.wordpress.org/plugin/soapberry.1.1.0.zip)

 * [Details](https://test.wordpress.org/plugins/soapberry/#description)
 * [Reviews](https://test.wordpress.org/plugins/soapberry/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/soapberry/#installation)
 * [Development](https://test.wordpress.org/plugins/soapberry/#developers)

 [Support](https://wordpress.org/support/plugin/soapberry/)

## Description

Soapberry makes it possible to use an externally hosted [Ackee](https://ackee.electerious.com/)
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](https://docs.ackee.electerious.com/#/docs/CORS%20headers) 
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](https://en.wikipedia.org/wiki/Ackee) 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.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

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

Contributors

 *   [ Brooke. ](https://profiles.wordpress.org/brookedot/)

[Translate “Soapberry” into your language.](https://translate.wordpress.org/projects/wp-plugins/soapberry)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/soapberry/), check 
out the [SVN repository](https://plugins.svn.wordpress.org/soapberry/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/soapberry/) by [RSS](https://plugins.trac.wordpress.org/log/soapberry/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.0

 * Fixed: tracking script is now output with a line break at the end.
 * Fixed: Validation improvements for Ackee Domain ID and consent cookie fields.
 * Enhancements: PHPCS ignore is more explicit.
 * Added: Respects Do Not Track by default with an option to override and always
   output the tracker.
 * Added: A cookie setting to allow visitors to opt-in to Ackee.
 * Added: An option to output the detailed view.

#### 1.0

 * Inital release

## Meta

 *  Version **1.1.0**
 *  Last updated **6 years ago**
 *  Active installations **10+**
 *  WordPress version ** 4.1 or higher **
 *  Tested up to **5.4.19**
 *  PHP version ** 7.2 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/soapberry/)
 * Tags
 * [analytics](https://test.wordpress.org/plugins/tags/analytics/)[stats](https://test.wordpress.org/plugins/tags/stats/)
   [tracking](https://test.wordpress.org/plugins/tags/tracking/)
 *  [Advanced View](https://test.wordpress.org/plugins/soapberry/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/soapberry/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/soapberry/reviews/)

## Contributors

 *   [ Brooke. ](https://profiles.wordpress.org/brookedot/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/soapberry/)