Chapter 2. Using Admin Tools

The Control Panel

The main page of the plugin which gives you access to all of its functions is called the Control Panel.

The Control Panel page

The messages area

At the top of the Control Panel you can see one of several messages.

If there is an update available you will get a notification with a link to update Admin Tools. Clicking on it will take you to the Update page where you can apply the update.

If you are using Admin Tools Professional, our for-a-fee version, but have not yet entered your Download ID you will be given instructions on how to do it. The Download ID is necessary for receiving updates to the Professional version.

If Admin Tools detects that the MaxMind GeoLite2 Country database is out of date or does not exist it will ask you update or install it, respectively. This is required for the geographic IP blocking feature to work, as well as showing you the country of origin of the attacks in information emails.

If Admin Tools detects that the IP you are currently using has been blocked automatically it will offer you the option to unblock it with the click of a single button.

Other informative messages may also appear in this area. We strongly advise you to read them carefully. We only show you messages when we believe you need to take some action with relevance to your site's security.

The main control panel (buttons) area

The left hand side of the main area of the page contains the main control panel. It consists of several groups of buttons. Each button corresponds to a feature available to Admin Tools. The rest of the documentation will describe each of these features in more detail.

The updates and statistics area

The right had side of the main area of the page contains the updates and statistics area.

Towards its top you can see the Admin Tools version information and the availability of updates. You can also review the changelog of the currently installed Admin Tools version.

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.

What is the GeoIP database, installing and updating it


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.

Our 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 the Update the GeoLite2 Country database button 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.

You can download the latest version of MaxMing GeoLite2 database in binary format, from 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 wp-content/plugins/admintoolswp/app/assets/akgeoip/db directory overwriting the existing file.


Capitalization matters! You have to upload the file as GeoLite2-Country.mmdb.gz, not geolite2-country.mmdb.gz or any other combination of lowercase / capital letters, otherwise IT WILL NOT WORK, AT ALL.


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.