Henhed_Piwik is a Piwik web analytics module for the Magento 2 eCommerce platform. Piwik is an extensible free/libre analytics tool that can be self-hosted, giving you complete data ownership. Henhed_Piwik lets you integrate Piwik with your Magento 2 store front.
To install Henhed_Piwik, download and extract the master zip archive and move the extracted folder to app/code/Henhed/Piwik in your Magento 2 installation directory.
unzip magento2-henhed-piwik-master.zip
mkdir app/code/Henhed
mv magento2-henhed-piwik-master app/code/Henhed/Piwik
Alternatively, you can clone the Henhed_Piwik Git repository into app/code/Henhed/Piwik.
git clone https://github.com/henkelund/magento2-henhed-piwik.git app/code/Henhed/Piwik
Or, if you prefer, install it using Composer.
composer require henhed/module-piwik
Finally, enable the module with the Magento CLI tool.
php bin/magento module:enable Henhed_Piwik --clear-static-content
Once intsalled, configuration options can be found in the Magento 2 administration panel under Stores/Configuration/Sales/Piwik API. To start tracking, set Enable Tracking to Yes, enter the Hostname of your Piwik installation and click Save Config. If you have multiple websites in the same Piwik installation, make sure the Site ID configured in Magento is correct.
If you need to send some custom information to your Piwik server, Henhed_Piwik lets you do so using event observers.
To set custom data on each page, use the piwik_track_page_view_before
event.
A tracker instance will be passed along with the event object to your observer's
execute
method.
public function execute(\Magento\Framework\Event\Observer $observer)
{
$tracker = $observer->getEvent()->getTracker();
/* @var $tracker \Henhed\Piwik\Model\Tracker */
$tracker->setDocumentTitle('My Custom Title');
}
If you only want to add data under some specific circumstance, find a suitable
event and request the tracker singleton in your observer's constructor. Store
the tracker in a class member variable for later use in the execute
method.
public function __construct(\Henhed\Piwik\Model\Tracker $piwikTracker)
{
$this->_piwikTracker = $piwikTracker;
}
Beware of tracking user specific information on the server side as it will most likely cause caching problems. Instead, use Javascript to retrieve the user data from a cookie, localStorage or some Ajax request and then push the data to Piwik using either the Henhed_Piwik JS component ..
require(['Henhed_Piwik/js/tracker'], function (trackerComponent) {
trackerComponent.getTracker().done(function (tracker) {
// Do something with tracker
});
});
.. or the vanilla Piwik approach.
var _paq = _paq || [];
_paq.push(['setDocumentTitle', 'My Custom Title']);
See the Piwik Developer Docs or the \Henhed\Piwik\Model\Tracker source code for a list of all methods available in the Tracking API.
Henhed_Piwik is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.