Country Caching Extension


Solves wrong country content for visitor Geo-Location issues. Enables Comet Cache to display the correct page and widget content for a visitor’s country.

If you need country caching with other caching plugins then see “Advice” below.

This plugin adds an extension to Comet Cache enabling it to create separate snapshots (cache) for each page based on country location.

Extra caching can be restricted to specific countries and/or a group of countries. E.g. if you are based in the US but show different content to Canadian,Mexican & EU country visitors, you can set separate caching for CA & MX visitors + single group cache for EU visitors; the remainder of your visitors will standard cache (“US”) content.

It works on normal WordPress and on Multisite (see FAQ).

Comet Cache is designed to work with add-on scripts and should work seamlessly with this plugin.

Identification of visitor country for caching

Via Cloudflare or Maxmind. (this product includes GeoLite data (both IPv4 and IPv6) created by MaxMind, available from .)

If you use Cloudflare and have “switched on” their GeoLocation option ( see Cloudflare’s instructions ) then it will be used to identify visitor country. If not, then the Maxmind GeoLite Legacy Country Database will be used.

Note: not tested on IPv6 (my servers are IPv4), however feedback on Stackoverflow indicate the code should work fine for IPv6.

Updating The provided Maxmind Country/IP range data files will lose accuracy over time. If you wish to keep your IP data up to date, then installation of the Category Country Aware plugin
(here on WordPress.Org) is recommended. The CCA plugin automatically updates Maxmind data every 3 weeks (even if you don’t use any of its other features).

Additional Info and support


Don’t use ANY Caching plugin UNLESS you know how to use an FTP program (e.g. Filezilla).

Support forums show that Caching plugins including Comet Cache can result in “white screen” problems for some users; the only solution may be to delete files using FTP/Cpanel or OS command line.

The Country Caching plugin deletes files on deactivation/delete, but in “white screen” situations you may have to resort to “manual” deletion – see FAQ for instructions.

WP Super Cache: is also designed to work with “add-ons” and an equivalent of this plugin is available in the WordPress repository.

W3 Total Cache does not currently provide a suitable hook for plugin country caching. Others have requested this facility.


This program is free software licensed under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

In particular please note the following:

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


  • Simple set up. Dashboard->Settings->Country Caching
  • Configuration and Server Info


The easiest way is direct from your WP Dashboard like any other widget:

Once installed go to: “Dashboard->Country Caching”. Check the “Enable CC Country Caching add-on” box, and save settings.

If you want automatic “3 weekly” update of Maxmind Country->IP range data then also install the Category Country Aware plugin (here on WordPress.Org).


Installation Instructions

The easiest way is direct from your WP Dashboard like any other widget:

Once installed go to: “Dashboard->Country Caching”. Check the “Enable CC Country Caching add-on” box, and save settings.

If you want automatic “3 weekly” update of Maxmind Country->IP range data then also install the Category Country Aware plugin (here on WordPress.Org).

Where can I find support/additional documentation

Support questions should be posted on WordPress.Org
Additional documentation is provided at

How do I know its working

See these checks.

How do I keep the Maxmind country/IP range data up to date

Install the Category Country Aware plugin from WordPress.Org; it will update Maxmind data every 3 weeks.

Will it work on Multisites

Yes, it will be the same for all blogs (you can’t have it on for Blog A, and off for Blog B).

On MultiSites, the Country Caching settings menu will be visible on the Network Admin Dashboard (only).

How do I stop/remove Country Caching

Deactivating the plugin will remove the Caching Extension. Then clear the QC cache (Dashboard->QuickCache->Clear)

If all else fails:

  1. Log into your site via FTP; e.g. with CoreFTP or FileZilla.
  2. Delete this file: /wp-content/ac-plugins/cca_qc_geoip_plugin.php
  3. Delete this directory: /wp-content/plugins/country-caching-extension/
  4. Then via your WordPress Admin: Dashboard->QuickCache->Clear


Simply awesome

Saved a lot of money, thanks, developer. the plugin works flawlessly and fulfils every need based on geoip.

Read all 1 review

Contributors & Developers

“Country Caching Extension” is open source software. The following people have contributed to this plugin.




Added checking of additional server variables for visitor’s IP Address.
Fixed display bug on “Support Tab” – extension info will now display even if Caching has not been enabled in Comet Cache.
Support Tabs “Display GeoIP data” now displays values of the server’s visitor IP variables


Modified for new Comet Cache. Previous version (0.8.0) still works, but this version has been modified to use the latest Comet Cache methods.
After update it is advisable to uncheck/save then check/save the “Enable CC” box on Country Caching Settings. Quick Cache (very old) is no longer supported.


Added option to enable the same cache to be used for a specified group of countries e.g. the European Union


Modified to work with re-designed ZenCache v150626. N.B. When ZC v150626 was first released it had a bug (patched in later downloads) if you are
using this version of ZC clear your cache after installing Country Caching 0.7.4


Maxmind data files are now auto installed (when you first enable Country Caching) in a shared directory for use by other plugins.
The data files are provided by Maxmind under Creative Commons license, but the repository requires all files stored there should be licensed under GPL. The Plugin has been altered to comply.


Compatability tweak for the new released Zen Cache – which turns out not to just be QC renamed but modified code. The add-on script generated by earlier versions of the Country Caching
(CC) plugin DOES work with Zen Cache; however the CC Settings form on these versions was incorrectly stating Zen Cache wasn’t present on your system.


Bugfix: 644 file permissions may be unsuitable for dedicated servers; now, if the plugin detects that other files on your server are set to 664 then the add-on script is granted 664 permissions
Improvements: More diagnostic information available.
Servers with “non standard permission” requirements – you will have option to save generated add-on script for your own FTP upload to directory


Bugfix: resolves compatibility issue with some GeoIP plugins.
If you are updating from version 0.5.0 you should uncheck/save then check/save the “Enable QC” box on Country Caching Settings and then clear cache via Quick Cache settings.


  • First published version.