Make a plugin compatible from Matomo 3 to Matomo 4

ehermon · March 12, 2021, 10:15am

Good Morning, I’m testing to upgrade from Matomo 3.5.1 to Matomo 4.2.1, which is the latest stable version released. I have had problems when updating but finally I have updated everything correctly in the database. The only problem I have is with a plugin that we use a lot and that tells us that it is incompatible with the Matomo 4 version. This plugin is Intranet Geo IP. Searching, I got this URL where they indicate how to adapt a plugin to be compatible from the Matomo 3 to Matomo 4 version: https://developer.matomo.org/guides/migrate-matomo-3-to-4 I have made the changes to the plugin.json file by changing the value of version and require, but when doing the System Check it keeps warning me that this plugin does not work with this version of Matomo. Any suggestion? Thank you very much in advance

Lukas · March 12, 2021, 10:38am

Hi,

Here you should find more information about this plugin and Matomo 4:

github.com/ThaDafinser/Piwik-IntranetGeoIP

Make plugin compatible with Matomo 4

opened 04:37PM - 01 Sep 20 UTC

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](https://matomo4-plugins.lw1.at/). [Migrating the plugin](https://matomo.org/blog/2020/08/matomo4-make-your-plugin-compatible-now/) 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!

In theory just changing the plugin.json as done here should work:

ehermon · March 12, 2021, 11:47am

Thank you very much Lukas for the prompt reply.

I have followed the steps indicated, changing those two values in the plugin.json file of the “IntranetGeoIP” plugin, and even changing it, I still get that the plugin is incompatible with the Matomo version as you can see in the attached screenshot .

Is it necessary to do something else so that Matomo takes those values correctly?

Kind regards

Lukas · March 12, 2021, 11:52am

Hi,

Maybe Matomo caches the value. You could try deleting all files in tmp/ to clear the cache.

ehermon · March 12, 2021, 1:00pm

Fix it!!! Thanks so much!!!