# Testing WP Recache (manual)

Environment: Docker (`docker-compose up -d`), or any WP ≥ 5.8 + PHP ≥ 7.4 install with the plugin symlinked into `wp-content/plugins/`.

## Activation

1. Activate the plugin.
2. Check `wp-config.php` contains `define('WP_CACHE', true); // Added by WP Recache.`
3. Check these files exist:
   - `wp-content/advanced-cache.php`
   - `wp-content/wp-recache-cache.php`
   - `wp-content/cache/wp-recache/.htaccess` + `index.php`

## Core cache (issue #1 stories 1, 11, 12)

4. Anonymous visit (incognito) to a page twice:
   - 1st: response header `X-WP-Recache: MISS`, file `md5(host + path) . '.html'` appears in `wp-content/cache/wp-recache/`.
   - 2nd: `X-WP-Recache: HIT` (via WP) or `X-WP-Recache-Dropin: 1` (served before WP loaded).
5. Same URL with `?utm_source=test`: always MISS, no new cache file (query strings bypass).
6. Define `DONOTCACHEPAGE` on a page (e.g. in a must-use plugin): page never cached.
7. Logged-in visit: no `X-WP-Recache` headers, nothing cached (logged-in cookie also bypasses the drop-in).

## Exclusions (stories 4–6)

8. Settings → Cache → Exclude URLs: add `/about`, save, visit `/about` twice → never cached.
9. Default exclusions: `/cart`, `/checkout`, `/my-account` never cached.
10. Feeds (`/feed/`) and 404 pages: no `X-WP-Recache` MISS header, no cache file.

## Purge (stories 2, 3)

11. Edit a published post → its cache file and the homepage file are deleted.
12. Add a comment to a post → that post's cache file is deleted (not the comment ID's).
13. Admin bar → WP Recache → Purge All Cache (works on every admin page AND on the front-end admin bar, not just the settings page) → cache dir emptied.
14. Settings → Advanced → Purge All Cache button → same result.
15. Heartbeat purge: `wp.heartbeat.send('wp_recache_purge', 1)` in browser console on an admin page → next heartbeat tick purges all (check response `wp_recache_purged`).

## Mobile (story 7)

16. Enable "Separate Mobile Cache", visit once with a mobile UA (`curl -A "iPhone"`), once desktop → two files: `*-mobile.html`, `*-desktop.html`.
17. With mobile cache ON, the drop-in does not serve (falls through to WP path) — expected.

## Stats (story 9)

18. Settings → Cache → Cache Statistics shows file count and size matching `wp-content/cache/wp-recache/`.

## Multisite (story 10)

19. On a network: same path on two sites produces two different files (host+path in key). Purge on one site must not touch the other.

## Deactivation / uninstall

20. Deactivate: `advanced-cache.php`, `wp-recache-cache.php` removed, `WP_CACHE` marker line removed from `wp-config.php`.
21. If another plugin's `advanced-cache.php` exists (no "WP Recache" marker), deactivation must NOT delete it.
22. Uninstall: options deleted, `wp-content/cache/wp-recache/` removed.

## Automated

- `composer test` (PHPUnit, needs WP test suite via docker-compose).
- `composer phpstan`, `composer lint`.

## Known ceilings

- Drop-in ignores `cache_duration` TTL (no WP available to read the option); freshness relies on purge-on-update. Files are never served stale for edited content, only for TTL-based expiry.
- Preload toggle (story 8) has no crawler implementation yet.
- Purge on publish clears only the post + homepage; archives/taxonomy pages expire via TTL.