This project is no longer maintained by the team that initially created it. The plugin is open-source and looking for contributors helping to maintain it. Any issues will not be actively picked up by Yireo, but the community. Pull Requests will be merged in the main repository (yireo/plg_system_piwik) unchecked. The sources here are up-for-grabs.

This plugin allows you to integrate Matomo (previously called Piwik) in your Joomla site, while not using any client-side code. The benefit of this is first of all that the Matomo (Piwik) integration will not slow down the client side loading. Additionally, it is fully compliant with EU cookie-regulations and requires no cookie banner to ask for user permission. All tracking is done on the server side.

• FAQ article on the official website: https://matomo.org/faq/new-to-piwik/faq_15/

• Install the plugin in the Extension Manager
• Enable the plugin in the Plugin Manager
• Configure your Matomo (Piwik) API in the plugin settings (see next chapter)

When the project went to Github the project structure needed some updates. To avoid conflicts in Joomla! with other piwik plugins, that might have the same name "piwik" and to follow the new name of Piwik called "Matomo" we took the opportunity to rename the plugin to "PhpMatomo".

As the new and the old plugin register the same functions, they cannot be activated at the same time. Otherwise Joomla! will not work anymore. Therefore the old "System - Piwik" plugin has to be deactivated before activating the "System - PhpMatomo (Piwik)" plugin

To update from Yireo-Piwik to PhpMatomo, please do the following:

• Install the plugin in the Extension Manager
• In the Plugin manager copy the plugin configuration from "System - Piwik" to "System - PhpMatomo (Piwik)"
• Uninstall or disable the plugin "System - Piwik" in the Plugin Manager
• Enable the plugin "System - PhpMatomo (Piwik)" in the Plugin Manager

• Within the Plugin Manager, enable and configure this plugin
• Configure the (numeric) website ID: This is found under the Websites-tab in Matomo (Piwik) itself.
• Configure the API-token. This is found under the API-page in Matomo (Piwik).

To use Matomo (Piwik) within your 404 pages as well, you need to modify the error.php file of your Joomla template. Add the following code:

include_once JPATH_SITE . '/plugins/system/phpmatomo/phpmatomo.php';
if (class_exists('PlgSystemPhpMatomo')) {
	PlgSystemPhpMatomo::callPiwik();
}

• Tutorial how to configure the Yireo Piwik Plugin for Joomla! https://www.yireo.com/tutorials/joomla/joomla-extension-tutorials/1580-configuring-yireo-piwik-for-joomla

Usually Matomo (Piwik) is integrated through a JavaScript widget, which sets a cookie in the browser. This Matomo (Piwik) plugin works through the PHP API, and works without cookies. Note that the PHP API is not aware of JavaScript-measured statistics like screen resolution. If you want to know more about difference, please refer to the Matomo (Piwik) website: https://matomo.org/ .