Add support for different analytics solutions

[jacobwod]

Documentation

The API

In addition to the typical page view, the following custom events are being tracked:

• mapLoaded: when a specific map is loaded
• pluginShown: when a plugin's window becomes visible
• layerShown: when a layer changes visibility to true
• spatialSearchPerformed: when a spatial search is performed
• textualSearchPerformed: when a text search is performed

Example setup in Plausible

In your Plausible installation, ensure to add the previously stated event names as Goals:

This will result in a nice breakdown in the UI. The example below illustrates which plugins are most popular in a certain setup:

Original issue

Currently many organisations that wish to collect statistics about their Hajk usage do it by adding tracking snippets to the static HTML file when deploying. This works but adds a step to the deployment step and wouldn't work at all in a CI/CD pipeline.

I propose a different solution that would allow for better integration and offer even more possibilities.

The idea is that we integrate one or more different (open source) tracking solutions and allow map admins to control whether they're active using Admin UI.

I will start by adding support for Plausible (https://plausible.io) which is open source, lightweight and allows for self hosting. It is easy to setup due to ready Docker compose file. In addition, the plausible-tracker package will allow us to import it programatically - no need to put <script .... /> in our index.html!