README

This module implements Matomo user and e-commerce tracking into Thelia. It reports the following tracking events using Matomo Tag Manager (MTM):

User Tracking

This module uses the main.body-bottom hook to include the matomo javascript bug into the frontend of a Thelia installation. Most user activities can therefor be tracked. All tracking is done via MTM, allowing the use of custom events and Data Layer variables for more flexible reporting.

E-commerce Tracking

In addition to user tracking, these e-commerce events are tracked through MTM Data Layer events:

• Product page views (view_item)
• Category page views (view_item_list)

The Data Layer is compatible with GA4-style structures, exposing product and category information dynamically to MTM.

Have a look at the Matomo e-commerce analytics docs for more information.

Note that the cart and order tracking uses the PHP Client for Matomo Analytics Tracking API to communicate with Matomo. This events are still tracked, even if the Matomo JavaScript tracker is blocked by an ad or privacy blocker.

Installation

Before installing this module, make sure, that e-commerce tracking is enabled in Matomo for the site you want to use. Then configure tag, triggers, Data Layer (for product & category tracking)

Manual Installation

• Copy the module into <thelia_root>/local/modules/ directory and be sure that the name of the folder is HookMatomoAnalytics or
• use the Install or update a module functionality in the modules section of the Thelia back office

Composer

composer require vz777/hook-matomo-analytics

After finishing the installation, activate the module in the modules section of the back office and fill in Piwik URL and Website ID.

About

This module is a fork of the original work https://github.com/AnimalDesign/thelia-piwik-analytics by ANIMAL.
We thank them for the original implementation and inspiration.