Title: WeAmp Cache Control for ModPageSpeed
Author: oschaaf
Published: June 18, 2026
Last modified: June 18, 2026
---
Search plugins
# WeAmp Cache Control for ModPageSpeed
By [oschaaf](https://profiles.wordpress.org/oschaaf/)
[Download](https://downloads.wordpress.org/plugin/weamp-cache-control-for-modpagespeed.0.1.0.zip)
* [Details](https://wordpress.org/plugins/weamp-cache-control-for-modpagespeed/#description)
* [Reviews](https://wordpress.org/plugins/weamp-cache-control-for-modpagespeed/#reviews)
* [Installation](https://wordpress.org/plugins/weamp-cache-control-for-modpagespeed/#installation)
* [Development](https://wordpress.org/plugins/weamp-cache-control-for-modpagespeed/#developers)
[Support](https://wordpress.org/support/plugin/weamp-cache-control-for-modpagespeed/)
## Description
This plugin is the control panel for ModPageSpeed — a web server optimization module
for nginx and Apache. ModPageSpeed must be installed and running on your server
for this plugin to function. It is not a standalone caching plugin.
The plugin does three things:
1. **Enables full-page caching** — adds `Cache-Control: public, max-age=N` to anonymous
page responses (WordPress does not send this by default), with explicit bypasses
for logged-in users, WooCommerce cart/checkout/account pages, search, feeds, and
404s.
2. **Keeps the cache fresh** — calls the ModPageSpeed purge API when you publish,
update, or delete content, when comments change, when stock levels change, and
when terms or theme settings change.
3. **Gives you control in WP Admin and WP-CLI** — per-post-type TTLs, cookie bypass
list, excluded URL patterns, a first-run setup wizard, and `wp pagespeed flush|
status|test-connection` commands.
Works with both ModPageSpeed product lines (auto-detected), with one important difference:
* **ModPageSpeed 2.0** caches full HTML pages itself — the plugin’s headers and
purge calls drive the module’s page cache directly.
* **mod_pagespeed / ngx_pagespeed 1.1** does not cache HTML (it is a streaming
rewriter; its in-place optimization caches only images, CSS, and JS). Full-page
caching on 1.1 requires an external cache layer in front (nginx `proxy_cache`,
Varnish, or a CDN) plus `ModifyCachingHeaders off` or `DownstreamCachePurgeLocationPrefix`—
with 1.1’s default `ModifyCachingHeaders on`, the module replaces this plugin’s
Cache-Control header on rewritten HTML. On 1.1, the plugin’s purge calls evict
optimized sub-resources and metadata, not HTML pages.
#### Server requirements
* ModPageSpeed 1.1 (v1.15.0+r3 or later) or ModPageSpeed 2.0 (v2.0.0 or later)
installed on your web server.
* For 2.0: the worker admin API enabled (`--api-port`).
* For full logged-in-user correctness an nginx cookie-bypass map block is required—
the setup wizard provides a copy-paste snippet and verifies it.
#### WP-CLI
* `wp pagespeed flush [--url=]` — purge the home page (and posts page), or
one specific URL on this site.
* `wp pagespeed status` — detected product, version, license tier, purge prerequisites,
and last-purge status.
* `wp pagespeed test-connection` — verify the admin API is reachable and correctly
configured (read-only, never purges).
#### License
This plugin is free software, licensed under the GNU General Public License v2.0
or later. The full GPL-2.0 license text is bundled with the plugin in the LICENSE
file.
### Third Party Services
This plugin makes HTTP requests to the operator-configured ModPageSpeed admin API
URL. Data sent includes page URLs (for cache purging) and an API key (for authentication).
No data is sent to We-Amp or any third party.
## Screenshots
[⌊Settings page: live server status, deployment prerequisites, and cache controls.⌉⌊
Settings page: live server status, deployment prerequisites, and cache controls.⌉[
Settings page: live server status, deployment prerequisites, and cache controls.
[⌊Setup wizard: six guided steps from server detection to a verified purge.⌉⌊Setup
wizard: six guided steps from server detection to a verified purge.⌉[
Setup wizard: six guided steps from server detection to a verified purge.
[⌊Automatic server detection and connection test against the admin API.⌉⌊Automatic
server detection and connection test against the admin API.⌉[
Automatic server detection and connection test against the admin API.
[⌊The wizard hands you the exact nginx cookie-bypass snippet your deployment needs.⌉⌊
The wizard hands you the exact nginx cookie-bypass snippet your deployment needs
.⌉[
The wizard hands you the exact nginx cookie-bypass snippet your deployment needs.
[⌊Final wizard check: a live test purge proves the invalidation path end to end.⌉⌊
Final wizard check: a live test purge proves the invalidation path end to end.⌉[
Final wizard check: a live test purge proves the invalidation path end to end.
## Installation
1. Install ModPageSpeed on your server (see https://modpagespeed.com/).
2. Install and activate this plugin.
3. Follow the setup wizard under Settings > ModPageSpeed: detect your server, enter
the admin API URL, test the connection, apply the nginx.conf snippet, enable caching,
and run a test purge.
## FAQ
### Does this plugin cache pages itself?
No. Caching happens server-side: in the ModPageSpeed 2.0 module itself, or — on
1.1 — in your front cache (proxy_cache, Varnish, or CDN; the 1.1 module does not
cache HTML, see the Description). The plugin only sets cache headers and sends purge
requests — the same architecture as other server-layer cache plugins.
### I run mod_pagespeed / ngx_pagespeed 1.1 — do I get full-page caching?
Not from the module alone. 1.1 never caches HTML; put an external cache (nginx `
proxy_cache`, Varnish, or a CDN) in front of it and set `ModifyCachingHeaders off`(
or use `DownstreamCachePurgeLocationPrefix`) so this plugin’s Cache-Control headers
reach that cache. The plugin’s purge calls on 1.1 evict optimized sub-resources
and metadata.
### Does it work without ModPageSpeed installed?
No. The setup wizard will guide you to the server module installation docs if no
server is detected.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“WeAmp Cache Control for ModPageSpeed” is open source software. The following people
have contributed to this plugin.
Contributors
* [ oschaaf ](https://profiles.wordpress.org/oschaaf/)
[Translate “WeAmp Cache Control for ModPageSpeed” into your language.](https://translate.wordpress.org/projects/wp-plugins/weamp-cache-control-for-modpagespeed)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/weamp-cache-control-for-modpagespeed/),
check out the [SVN repository](https://plugins.svn.wordpress.org/weamp-cache-control-for-modpagespeed/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/weamp-cache-control-for-modpagespeed/)
by [RSS](https://plugins.trac.wordpress.org/log/weamp-cache-control-for-modpagespeed/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 0.1.0
* Initial release: Cache-Control headers for anonymous pages, purge on publish/
update/delete/comment/stock changes, ModPageSpeed 1.1 and 2.0 support with auto-
detection, setup wizard, WP-CLI commands.
## Meta
* Version **0.1.0**
* Last updated **2 days ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.0 or higher **
* Tested up to **7.0**
* PHP version ** 8.1 or higher **
* Tags
* [cache](https://wordpress.org/plugins/tags/cache/)[nginx](https://wordpress.org/plugins/tags/nginx/)
[optimization](https://wordpress.org/plugins/tags/optimization/)[page cache](https://wordpress.org/plugins/tags/page-cache/)
[performance](https://wordpress.org/plugins/tags/performance/)
* [Advanced View](https://wordpress.org/plugins/weamp-cache-control-for-modpagespeed/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/weamp-cache-control-for-modpagespeed/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/weamp-cache-control-for-modpagespeed/reviews/)
## Contributors
* [ oschaaf ](https://profiles.wordpress.org/oschaaf/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/weamp-cache-control-for-modpagespeed/)