Table of Contents
The main page of the component which gives you access to all of its functions is called the Control Panel.
The Control Panel page
The Control Panel is split in three areas, a top area, the left-hand control panel icons and the right-hand information boxes.
If there is an update available, you will see the information about it at the very top of the page. Click on the Update button to go to the Joomla! extensions update page where you can install the update.
The top area displays information about the Geographic IP (GeoIP) database. Please read on towards the bottom of this section for more information.
In the left hand area you have icons which launch the individual tools out of which Admin Tools is made when clicked. Each of those tools is described in a section of its own in the rest of this documentation.
Clicking on thebutton will launch the System - Admin Tools plugin configuration page in a pop-up dialog box. In there, you can configure the scheduling options for Admin Tools' utilities. Do note that this feature is only available in the Professional edition.
The topmost right hand information pane displays the Admin Tools version information. You can see the version of the software, as well as force-reload the update information for Admin Tools itself. The latter is only necessary if there was an update released in the last 24 hours and your copy of Admin Tools has not "seen" it yet.
Below that you will see the graphs showing the number of logged security exceptions (attacks Admin Tools Professional has protected you against), their distributions by type and a few statistics about them, e.g. how many exceptions have occurred in the last year, month, week, day and so on.
This product includes GeoLite2 data created by MaxMind, available from MaxMind. This is only required by the Professional version of the component.
Certain features in Admin Tools require it to be able to find out the country and / or continent associated with the IP address of a visitor of your site. This is used to provide country information on blocked requests, as well as the Geographic IP Block feature. Naturally, IPs do not carry geographic information so we need an external database which has this kind of information.
Admin Tools requires you to install an optional plugin called "System - Akeeba GeoIP provider plugin". You can download it for free from our site. Please remember to enable it after you install it.
This plugin is using the third party MaxMind GeoLite2 database to match IPs to countries and continents. This list is not static, i.e. it is updated about once per month. Admin Tools can attempt to download its newest version by clicking thebutton in the Control Panel page. However, if this is not possible (for reasons ranging from your host restrictions to permissions issues) you can do so manually.
can download the latest version of MaxMing
GeoLite2 database in binary format, from http://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.mmdb.gz.
Extract the downloaded compressed file using gunzip on Linux, 7-Zip on
Windows or BetterZIP on Mac OS X. It will result in a file named
GeoLite2-Country.mmdb. Upload it to your site's
plugins/system/akgeoip/db directory overwriting the
Capitalization matters! You have to upload the file as
If you are a subscriber to MaxMind's more accurate (99.8% advertised accuracy), for-a-fee GeoIP Country database you can use that database instead of the free GeoLite2 database included in the component, using the same procedure.
Do note that security exception log records prior to installing the new version of the database will not be affected. Only security exceptions logged after uploading the new database version will be affected by the new database version.