dheia / wn-matomo-plugin

Matomo Analytics for WinterCMS

Matomo Analytics

Matomo Analytics is a WinterCMS plugin for Matomo, Google Analytics alternative that lets website owners own their analytical data and protect their customers' privacy.

Prerequisites

You must have access to Matomo, either through the cloud services provides by Matomo or a private Matomo instance you have access to.

Installation

Use Composer to install the plugin by executing

composer require mercator/wn-matomo-plugin

and run

php artisan winter:up
php artisan cache:clear

from the root of your WinterCMS installation.

Alternatively, create a directory "mercator/matomo", download the files from Github and move them in the newly created sub-directory.

Installation from the WinterCMS backend will be added once the WinterCMS marketplace is available.

Plugin Usage

Configuration

On the Winter backend, go to the settings of the plugin Matomo Analytics.

To get Matomo Analytics running,

• identify the analytics server you intend to use (e.g., matomo.org).
• in the Matoma backend set your CMS server up for tracking and note down the server ID
• again in the in the Matoma backend generate a security token (Auth Token)
• enter the above three items in Winter CMS's backend section of the plugin
• goto the CMS section of Winter CMS and drag-drop the tracking code onto the layout(s) of your Winter site.

With that, Matomo Should start tracking.

Dashboard Reporting

Goto Winter's Dashbaord and add a new widget. Select Matomo Widget as the widget type in Winter's dashboard when adding a new widget. Then, select the actual report type. Please see the Matomo backend for a description (reports are termed very similarly). For each report added, you can change the reporting period (7/30/360 days) as well as the way the report is rendered (e.g., a pie chart). It is also possible to export the data of an individual report.

In addition, the full Matomo Dashboard - as it is found in Matomo's backend - is available. Simply select Matomo Dashboard as the widget type when creating the widget in in Winter's dashbaord.

Thank You

I would like to thank the guys from WinterCMS for their ongoing support - not just for getting this plugin done but also the other ones I have been writing over the course of the past two years.

Note that this is not about money. It is about appreciation of my time.

Contributing

Feel free to send pull request! Please, send Pull Request to the master branch.

A Final Word

This plugin has been compiled by Helmut Kaufmann, Küssnacht am Rigi, in Switzerland. Helmut can be reached by mail at [email protected].

While it might look simple, putting this plugin together took some time. So, if you find it useful, feel free to sponsor a beer, two or more are welcome as well. Paypal might be your best friend for this...

License

Copyright 2022 by Helmut Kaufmann, Küssnacht am Rigi, Switzerland (https://mercator.li).

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program 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 General Public License for more details.

You should have received a copy of the GNU General Public License along with this program.
If not, see https://www.gnu.org/licenses.