PHPackages                             winter/wn-matomo-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. winter/wn-matomo-plugin

ActiveWinter-plugin[API Development](/categories/api)

winter/wn-matomo-plugin
=======================

Integrates Matomo Analytics with Winter CMS

52.7k5[4 issues](https://github.com/wintercms/wn-matomo-plugin/issues)[2 PRs](https://github.com/wintercms/wn-matomo-plugin/pulls)PHP

Since Jan 4Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/wintercms/wn-matomo-plugin)[ Packagist](https://packagist.org/packages/winter/wn-matomo-plugin)[ RSS](/packages/winter-wn-matomo-plugin/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

Matomo Analytics
================

[](#matomo-analytics)

[![Matomo Plugin](https://user-images.githubusercontent.com/15900351/156275611-363b795f-bea8-47f2-b6dc-d7852ad5efcd.png)](https://user-images.githubusercontent.com/15900351/156275611-363b795f-bea8-47f2-b6dc-d7852ad5efcd.png)

[Matomo](https://matomo.org) is a Google Analytics alternative that lets website owners own their analytical data and protect their customers' privacy. This is a [WinterCMS](https://wintercms.com) plugin that integrates Matomo into WinterCMS providing reporting widgets, client-based tracking component, and (planned) a server-side tracking component.

Prerequisites
-------------

[](#prerequisites)

You must have access to Matomo, either through the cloud services provided by [Matomo](https://matomo.org) or a [self hosted Matomo instance](https://matomo.org/matomo-on-premise/). If you are paranoid about privacy, you might want to go for a self-hosted instance.

Plugin Usage
------------

[](#plugin-usage)

You must have basic knowledge about Matomo in order to use this plugin. In particular, you must know how to create new tracking instances, users, and security tokens. Don't be worried. This is quite easy to learn by playing around with Matomo.

### Setup site on Matomo

[](#setup-site-on-matomo)

To get Matomo Analytics setup for your Winter CMS instance:

- identify the analytics server you intend to use (e.g., matomo.org).
- in the Matomo backend set your CMS server up for tracking and note down the site ID
- again in the in the Matomo backend generate a security token (an *Auth Token*). Note that the *Auth Token* must be created under user who does **not** have super admin access
- add the Matomo Server URL, the Site ID, and the Auth Token to this plugin's configuration

> **NOTE:** You may want to disable any adblockers that you are currently using.

> **NOTE:** The tracker is disabled when authenticated backend users are detected or the website is in maintenance mode

### Configuration

[](#configuration)

Configuration for this plugin is handled through a [configuration file](https://wintercms.com/docs/plugin/settings#file-configuration). In order to modify the configuration values and get started you can either add the values to your `.env` environment file or copy the `plugins/winter/matomo/config/config.php` file to `config/winter/matomo/config.php` and make your changes there.

Environment File Supported Values:

- `MATOMO_SERVER="https://example.matomo.cloud/"`
- `MATOMO_SITE_ID=1`
- `MATOMO_TOKEN=""`

### Tracking

[](#tracking)

To start tracking your visitors simply add the `Tracker` component to the `` section on all of the pages that you want to include the Matomo tracker on.

> **NOTE:** The tracker component must be rendered before the closing `` tag.

With that, Matomo should start tracking and you should see results shortly.

> **NOTE:** Matomo provides near-realtime results with an emphasis on "near", so you might have to wait a few minutes to see the first results.

### Reporting

[](#reporting)

This plugin provides two main Dashboard ReportWidgets out of the box.

The first widget is the "Analytics Dashboard" widget, which provides the entire Matomo dashboard embedded into the Winter dashboard through the use of an iframe. It is recommended that you set this widget to the maximum width in order to see all of the data present easily. This widget supports changing the period of time that is reported on.

The second widget is the "Analytics Report" widget, which provides the ability to pick from a pre-set list of common reports that can be embedded as individual widgets on the Winter Dashboard. Each of the widgets allows you to configure the period of time that is examined, how the data is displayed, and how many rows to include in the results. It is also possible to export the data of an individual report.

Credits
-------

[](#credits)

This plugin was originally written by Helmut Kaufmann, Küssnacht am Rigi, in Switzerland. Helmut can be reached by mail at .

It has since been modified and re-released under the Winter namespace as a first party plugin for Winter CMS maintained by the Winter CMS team and Helmut Kaufmann.

If you would like to contribute to this plugin's development, please feel free to submit issues or pull requests to the plugin's repository here:

If you would like to support Helmut Kaufmann please visit [PayPal](https://www.paypal.com/donate/?hosted_button_id=MZYBN2NEDEDNC).

If you would like to support Winter CMS, please visit [WinterCMS.com](https://wintercms.com/support)

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance43

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7253840?v=4)[Luke Towers](/maintainers/LukeTowers)[@LukeTowers](https://github.com/LukeTowers)

---

Top Contributors

[![LukeTowers](https://avatars.githubusercontent.com/u/7253840?v=4)](https://github.com/LukeTowers "LukeTowers (16 commits)")[![bennothommo](https://avatars.githubusercontent.com/u/15900351?v=4)](https://github.com/bennothommo "bennothommo (1 commits)")[![CitrinoDeveloper](https://avatars.githubusercontent.com/u/53047879?v=4)](https://github.com/CitrinoDeveloper "CitrinoDeveloper (1 commits)")[![helmutkaufmann](https://avatars.githubusercontent.com/u/5102490?v=4)](https://github.com/helmutkaufmann "helmutkaufmann (1 commits)")[![RomainMazB](https://avatars.githubusercontent.com/u/53976837?v=4)](https://github.com/RomainMazB "RomainMazB (1 commits)")

---

Tags

analyticshacktoberfestmatomoplugintrackingwintercms

### Embed Badge

![Health badge](/badges/winter-wn-matomo-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/winter-wn-matomo-plugin/health.svg)](https://phpackages.com/packages/winter-wn-matomo-plugin)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.4M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93459.5k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
