This plugin has been created in order to offer a User Interface within Matomo to import annotations. By default, it is possible to import annotations within Matomo but only through the API. The issue is that end users don't know it. So the idea was to create an easy viewable plugin that anyone can use to import annotations. It has been created as a widget in order to quickly show that annotations have been imported within a graph. In order to use this feature, Matomo end users will have to create a token, indicate the siteID they want to import the annotations for and then write the annotations in this format: YYYY-MM-DD,my annotation to import YYYY-MM-DD,my second annotation to import YYYY-MM-DD,my third annotation to import etc etc. Possibilities offered by this plugin are endless, if you look at the source code, you can easily create your own version of this plugin for any other methods of the Matomo API to offer a User Interface. Have fun,

View and download this plugin for a specific Matomo version:

Matomo 4.x
Matomo 5.x (currently selected)

The import annotation plugin is straightforward, it is providing you a User Interface on the dashboard in order to give any users the possibility to import annotations. In order to import annotations, end users will need to create a token through the admin --> Personnal --> Security, and indicate the siteID they wish to import the data for. Once they push the import button, the annotations get imported straight away. Important thing to know, there is a limit in the number of caracters you can include within your annotations which is determine by the lenght of your request.

What is this plugin do?

It provides you a user interface in order to import annotations.

Why is it available on the dashboard panel and not in the admin?

Good question. It is a choice we made. It would have been cleaner within the admin but on the other way around, it would have been difficult to view the result straight away on a graph.