https://github.com/ip2location/ip2location-piwik
IP2Location geolocation service to lookup a visitor's location in Matomo (Piwik) 4.x, 5.x. This service allows you to determine the country, region, city, coordinates, zip code, time zone, ISP, domain, MCC, MNC, mobile brand name, elevation, usage type, address type, IAB category, and more, associated with any given IP address.
https://github.com/ip2location/ip2location-piwik
database geolocation ip-database ip-geolocation ip-lookup ip2location ip2location-piwik matomo
Last synced: 4 months ago
JSON representation
IP2Location geolocation service to lookup a visitor's location in Matomo (Piwik) 4.x, 5.x. This service allows you to determine the country, region, city, coordinates, zip code, time zone, ISP, domain, MCC, MNC, mobile brand name, elevation, usage type, address type, IAB category, and more, associated with any given IP address.
- Host: GitHub
- URL: https://github.com/ip2location/ip2location-piwik
- Owner: ip2location
- Created: 2014-03-27T07:11:06.000Z (over 11 years ago)
- Default Branch: 5.x-dev
- Last Pushed: 2025-02-26T05:24:15.000Z (8 months ago)
- Last Synced: 2025-03-31T10:01:36.601Z (7 months ago)
- Topics: database, geolocation, ip-database, ip-geolocation, ip-lookup, ip2location, ip2location-piwik, matomo
- Language: PHP
- Homepage: http://www.ip2location.com
- Size: 576 KB
- Stars: 33
- Watchers: 10
- Forks: 19
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# IP2Location Matomo
[](https://packagist.org/packages/ip2location/ip2location-piwik)
[](https://packagist.org/packages/ip2location/ip2location-piwik)
## Description
This IP2Location plugin enables more accurate location lookup in your Matomo visitor log.
You need a IP2Location BIN database to make this plugin works. Database is available for free at
https://lite.ip2location.com or https://www.ip2location.com for a commercial database.
## Installation / Update
1. Login into your Matomo administrator page.
2. Go to System → Plugins.
3. Click on the **Install New Plugins** button at the bottom of the page.
4. Search for **IP2Location** from the plugin page.
5. Install and activate the plugin.
6. Upload a IP2Location BIN database to **misc** folder.
7. Navigate to **System → IP2Location** page to make sure the BIN database is detected by the plugin.
8. Go to System → Geolocation.
9. Select **IP2Location** as provider and save.
## Configure settings
You can visit IP2Location Settings by selecting the menu on the left pane (under **System**). This plugin support geolocation lookup using IP2Location BIN file and web service.
**To use BIN file, please download it from the below links**
* [IP2Location LITE Database (Free)](https://lite.ip2location.com)
* [IP2Location Database (Commercial)](https://www.ip2location.com)
**To use ip2location.io Geolocation API service, please sign up for the free account at**
* https://www.ip2location.io
## How to import the IP2Location BIN file for usage
You should copy the BIN file into **/var/www/html/misc** folder (for default installation). If you customize the installation path, it should be the **misc** folder inside your root folder.
If you are using Matomo docker image, then you can use below command to copy the BIN into Matomo container.
```
sudo docker cp {YOUR_LOCAL_BIN_FILE_LOCATION} {YOUR_MATOMO_CONTAINER_NAME}:/var/www/html/misc
```
## FAQ
__How to I configure the plugin?__
Login as administrator, then go to System → IP2Location.
__Where to download IP2Location database?__
You can download IP2Location database for free at https://lite.ip2location.com or commercial version from https://www.ip2location.com
__Can I use IP2Location.io Geolocation API service?__
Yes, please create an account from https://www.ip2location.io/ and insert your API key in the settings page.
IPv4 BIN vs IPv6 BIN
====================
Use the IPv4 BIN file if you just need to query IPv4 addresses.
Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.
## License
GPL v3 / fair use
## Support
Website: https://www.ip2location.com
Email: support@ip2location.com