WP Super Cache 1.5.0

WP Super Cache is a fast full-page caching plugin for WordPress. Download it from your dashboard or get it here.

Version 1.5.0 has been in development for some time. It has a ton of bug fixes and new features.

REST API

The headline new feature is REST API access to the settings. This will allow developers to create their own interface to the settings of the plugin. Unfortunately it isn’t yet documented but you can see the code in the rest directory. Start with load.php where you’ll find the code that registers all the endpoints. Users who access the API must be logged in as admin users. If you want to test the API, see the end of this post.

Settings Page

We have also simplified the settings page to make it easier to choose which caching method is used.

Instead of maybe confusing the user with technical words like PHP, mod_rewrite and WP-Cache we have split them up into “Simple” and “Expert” delivery methods, and done away with mentioning WP-Cache completely. Simple delivery uses PHP, expert uses mod_rewrite and well, WP-Cache got the boot because it’s always active anyway.

WP-Cache caching is always active, but it can be disabled in different ways.

  • Disable caching for known users.
  • Don’t cache pages with GET parameters
  • Disable caching of feeds

Headers

We expanded the number of headers cached by the plugin. The list of headers was borrowed from Comet Cache. However, anonymous users will still only see the bare minimum like content-length or content-type. If you need to use security headers like “X-Frame-Options” or “Content-Security-Policy” you should enable caching of HTTP headers. This unfortunately disables super caching so only WP-Caching is used but it’s still very fast (and faster in this release than before which I will get to below). You can also use the “wpsc_known_headers” filter to modify the list of recognised headers.

WP-Cache Reorganisation

WP-Cache cache files are split into two files – one holds the page content, the other (meta file) holds information about the page such as cookies, headers and url. In the past these files were stored in two directories which could become a problem if there were many thousands of those files. Even with only a few hundred files, maintenance could be an issue as deleting related files (like page archives, or copies of the front page) needed every meta file to be inspected.
Now the files are stored in the supercache directory structure that mirrors your permalink structure. Deleting related files is is simpler and serving files will be faster as the operating system won’t need to open a directory of thousands of files.
If you currently rely on WP-Cache files, the plugin will still look for them where they are, but new WP-Cache files will be created in cache/supercache/example.com/ (where example.com is your hostname).

Sitemaps

We added support for caching sitemaps, but your sitemap plugin will need to cooperate to get it to work. The sitemap plugin needs to identify the sitemap request as a feed. Jetpack 5.1 now supports this since #7397. You can disable the caching by excluding feeds from caching.

Debugging Improved

The debug log is now protected by a username/password. For convenience, the username and password are the same but they are a long md5 string:

Deleting the log file clears it and resets it ready for more logging. Before, toggling debugging would create a new debug log and the old one would be kept around, but not linked, until deleted by garbage collection, and of course they were text files anyone could access.

This release includes lots of other small bug fixes and changes. Take a look at the number of closed PRs for an exhaustive list of those changes!

Testing the REST API

There are a number of ways to send POST requests to a web server but one I like is using curl in a shell script. You’ll need two bits of information from the website:

  1. The “wordpress_logged_in” cookie from your browser.
  2. The wp_rest nonce which you can get by adding `echo wp_create_nonce( ‘wp_rest’ );` somewhere on your site where you’re logged in. It’s good for 24 hours.

My test script looks something like this:
export NONCE='1234567890'
export COOKIE='wordpress_logged_in_xxxxxxxxxxxxxxxxxxxx=1234567890'
curl -v -X "GET" -H "Content-Type: application/json" -H "X-WP-Nonce: $NONCE" -H "Cache-Control: no-cache" -H "Cookie: wordpress_test_cookie=WP+Cookie+check; $COOKIE" \
-d '{}' "https://example.com/wp-json/wp-super-cache/v1/settings/"

Mindbomb – the beginning of Greenpeace

I’m going through my backlog of podcasts and this episode of Undone stood out. It’s about the beginnings of Greenpeace when a group of people in their twenties sailed a boat around the Pacific Ocean hoping to confront a fleet of Soviet whalers.

Near the end of their supplies they heard Russian voices on the radio and spotted the ships. The rest is history but the story is fascinating.

While looking up “Greenpeace mindbomb” I came across this article about a movie on Greenpeace called “How to Change the World” which covers the same subject. Here’s the trailer:

Unfortunately the podcast Undone was cancelled after one season but I’ve downloaded the rest of the episodes and look forward to listening to them.

Thank you Translators!

Well, well. WP Super Cache translations are coming along well. 100% of strings in the development version are translated into Canadian English and Romanian! (That might change over the next few days as I have a couple of UI changes in mind, sorry!)

Other languages like Persian, Japanese, Spanish, Russian and Italian are roaring along and sometimes only need a handful of words or sentences translated to hit that magic 100% too. The next version of the plugin will grab translations from WordPress.org if they’re available which is awesome for users around the world. We’re still shipping translation files but I think the release after that may ship without and rely entirely on the up-to-date online translations.

So, thank you so much to the translators. Code is nigh on useless if the user and developer don’t speak the same language and the interface is incomprehensible. WP Super Cache has lots of technical language which must be a pain to translate. Your work is invaluable!

Mulțumesc! متشکرم! ありがとうございました!¡Gracias! Спасибо! Grazie! Hvala ti! 谢谢!Vielen Dank!

Google Photos Overload

The Google blog announced that Google Photos will now allow you to share whole albums or just the photos of particular people with someone else.

I tried it this morning and it works, but there’s one big stumbling block. Too many photos.

When I take photos I’ll take 2 or 3 photos of the same scene sometimes, or if there are people in the photo I’ll take photo a few times just so everyone is looking at the camera. Or if kids are involved they’ll be looking every which way except at the camera.

So, what should really be one representative photo it’s really five or six images.

No. Using machine learning and image recognition is a huge step, but what a lot of non photographers want is a curated collection of “the best” photos.

I’m sure it’s only a matter of time before Google learns how to select from near identical photos to create this “best of” album. Their daily albums are a good indication that they can do this already.

The other problem with machine learning is that it might try too hard. This morning it suggested i share street photos I took a few weeks back. Unfortunately one of the suggested people was a former colleague who lives in Colorado and was not in Cork on the day. Another suggestion was my niece who also was not roaming the streets!

Anyway, I love Google Photos. The image recognition is amazing. I’ll search that for an image I need before diving into Lightroom 5 to edit it. 🙂

The Irish Digital Detox

Holly and Declan are a young couple addicted to 21st century technology. Writer and journalist Colm Tobin follows them to the island of Carnananánachán where they undergo a bizarre, back-to-basics digital detox.

Could you survive a week without your phone or any access to the Internet?

Your DNA results are now ready!

This was a weird email to receive since I have never sent off a DNA sample to any company.

Dear Friend,

Your DNA results are now ready!

The results of your DNA sample reveal information about your distant ancestors, including how and when they moved out of Africa and the various populations they interacted with over thousands of years of migration. We hope you enjoy exploring your chapter of the human story.

Sure enough, it’s spam from The National Geographic. The linked page allows you to buy the Geno 2.0 Next Generation kit.

I used to have an NG subscription years ago but I gave it up. I wasn’t reading it, and the issues were collecting dust in a corner. Looks like they’re harvesting their email lists. Anyone else get this email?

Howto: the Cork County Council Planning Enquiry System

The planning enquiry system of Cork County Council is a powerful system for downloading and viewing all the documents related to a planning enquiry. Unfortunately it relies on outdated software that most people won’t have access to any more (and for security reasons, that’s a good thing!). There are Android and iPhone apps too, but it’s not easy reading planning documents on small screens, and at least on Android requires the use of a third party app to view the .djvu files. You can also save the files to a dropbox folder to share with your desktop, but it’s awkward doing so. The mobile apps can’t download large files either.

When you first go into it, this is the page you see. If you’re using a modern browser (like Microsoft Edge, Chrome, Firefox or Safari) you can’t really do much more. It requires Internet Explorer to work.

However, by looking at the source code of the page I discovered this code that sends you to MainFrames.aspx.

The next page allows you to search the planning database but until you’re running Internet Explorer you won’t get very far as it uses the Autodesk Mapguide Viewer for it to show anything.

So, if you’re not running Internet Explorer on your up-to-date copy of Windows or you use macOS, Linux or anything else you’ve only one other option. Use a virtual machine.

Go grab a copy of VirtualBox and install it, then download a free virtual machine image from this Microsoft page and import that into VirtualBox. I found the IE9 one worked perfectly. It expires after 90 days but you can download another image if you need to later.

VirtualBox allows you to set up a shared folder where you can download the planning files, and work on them at your leisure!