How to install and update IP2Location

Tags Matomo PIWIK

 

Audience

Matomo Users

PIWIK Administrators

 

Overview

These are step-by-step instructions on how to install and update IP2Location.

 

Steps for Installing IP2Location

System requirements:
PIWIK installation up and running

  1. Logon to PIWIK with administrator rights.
  2. Locate the "Gear/Wheel" symbol on the top right hand corner of the main page and click it.
  3. Once at the administration page locate the Plugins button on the left side of the page under Administration and click it.
  4. On the right side of the page you will see the "Install New Plugins" link. Click that link.
  5. You will now be given the Marketplace page identifying the new/possible plugins that can be used. Locate the IP2Location Plugin and click Install.
  6. Once you have successfully installed the Plugin you will see the plugin displayed on the left hand side. Now you must configure the plugin to communicate with a DB for its data.

 

Steps for Upgrading IP2Location Database

  1. Logon to PIWIK with administrator rights.
  2. Locate the "Gear/Wheel" symbol on the top right hand corner of the main page and click it.
  3. Once at the administration page locate the specific plugin IP2Location on the left side of the page under Administration and click it.
  4. If you have not configured the plugin to use a DB you must do so. Navigate to http://lite.ip2location.com/ and download the most current DB appropriate for your installation. Ensure you download the IPV4 BIN file. You can use the CSV file but then you will be required to import to the DB. The BIN file is much easier.
  5. After you have downloaded the BIN file you will extract/unzip the file into the following directory path \inetpub\wwwroot\webanalytics\plugins\IP2Location\data\.
  6. The PIWIK system will automatically recognize the BIN file and you will see your ability to query any IPV4 address for its specific information.

Plug-ins to be Used

For best performance and a more detailed identification of visitor activities the below third party plugins were added to the normal default PIWIK installation.

  1. AdminNotification: Allows for a message to be placed on all user dashboards. This can be used to pass technical information concerning scheduled maintenance.
  2. BotTracker: Detects bots & spiders and counts their visits without tracking them in the visitor log.
  3. CustomDimensions: Extend Piwik to your needs by defining and tracking Custom Dimensions in scope Action or Visit.
  4. FreeMobileMessaging: Mobile Messaging Plugin: Free Mobile support.
  5. IP2Location: Use IP2Location geolocation database to lookup for accurate visitor location in Piwik.
  6. Ip2Hostname: Piwik plugin to get the hostname from the visitor IP.
  7. LogViewer: View Log messages logged by PIWIK.
  8. LoginLDAP: Login plugin with LDAP authentication. Provides an alternative to the standard Piwik Login plugin.
  9. PerformanceInfo: Piwik plugin to check if the settings are good for security/performance.
  10. PlatformsReport: New report in Visitors > Platforms that aggregates visits based on device type, OS version & browser version.
  11. ReferrersManager: This plugin allows to view and manage search engines and social networks that are recognized with Piwik.
  12. ReportPublisher: Publish Piwik reports to external systems using various protocols. Please consult the changelog for available protocols.
  13. SecurityInfo: Based on PhpSecInfo from the PHP Security Consortium, this plugin provides security information about your PHP environment and offers suggestions for improvement. It is a tool in a multilayered security approach. It does not replace secure development practices nor audit the code/application.
  14. TrackingCodeCustomizer: The provided values will replace the defaults in the generated tracking code (leave blank to use defaults). Viewing https://github.com/piwik/piwik/blob/master/core/Tracker/TrackerCodeGenerator.php is recommended to deconstruct how the tracking code is built.
  15. TreemapVisualization: This Piwik plugin adds a new report visualization: the treemap.
  16. kDeBug: Activate or deactivate DEBUG tracking mode with a simple click.

 

 

 

Feedback and Concerns:

If you have any feedback regarding this article, please reach out to hsitkb@pitt.edu.  You can also leave a comment below as well. 

Print Article