.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt

============
Introduction
============

What does it do?
================

The extension makes it easy to integrate Matomo into your TYPO3 website.
`Matomo <https://matomo.org/>`_ (formerly Piwik) is a free Free Open Source Website Analytics Software.
The extension is built on the extbase / fluid architecture. It provides a static Typoscript template which adds the
asynchronous Matomo JS tracking code in the footer of all your pages.

Tracking
--------
Basic page tracking can easily be configured via the constant editor. At least
you have to know the location of the Matomo server and the Matomo site ID of
your TYPO3 based website.

Multiple websites in a single TYPO3 instance are possible by defining different
site IDs per microsite.

Site Search Tracking with indexed_search
----------------------------------------
If you're using the extension **indexed_search** as POST-based search engine, the extension
customizes the tracking code on your results page to call the Matomo *trackSiteSearch*
method. The Search keyword and searchCount parameter will be set automatically.

Let visitors opt-out from tracking
----------------------------------
The Matomo Opt-out iframe can easily be included in your website by placing the extension's Opt-out frontend plugin on a page.