Means.Us.Com

You can view and download the code from Github. Its been tested by various users without incident – but use at your own risk it might ruin your site. At some point I may submit the code for inclusion in WordPress.org’s plugin directory.

Special thanks to Pieter Boss for i18n work on this plugin. Do what you want with the source but please credit myself and Pieter in any code you develop.

Documentation (a work in progress).

The Country Caching for WP Rocket (CC4R) plugin:

---

1. Installation

---

1. Install plugin.

2. Dashboard->Settings->WP Rocket Country Caching and tick “Enable” to start Country Caching. (However you will probably want to select other settings as well.)

Caveat: I’ve not had problems; but do not test unless you can fix problems outside of WordPress (white screen of death issues frequently appear on caching support forums).

Multisite:

CC4R settings are accessible via the Network Admin dashboard (Network Dashboard->WP Rocket Country Caching)

Note 1: due to WP Rocket design the SAME country caching (CC4R) settings will be applied to ALL your sites.

Note 2: WP Rocket does not use .htaccess mod-rewrites in Multisite environments, consequently the CC4R rewrite option is also unavailable.

---

2. More Information:

---

---

2.1. Modify Rocket Rewrites option

---

Enabling this option is recommended. If you find enabling conflicts (it shouldn’t) with your site’s other plugins, or Rocket settings, then turn option off.

More information on Rocket Performance and this option here.

 

---

2.2. Optional Settings to reduce caching overheads

---

These examples refer to the _{field numbers} in Fig. 1 below):

i. Default – create a separate cache for every country from which site has had a visitor:

Leave [field 1] empty, and ensure [field 2] is NOT checked.

ii. All visitors to see site’s standard content except visitors from: e.g. France,Canada and Spain who see custom content.

Enter FR,CA,ES in [field 1] and ensure [field 2] is NOT checked.

Fig 1. Settings for example iv. (below)

Fig 1. Settings for example iv. (below)

iii. Just one Group, and one Standard (non-group) cache. Example: European Union countries and non-EU countries.

Enter “XX” (a non existent country never cached) in [field 1]. Ensure [field 2] is checked. Enter country codes for your group in [field 3] e.g. EU country codes.

iv. Some countries individually cached, a single cache for a group of countries, and a standard cached page for everyone else. Fig 1 above.

Fig 1 example. Site serves different Amazon adverts based on country (Japan=Amazon.jp, GB & Ireland= co.uk; rest of EU= .de, all others= .com). Additionally if a visitor is from the EU a Cookie Compliance plugin is run and notice displayed. Enter GB,IE,JP in [field 1], ensure [field 2] is checked; and insert EU countries in [Field 3]. N.B. it does not matter if you include GB & IE again – because they are listed in [field 1] they will be separately cached.

v. A single cache for specified list of countries; and all other countries to be individually cached.

Leave [field 1] empty. Ensure [field 2] is checked. Enter country codes for your group in [field 3].

 

---

2.3. GeoLocation method

---

i. Maxmind:

Should work with any server.

The look-up file was the latest version when you installed CC4R. It is located in “/wp-content/cca_maxmind_data/”. You can replace this as and when, with a new GeoLite2 Country from Maxmind’s download page.

Alternatively, if you are using the CCA plugin it will auto update the file each month (it uses the same “use Cloudflare or Maxmind” code, and shares the same Maxmind file).

ii. Cloudflare

Look-up used by many plugins. Fast, reliable. Ensure your Cloudflare Settings are set to default caching.

iii. Amazon

Fast. Ensure you set appropriate caching level on AWS/Cloudfront (I guess static content only). Not tested (I don’t use Amazon) – please let me know if it works for you.

iv. Other CDN/server header

Fast. Enter the $_SERVER variable and Http header name supplied by the provider. If a CDN ensure you’ve set its own caching appropriately.

In the case of Apache et al provided Geoip, your entry in “HTTP header name” should probably be the same as the $_SERVER variable name (as in above image).

In the case of 3rd party/CDN provided Geoip, then your server will likely provide a $_SERVER name that is an uppercase version of the Http Header Name with hyphens replaced by underscores and prefixed with “HTTP_” e.g. for Cloudflare the HTTP header name is “cf-IPCountry” and the $_SERVER variable name is “HTTP_CF_IPCOUNTRY”.

You can view your sites Http Header and Sever variables via CC4R’s “CC Info” tab.

v. Connect to other plugin

Ask plugin author to add the filter it’s in his interest to make her plugin Rocket compatible. Or add your own filter to your own site-specific plugin or “functions.php”.

The filter should return either a 2 character country ISO code or “error”. Example:

function cc4wpr_get_plugin_country() {
    $2charISOcode = "error";
    if ( function_exists('somegeo_function_forisoCode') ) {
      $2charISOcode = somegeo_function_forisoCode();
    }
    return $2charISOcode;
}
add_filter('cc_use_other_geoip', 'cc4wpr_get_plugin_country')

 

---

2.4. Geolocation compatibility, speed, accuracy

---

If you don’t specify a geolocation system then either Cloudflare (if available) or Maxmind’s country lite database (auto downloaded from Maxmind at the time you installed CC4R) is automatically used.

Compatibility between plugins:

For many sites displaying custom content by country the odd discrepancy is acceptable and CC4R’s default geolocation will be fine. If not, CC4R allows you to plug in the geolocation of your choice.

Discrepancies: there may be edge cases (1/1000 ?) where your plugin for country content identifies a different location than (default) CC4R. For example when using Opera VPN browser to “spoof” location, Cloudflare identifies me as from “XX” (unknown) but Litespeed as from France. There may also be rare discrepancies if your country plugin uses an older or newer copy of Maxmind’s DB.

N.B. Many decent WP plugins default to Cloudflare for compatibility. So if you have enabled Cloudflare Country chances of compatibility are high.

Geolocation and speed:

(Simplistically, this only applies to the first ever page requested by a new visitor.)

Accuracy:

Maxmind: updates its Country Lite DB file monthly and claims 99.8% accuracy. I assume CDNs have a similar level of accuracy.

N.B. most plugins using Maxmind do not auto-update the DB file, so geolocation will be less accurate. It is possible to auto-update Maxmind for CC4R.

Country from Server Headers: Typically generated from a now obsolete Maxmind (Legacy) look-up file last updated in April 2018. Server libraries do exist to use current Maxmind2 data, and it was added as an option in last months (Aug 2018) release of (Apache clone) Litespeed. However my shared Litespeed server still uses out of date Maxmind Legacy.

 

---

2.5. Performance

---

Partial Draft (incomplete)

In an ideal world WP Rocket will modify web server settings (.htaccess) for optimum performance so that cached pages are accessed and served directly and faster without delay of running scripts and MySQL/DBMS.

With these optimum settings, if page “/some-page” is requested, and a cached copy already exists ("/cache-dir-path/some-page/index.html"), then it will be immediately served to the visitor without loading WordPress or DBMS.

However; some Rocket Settings e.g. “Separate cache files for mobile devices” and some plugins require different versions of the same page to be cached. WP Rocket has Helper Scripts for these plugins which tells Rocket how to handle page content.

Many of these Helpers disable fast rewrite. E.g. a “gender” plugin may tell Rocket i. always run WordPress do not use fast rewrites, ii. do not cache first visit (no gender cookie), iii. once a visitor has set a gender cookie cache and serve either “/cache-dir-path/some-page/index-male.html" or “/cache-dir-path/some-page/index-female.html".

With the CC4R rewrite option enabled: Unless another plugin has told Rocket to remove fast rewrites: then Rocket will modify .htaccess so it can handle the variety cache file names needed for country caching.

CC4R’s rewrite option should not conflict with other plugins or settings, but if it does you can simply switch the option off.

 

---

2.6. CCA (Category Country Aware) users

---

CCA uses the same Cloudflare/Maxmind look-up script as this plugin – so CC4R’s default geolocation settings will work perfectly. The CCA plugin will also update the Maxmind look-up file each month for you (both plugins share the same copy of Maxmind’s file).

Alternatively, if you now wish to use country code provided by an Amazon or other CDN header then for compatibility configure CCA to do this as well. At a later date these choices will be added as standard options in CCA’s own settings form.

 

---

2.7. Country Blocking Plugins

---

I am not a fan. Those blocking in WordPress provide zero protection against DDOS attacks and allow WP/plugin code to run leaving you exposed to attacks on “new” vulnerabilities. In support forums you will also see Admins reporting they can no longer access WordPress.

I’ve no idea if Country Caching is compatible with these plugins. HTACCESS is faster and safer; I might build htacccess blocking into CC4R; however the DIY solutions below are just as good, and CDN blocking better.

CDN’s such as Cloudflare and Amazon allow you to block countries before they even hit your site. Alternatively, if available, use CDN or server provided country header to block in your htacess.

Otherwise, you can paste blocking “code” from Country IP Blocks into your htaccess.

---

3. Testing

---

You can visit Locabrowser.com to simulate visiting (and caching) your site from different countries. Alternatively use a VPN: The (500MB free) Tunnelbear Extension for Chrome has options for 20 countries.

---

Questions/Feedback

---

Just post a comment below. It would be useful if you provided an email address (not displayed) so I can contact you directly if necessary.

---