After activation, find the settings under:
Extensions > Modules > Matomo Analytics > Settings
| Setting | Required | Description |
|---|---|---|
| Tracking Enabled | Yes | Master switch for all tracking |
| Matomo URL | Yes | Your Matomo installation URL (e.g., https://analytics.example.com) |
| Site ID | Yes | The Site ID from your Matomo installation (default: 1) |
| Setting | Default | Description |
|---|---|---|
| Cookieless Tracking | On | Track without cookies - reduces stored data |
| IP Anonymization | 2 bytes | How many bytes of the IP address to mask |
| Respect Do-Not-Track | On | Honor browser DNT settings |
| Require Cookie Consent | Off | Only track after explicit consent |
| Klaro Integration | Off | Use Klaro Consent Manager |
| Klaro Service Name | matomo | Must match the service name configured in Klaro |
IP Anonymization Levels:
| Setting | Default | Description |
|---|---|---|
| Enable E-Commerce Tracking | On | Master switch for E-Commerce features |
| Track Product Views | On | Track when users view product detail pages |
| Track Cart Updates | On | Track add-to-cart and cart changes |
| Track Orders | On | Track completed orders with revenue |
| Setting | Default | Description |
|---|---|---|
| Enable Heartbeat Timer | Off | Accurate time-on-page measurement |
| Heartbeat Interval | 15 | Seconds between heartbeat pings |
| Track Outbound Links | On | Track clicks on external links |
| Track Downloads | On | Track file downloads (PDF, ZIP, etc.) |
If you're using Klaro as Cookie Consent Manager and want to require user consent before tracking:
In Extensions > Modules > Matomo Analytics > Settings:
matomo (or your preferred name)Create a new service in your Klaro configuration:
var klaroConfig = {
services: [{
name: 'matomo',
title: 'Matomo Analytics',
purposes: ['analytics'],
cookies: ['_pk_*', 'mtm_*']
}]
};
If you're NOT using cookieless tracking, Matomo sets cookies that should be deleted when consent is revoked:
_pk_id - Visitor ID_pk_ref - Referrer information_pk_ses - Session cookie_pk_cvar - Custom Variables_pk_hsr - Heatmap/Session RecordingMATOMO_SESSID - Session IDpiwik_ignore - Opt-Out Cookiemtm_consent - Consent Cookiemtm_consent_removed - Consent RevocationNote: If you're using cookieless tracking, Matomo doesn't set any cookies and you can leave the cookie rules empty. However, you may still need consent depending on your legal assessment.
type="text/plain" instead of text/javascripttext/javascript and executes itThe module provides an opt-out widget that you can embed in your CMS pages.
Direct link to opt-out:
https://your-shop.com/index.php?cl=matomo_optout
[{include file="widget/matomo_optout.tpl"}]
The module automatically tracks E-Commerce events when enabled:
Tracked when a user visits a product detail page:
Tracked when the cart contents change:
Tracked on the order confirmation page:
The module extends the following templates:
layout/base.tpl - Block base_js for tracking codepage/checkout/thankyou.tpl - Block checkout_thankyou_info for order trackingWhen using custom themes, ensure these blocks are available.