Chapter 2. Install and Uninstall

Installing IP Mapper

Installation uses the standard Joomla install method.

[Important]Important

Do NOT uninstall Macrotone IP Mapping before updating it! Uninstalling will remove all of your data, including all of your configuration information!

[Note]Note

The language (translation) files are NOT installed automatically. You can download and install them from our language download page. Do note that you will have to install both the component and the language packages for the component to work.

Macrotone Consulting Ltd only produces the English language files. All other languages are contributed freely by third parties. If you spot an error if the first instance please go to the translation project page to find the contact information of the translator. Abandoned languages will show the maintainer being our staff member "geoffc". In this case we will try to help you but our knowledge of foreign languages is very limited; if you would like to fix the language package you will need to create a Transifex account and to volunteer to take over the translation project for that language.

Download the Latest Version

Once you have downloaded the latest version, you are ready to install the component.

Step 1 of 4 - Install the Component:  Login to your Joomla Administrative centre and in the Extensions menu, click on the Browse button and navigate to the file location where you downloaded the file.  Click on the file and then click on the Install/Uninstall button.

Figure 2.1. Initial Installation Screen.

Initial installation screen.

Step 2 of 4 - Once the Component is installed, the following screen will be displayed.

Figure 2.2. After installation screen


Step 3 of 4 - Configure the Component: Navigate to the Component: IP Mapping Control Page. Choose the Options icon ion the top right hand side of the page, and set as required, especially the API Key. Settings are described in the documentation.

Step 4 of 4 - If you are intending to use the cron feature read the section in this document specifically about the Cron feature.

Using Live Update

Macrotone IP Mapping integrates the Akeeba Live Update system. Log in to your site's backend and go to Components, Macrotone IP Mapping . Look towards the bottom of the page. There should be an icon which reads "Update found" when there is a new version available. Click on it and then click on "Update now". The new version will be downloaded and installed automatically for you. In case this doesn't work, or if "Live Update not supported" is displayed below the icon, please make sure that your host's firewall allows TCP/IP communications over port 80 and 443 to macrotoneconsulting.co.uk. If your host requests IP addresses instead of domain names, please ask them to trace them from the server as they are multicast hostnames, which means that they resolve to a different IP depending on where in the world you are.

Module Configuration

As well as installing the component there will be two modules installed which will need configuring before use:

mod_ipmapping_mapper: This module is responsible for the display of Google Map in any desired module position in your site template using the data in the database. This component accepts a number of options as to the ‘reasons’ used for the selection of the data as well as options to control toe display of the map itself. Depending upon your requirements you may wish to have multiple copies of the modules available to display different maps.

[Important]Important

If your site is using a ‘.htaccess’ file to control site access then it is necessary to allow the ‘map_data.php’ file to be visible. To do this it is necessary to add the following exception to the ‘.htaccess’ file:

RewriteRule ^modules\/mod_ipmapping_mapper\/map_data\.php$ - [L]

The placing of the is directive is important, since the .htaccess file is processed in order, hence if placed at the end of the file the directive would never be reached and hence will not work.

mod_ipmapping_visitoragent: This optional module is responsible for the placing visitor information in the location table in the database, if it is desired to track visitor locations. It also has a few options that should be configured. It will require the setting of an API Key IF the key has not been already specified in the component.

To be able to record visitors data you must ENABLE visitor agent module first. It can be placed at any module position of your template but it is a good idea to place it in a footer (or header) positions.

Test record

The component has been tested successfully on Joomla 3.4.1 with PHP Version 5.5.24 and above with MySQL database version 5.1.36 and above with the following browsers:

- IE11

- Firefox 43

- Google Chrome

Go To Top

Joomla! Debug Console

Session

Profile Information

Memory Usage

Database Queries