pagemachine / typo3-matomo-tracking
Server-side Matomo Tracking in TYPO3 with emphasis on privacy: consentless tracking, GDPR/TDDDG-compliant, respects DNT/GPC
Installs: 380
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 2
Type:typo3-cms-extension
Requires
- php: ^8.1
- pagemachine/matomo-tracking: ^1.1.1
- psr/http-message: ^1.0 || ^2.0
- psr/http-server-handler: ^1.0
- psr/http-server-middleware: ^1.0
- psr/log: ^1.0 || ^2.0 || ^3.0
- typo3/cms-core: ^12.4.3 || ^13.4
- typo3/cms-frontend: ^12.4 || ^13.4
Requires (Dev)
- donatj/mock-webserver: ^2.7
- ergebnis/composer-normalize: ^2.47
- friendsofphp/php-cs-fixer: ^3.51
- php-parallel-lint/php-console-highlighter: ^1.0.0
- php-parallel-lint/php-parallel-lint: ^1.3.1
- phpspec/prophecy-phpunit: ^2.3
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^1.0.0 || ^2.0.0
- phpunit/phpunit: ^10.0 || ^11.0 || ^12.0
- rector/rector: ^1.2.10 || ^2.0.12
- saschaegerer/phpstan-typo3: ^1.0 || ^2.0
- ssch/typo3-rector: ^2.13.1 || ^3.1.1
- typo3/cms-install: ^12.4 || ^13.4
- typo3/coding-standards: ^0.7.0 || ^0.8.0
- typo3/testing-framework: ^8.2.7 || ^9.2.0
This package is auto-updated.
Last update: 2025-04-24 07:18:31 UTC
README
Server-side tracking of TYPO3 events (e.g. page views) in Matomo.
Installation
composer require pagemachine/typo3-matomo-tracking
Setup
- Fill the
matomo_trackingExtension Configuration:- Matomo instance URL (
matomoUrl), e.g. https://matomo.example.com/ - Auth Token (
authToken) for authenticated tracking
- Matomo instance URL (
- Set the Matomo site ID (
matomoTrackingSiteId) in the settings of each TYPO3 site
It is recommended to configure a sane HTTP timeout like 3 seconds. This ensures pages load quickly in case a Matomo instance is not responding. Tracking will be skipped in this case.
Page view tracking
By default page views will be tracked with the final page title and the current URL. The previous URL (referrer) will also be tracked if possible.
Download tracking
Clicks on file links can be tracked as downloads. This optional feature must be enabled
explicitly in the Extension Configuration through the Track downloads
(features.downloadTracking) option.
This will rewrite all file links to an internal handler which tracks the request and redirects to the actual files. This should be tested well before using it in production, especially in relation to other TYPO3 packages which adjust file URLs.
Action/attribute adjustments
Actions are tracked in Matomo with suitable attributes. To adjust or override these, you can add custom action factories.