Comments on: WP Super Cache Developer Documentation

By: Donncha

Donncha — Thu, 21 Jan 2010 20:50:10 +0000

This is a link in trunk, but of course that’s not live now.

By: Jeremy Clarke

Jeremy Clarke — Thu, 21 Jan 2010 20:17:58 +0000

Also, it would be great if there was a link to the documentation article from the main WP Super Cache page and from the readme.txt description, I tried to find it again and couldn’t except for this post.

Thanks,

By: jeremy clarke

jeremy clarke — Wed, 13 Jan 2010 22:25:03 +0000

After reading through the docs I was struck a few times by ambiguity caused by your use of ‘config file’ and ‘configuration file’. I think William’s confusion is because its not clear if you mean wp-config.php or wp-cache-config.php, which is an important difference (unless it could be either, in which case that’s relevant too). If you changed uses of ‘config file’ to be the actual filename it would probably clear up several sections.

By: jeremy clarke

jeremy clarke — Wed, 13 Jan 2010 21:45:11 +0000

Just wanted to add a +1 thanks for this! Developer documentation is always awesome.

By: Donncha

Donncha — Thu, 05 Nov 2009 17:44:50 +0000

Thanks William!

$wp_cache_plugins_dir is set in your config file which isn’t updated when you upgrade the plugin so no need to worry about that.

I’ll see about adding more examples, and comments to the plugins. Glad you found the docs useful.

By: William

William — Thu, 05 Nov 2009 17:32:29 +0000

Feedback requested, feedback provided.

1. “The plugin folder normally lives in wp-super-cache/plugins/ but by modifying the $wp_cache_plugins_dir variable in the config file you can put it anywhere. That’s a good idea if you develop your own supercache plugins …” That’s fine and dandy – until another SC plugin comes in and sets $wp_cache_plugins_dir for itself.

2. Please elaborate on the four filters wp_cache_key,
wp_cache_served_cache_file, wp_cache_get_cookies_values and do_createsupercache, such as possible secondary usages. Three common examples:

a. running my own PHP on before serving half-on requests without editing wp-cache-phase1.php myself.
b. force serving a fresh page if the http referer is a search engine result page.
c. force expiring the cache for a page because of a querystring parameter.

I call them ’secondary usage’ because filters aren’t supposed to have side effects. Go figure.

Sorry to bust your chops, Donncha, ye know those two sample plugins? Both absolutely aint got no inline documentation — not even one line of comment! Aint much help if your doc tells a padawan to use ‘em as a reference.

Thanks for posting this.

By: Donncha

Donncha — Wed, 04 Nov 2009 08:59:12 +0000

In the next version. I need to sort out a few gettext problems and sync with a few people who volunteered to translate. Maybe end of the week.

By: Gerrit

Gerrit — Wed, 04 Nov 2009 03:15:11 +0000

Just wanted to thank you for your advice and the documentation. It’s great and will be really helpful in the future. My cookie-plugin, btw, works fine now Thanks again!

By: Emilio

Emilio — Tue, 03 Nov 2009 19:04:33 +0000

Good! This is exactly what I needed.

Now Autoptimize will interact better with WP Super Cache

By the way, when will wp_cache_clear_cache() be available?