Make plugin compatible with Matomo 4

[Findus23]

Hi, hope you are doing well!

Matomo 4 is progressing steadily and it would be great if this plugin was also available for it.

Migrating the plugin should be pretty simple as there were not many breaking changes.

You can find the migration guide here: https://developer.matomo.org/guides/migrate-matomo-3-to-4

It boils down to:

• update your dev environment to 4.x-dev
• update your plugin.json (new major version of the plugin and require >=4.0.0-b1,<5.0.0-b1)
• check that everything still works fine
• commit this to a new branch (e.g. 4.x-dev) and make this branch the default in the github settings
• tag and push a new release to publish it to the marketplace

If you later fix a bug and also want to backport it to the 3.x plugin, you can cherry-pick the commit to the old branch, release a new version (lower than the one for 4.x) and publish it and 3.x users should get this update.

If you have questions about anything, just ask me!

[Zeichen32]

If update the plugin to work with the new Matomo version: https://plugins.matomo.org/CustomOptOut?matomoversion=4

[Cruiser13]

@Zeichen32 thank you for the update! What would be the best update process? Do we need to uninstall the 3.x version of the plugin, update matomo and install the 4.x version afterwards? Will this affect the data (custom css) of the websites?

[Findus23]

There should not be any need to do anything. During the Matomo 4 update Matomo will update the plugin to the 4.x compatible version that should work just like before. That said you should always do a proper backup beforehand.