Matomo alert

The Matomo Alert module is a simple yet powerful tool for Drupal beginners, ensuring your Matomo Analytics setup is flawless. It provides a block that alerts logged-in users if the Matomo tracking ID is missing, preventing analytics issues in production. This solution saves time and avoids client headaches by catching configuration errors early.

Features

The basic functionality is to display a customizable block warning logged-in users when the Matomo tracking ID is not configured. Unique features include a dedicated Twig template and CSS styling for a polished look. Use this module when integrating Matomo Analytics to ensure proper setup, especially in multi-site environments or during development. Use cases include preventing deployment without analytics and improving administrative oversight.

Post-Installation

After installation, place the "Matomo Alert Block" in a visible region (e.g., "content") via /admin/structure/block and configure visibility for authenticated users. No additional config page is needed, but check /admin/config/system/matomo to set the tracking ID. Clear the cache (drush cache:rebuild) after placement. The block appears automatically when the ID is missing.

Additional Requirements

This module requires Drupal core and the Matomo module (drupal/matomo) to function. No additional libraries or APIs are needed beyond the Matomo integration.