Quick Cache improves performance by serving a snapshot (cache) of a previously visited page, making it unnecessary for WordPress to generate a fresh “new” page for every visitor.
This causes the display of wrong content on sites that use country geo-location. This page should display your National flag . However, if the page was “first” requested by someone in Albania, QC would, instead, serve you the cached page with the Albanian flag. The Country Caching extension solves this problem.
In this article:
1. What the Country Caching Extension for QC does:
- It builds an add-on script which uses an official QuickCache interface to cache by page/country instead of just page. You can limit separate caching to specified countries.
- It provides the GeoIP look-up to enable QC to determine the visitor’s country.
2. Installation and set-up of the CC Extension
Install in the normal way via “Dashboard->Plugins->Add New” and search for “Country Caching Extension“; or download from WordPress.Org.
Quick Setup: “Dashboard->Country Caching“. Check the “Enable ZC/QC” check box, and click save.
You can separately cache for ALL countries (Country Codes box empty).
Alternatively, you can allow most visitors to see the same “normal” cached page, and just specify specific countries that should have their own separate cache e.g. specify “FR,CA” if only visitors from France and Canada should see content different to the “normal” page.
3. How do I know it is working
Quick Cache inserts hidden HTML comments at the bottom of pages and we can tell from these whether country caching is working.
<!-- Quick Cache file path: /cache/quick-cache/cache/http/example.com/somepage.v/US.html --> <!-- Quick Cache file built for (US http/example.com/somepage/) in 0.43448 seconds, on: Dec 3rd, 2014 @ 7:21 pm UTC. -->
NOTE: this WILL NOT BE DISPLAYED if you are using a plugin or CDN that is set to MINIFY HTML
- After installing Country Caching go to Quick Cache settings and clear the existing cache.
- Open a page on your site using a “virgin” browser (see below)
- View the source for the page e.g. if using IE right click on the page and select “view source” option
- Check the Quick Cache comments at the bottom of the source.
If Country Caching is working you will see the country code for your location is used as a suffix by Quick Cache (see “US” country code highlighted in yellow in the above example).
- Quick Cache does NOT cache pages if you are (or have PREVIOUSLY been) logged in.
To test, use a browser that has NEVER been used to log in to your site (if you can’t do this ensure you are not logged in and cookies are deleted before viewing a page).
- If you are using a plugin or a CDN like Cloudflare with an option set to minify HTML then you won’t see these comments.
N.B. if you have limited separate caching to specific countries then ensure your country is in this list during your tests, otherwise you will (correctly) see Quick Cache comments indicating the normal cache is being used.
You can also test by using Country proxy servers.
4. GeoLocation, and how to auto-update:
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, included with this plugin, will be used.
Updating The included Maxmind Country/IP range data files will lose accuracy over time. If you would like an automate update of these files then install the Category Country Aware plugin (here on WordPress.Org). Even if you don’t use any of its other features, it will automatically update GeoIP data “every 3 weeks”.
5. Problems and Issues
If the plugin is unable to save the generated add-on script it is probably due to your server’s permissions. Read Smashing Magazine’s article on WordPress Folder and File security requirements for different servers; and how to change WP Folder and File permissions.
If permission changes still do not enable the plugin to save the add-on script, then you can use the plugin’s option to download the add-on, which you can then manually upload to your server using FTP (see below).
Directory Permissions: Assuming you have a “typical” server, permissions for your WordPress “wp-content/” and “wp-content/ac-plugins/” (if it exists) folders should be set to 755 on a shared server, and 775 on a dedicated server; do NOT use slacker permissions.
File permissions for “cca_qc_geoip_plugin.php”: Old versions of the CC plugin (pre 0.6.2) were over zealous, and on first creating the add-on set permissions to 644. On a dedicated server this may prevent later changes to the add-on; to resolve this problem delete the add-on or change its permissions to 664. The current versions of the plug-in should correctly determine what file permissions to set.
Alternative solution: manual upload:
The “Files” tab with the download option (image above) will appear if the CC plugin is unable to create the add-on.
- Check that the country settings for the add-on are as required (these will be displayed just above the download button). If not, go back to the settings form “Zen/QC” tab, change the Country settings field and click “Save”.
- Click “download” to save the file (“cca_qc_geoip_plugin.php”) to your local machine.
- Use a text editor to open the file. It should contain PHP code; if just contains an error message then abandon the upload.
- connect to your server with FTP and change directory to the WordPress “wp-content” folder.
- if it doesn’t exist create the “ac-plugins” sub-directory under “wp-content” and go to it.
- upload “”cca_qc_geoip_plugin.php” to “ac-plugins”; then exit ftp.
- on the CC settings form switch to the “Zen/QC” tab, confirm you have completed the upload and click update.
6. Auto & Manual Uninstall
You should deactivate (removes the add-on script) and then delete the plugin in the normal manner. Then clear the QC cache (Dashboard->QuickCache->Clear)
However, just like with Quick Cache there may be occasions when the normal method fails to completely uninstall.
If all else fails:
- Log into your site via FTP; e.g. with CoreFTP or FileZilla.
- Delete this directory and contents: /wp-content/plugins/country-caching-zen/
- Delete this file: /wp-content/ac-plugins/cca_qc_geoip_plugin.php
- Then, via your WordPress Admin: Dashboard->QuickCache->Clear
You should not use ANY Caching plugin OR extensions to them UNLESS you know how to use an FTP program (e.g. Filezilla). Caching plugins can cause “white screen” problems for some users; and sometimes the only solution is to manually delete files using FTP or OS command line. Quick/Zen cache is no different; when I checked the first page of its support forum included 3 posts about this. 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.