Matomo (Piwik) plugin to locate all locale data of a user based on the IP address/subnetwork (country, region, city, latitude, longitude, provider, ...)

Please use it only for INTRANET tracking everything else just dont make sense :-)

What does this plugin do?

It adds visitor information based on the matched IP address from your configuration. Not more and not less. The database schema and UI stays untouched, so all Matomo (Piwik) statistics can be used like you would use a internet GeoIP database.

How to configure/install this plugin / the networks?

After installation and activation of the plugin, open the file piwik/config/

You can their add your location information and their subnetworks.

See the file piwik/config/ or see the readme on github

What statistics are available?

If you create a full configuration data file, you'll see * Visitor -> Realtime visitor map * Visitor -> Location and provider * and many more...(in generall all statistics are available like using a internet GeoIP database)

Why there stands provider "unknown" in my visitor log?

If your installation is stock, all visitors will get this "flag" to show you, what IPs are not matched. You can adjust or remove this, by changing the "noMatch" block in your file. If you remove the complete block, none matched visitors will be skipped by this plugin. But you can also fill all possible visitorInfos like you are used for matched IP addresses.

Can i use this plugin with a internet GeoIP database side by side?

Yes you can. Just remove or comment out the noMatch block in your configuration file.

Note about the configuration?

Inside the array key visitorInfo you can freely add/remove all available columns from the log_visit table you want. The keys below are just a suggestion, since they are the only one which make sense currently IMO. All available fields, see here:

Inside they key networks add all subnetworks which apply to this location.

return [
     * If the IP was not matched, apply these data to visitorInfo
     * You can also apply here all possible visitorInformation data if you want
    'noMatch' => [
        'visitorInfo' => [
            // Provider requires the "Provider" Plugin to be active. (Disabled by default in Version 2.15 and above)
            //'location_provider' => 'unknown'

        'visitorInfo' => [
            //ISO-3166 alpha-2 code
            'location_country' => 'at',

            //the region code (i take them from piwik/libs/MaxMindGeoIp/geoipregionvars.php
            'location_region' => '08',

            //should be freetext
            'location_city' => 'Muntlix',

            //get this from a picker, e.g.
            'location_latitude' => '47.282024',
            'location_longitude' => '9.662304',

            //enter your company name or do it based on your domain hierarchy
            // Provider requires the "Provider" Plugin to be active. (Disabled by default in Version 2.15 and above)
            //'location_provider' => 'myCompany'
        'networks' => [
            //enter here all subnetworks for this location
            //use a subnetwork calculator, e.g.

    //add more blocks live above
  • data

  • realtime

  • visitorMap

Please share