Wallogit.com
2017 © Pedro Peláez
, (*1)
This library integrates Matomo into Twig. Previously named PiwikTwigExtension., (*2)
composer require "mnapoli/piwik-twig-extension"
You have 2 ways to give the Matomo host and site ID:, (*3)
When creating the extension (recommended), (*4)
$twig->addExtension(new MatomoTwigExtension('my-matomo-host.com', 123));
In the templates, you then just call {{ matomo() }}., (*5)
This solution is appropriate in most cases., (*6)
When calling the Twig function, (*7)
$twig->addExtension(new MatomoTwigExtension());
In the templates, you have to provide the host and site id: {{ matomo('my-matomo-host.com', 123) }}., (*8)
This solution is perfect if you want to be able to customize the site id or Matomo host in the template., (*9)
Don't forget to add the tracker script at the end of the HTML document, for example:, (*10)
<!DOCTYPE html>
<html>
<head>
...
</head>
<body>
...
{{ matomo() }}
</body>
</html>
In some environments, you want to disable Matomo's tracking (for example on your local machine).
That is easily possible by passing false for the $enabled parameter:, (*11)
$twig->addExtension(new MatomoTwigExtension($host, $siteId, false));
This library is released under the MIT license., (*12)