Skip to content
No description, website, or topics provided.
PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Yireo Matomo (Piwik) plugin for Joomla

Disclaimer - Contributors welcome - Yireo Piwik is now called "PhpMatomo"

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.

Introduction & Benfits compared to other Matomo (Piwik) plugins

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.

Benefits compared to other Tracking plugins (like Google Analytics)

Setup / Installation

  • 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)

Update from version 1.0.x to version 1.1.x

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".

Known issues - Please read before updating

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

Update instructions

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

Usage

  • 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();
}

Further details about the plugin

FAQ: What is the difference between the normal Matomo (Piwik) widget and this plugin?

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/ .

You can’t perform that action at this time.