This IP Mapping FAQ (Frequently Asked Questions) is intended to assist you in providing answers to some of the most commonly asked questions. It is intended to supplement the IP Mapping documentation.
How do I get hold of a copy of the component?
The release is now available for download in the 'Download' directory. Registered users can see its usage by following the link 'Hacking and Spamming attempts' on the left hand side menu.
Does it work with Joomla 3.x?
Yes. The curreny release runs upon Joomla 2.5.x and Joomla 3.2.x.
Where is the documentation?
The full product documentation is available in PDF format at this web link. It covers all releases.
I have installed and configured the component and modules and can see the map, but none of the IP Address markers are shown?
There are a few possible causes of this, but the most common is that the site is configured to use an .htaccess file which is preventing access to the mapping function, which generates the map markers. If you are using a '.htaccess' file then you need to add the following to the file:
RewriteRule ^modules\/mod_ipmapping_mapper\/map_data\.php$ - [L]
Note that the placement of the above line is important and placing it at the end if the file will probably not be sufficient, as it is likely that an 'earlier' line in the file may well result in the file to be exited prior to it reaching your newly placed line. It is beyond the scope of this FAQ to go into the complexity of the entries in the .htaccess file and it is advised to refer to the official Apache documentation for precise details.
It is reported (although not verified by us) that a second possible cause is the settings upon the map_data.php file.
Changing the permissions upon the file map_data.php in the directory "modules/mod_ipmapping_mapper/" to 755 is reported to solve the problem.
chmod 755 map_data.php
This is not something we specifically recommend doing.
How many maps can I generate on a page.
The component module that generates the maps is written such that each map is generated uniquely. This means that theoretically there is an unlimited number of maps that can be displayed upon a page. In practise however each map does take a certain amount to generate so having a large number of maps on a page will make the page creation a little slow. This may be improved by only generating the maps periodically and implementing caching etc.
How accurate are the determined geographic locations?
The geographic locations are determined from the IPInfoDB itself, so are as accurate as those contained within the database. The component is using the 'free' provided information databases, but even the 'commercial' offerering do not provide better accuracy than 40Km even in the USA. People are encouraged to update the database by submitting corrections for any inaccuracies that they may find on the IpinfoDB site.
We have seen instances where the IPInfoDB does not return any information for some IP addresses. To try to resolve these we perform a second lookup using the Geobytes service. This service permits up to 20 lookups per hour for non-registered users, hence is only used as a backup. We may implement a registration mechanism for Geobytes if there is a demand.
Synchronising with the Akeeba log table takes a long time?
Depending upon the number of entries in the Akeeba Admin log table, it may take some time for the geolocation data to be populated. It is difficult to be very specific as to how long it will take since it depends upon the load upon the IP Info DB system as to how quickly it can respond. If you do cancel out of the update, you can rerun the sync process later and it will pick up from where it was stopped.
Why doesn't it work with Akeeba Admin Tools Core?
The information for the Akeeba Synchronisation required that Akeeba Admin is using the Web Application Firewall, which is only provided by the Pro version. Since this is not present in the 'Core' product the information is not present. In release 1.0.5 (and up) of IP Mapping the 'synchronisation icon' is not displayed if Akeeba Admin Tools Pro is not installed.
Are other languages supported?
The base language supplied is English. However the component has been written specifically to be able to support other languages. There are a number of submitted translations available. The list of available translations is show in the Translations area of the site.
We welcome any submitted language translations that users might like to contribute. These would then be made available to the whole community. We mainly use Transifex for managing component translations.
There is also a article upon our web site with details upon Transifex and how one can contribute as well as instructions upon how to package up a language translation for the a component.