.. include:: /Includes.rst.txt

.. _introduction:

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

.. _what-it-does:

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

The extension provides charts for various `Matomo <https://www.matomo.org/>`_
reports via the `Reporting API
<https://developer.matomo.org/guides/querying-the-reporting-api>`_.

The default parameters of the widgets can be adjusted to your needs, e.g. in the
*Visits per month* widget display 24 month instead of 12 months.

.. tip::
   If you use Matomo, the
   :ref:`Matomo Integration <matomo_integration:introduction>` and
   :ref:`Matomo Opt-Out <matomo_optout:introduction>`
   extensions might be of interest to you.

.. _screenshots:

Screenshots
===========

.. figure:: /Images/DashboardExample.jpg
   :alt: Example for a Matomo Dashboard

   Example for a Matomo Dashboard


No Matomo instance at hand?
===========================

You can use the Matomo demo installation for evaluation. Just enter the
following settings into the :ref:`site configuration
<site-configuration>`:

Base URL of the Matomo instance
   https://demo.matomo.cloud/

Site ID
   1

Authentication token
   (leave empty)