Table of Contents
What does it do?¶
The extension integrates Matomo Analytics easily into TYPO3. The extension supports features of Matomo 4, so it is recommended to use a current Matomo version.
The extension takes the Content Security Policy (CSP) into account: a nonce attribute is added to the script tag, if the feature is enabled for frontend. CSP was introduced with TYPO3 v12.
If you use Matomo, the Matomo Widgets and Matomo Opt-Out extensions might be of interest to you.
When to use this extension¶
This extension is useful if you want to add further Matomo method calls dependent on certain conditions — such as custom dimensions or setting the user id. Another option is to enable the Matomo tag manager and add data layer variables. PSR-14 events are available for these purposes. Also have a look at the use cases.
When not to use this extension¶
This extension can only embed one tracking code for one Matomo instance. If you have to add multiple tracking codes for one or more Matomo instances you cannot use this extension and have to do it on your own.
This extension uses semantic versioning which basically means for you, that
Bugfix updates (e.g. 1.0.0 => 1.0.1) just includes small bug fixes or security relevant stuff without breaking changes.
Minor updates (e.g. 1.0.0 => 1.1.0) includes new features and smaller tasks without breaking changes.
Major updates (e.g. 1.0.0 => 2.0.0) breaking changes which can be refactorings, features or bug fixes.
The changes between the different versions can be found in the changelog.