Stale Content / Cache Issues #

If you’ve changed a PetMatchPro setting, updated a shortcode, or uploaded a new plugin version but don’t see the changes on your site, caching is likely the cause.

I Changed a Setting But Nothing Happened #

Follow these steps in order until the change appears:

Step 1: Hard Refresh Your Browser #

• Windows: Press Ctrl+Shift+R
• Mac: Press Cmd+Shift+R

This forces your browser to reload the page without using its local cache.

Step 2: Try Incognito/Private Mode #

Open the page in a private or incognito browser window. If the change appears here but not in your regular browser, it’s a browser cache issue — clearing your browser cache will fix it.

Step 3: Clear WordPress Cache Plugin #

If you use a caching plugin (WP Super Cache, W3 Total Cache, WP Rocket, etc.):

1. Go to the caching plugin’s settings.
2. Click Purge All Cache or Clear Cache.
3. Refresh your page.

Step 4: Clear LiteSpeed Cache #

If your host uses LiteSpeed:

1. Go to LiteSpeed Cache > Toolbox in your WordPress admin.
2. Click Purge All.
3. Refresh your page.

Step 5: Clear OPcache #

OPcache stores compiled PHP files. After a plugin update or settings change, stale compiled files may persist.

• Check your hosting control panel for an OPcache or PHP cache option
• Contact your host and ask them to clear OPcache or restart PHP-FPM

Step 6: Clear CDN Cache #

If you use a CDN (Cloudflare, StackPath, etc.):

1. Log into your CDN dashboard.
2. Purge the cache for your site (or specifically for the affected page URLs).
3. Wait 1–2 minutes for the purge to propagate.
4. Refresh your page.

Preventing Cache Issues #

Exclude Dynamic Pages #

PetMatchPro search pages with filters and detail pages display dynamic, per-request content. Consider excluding these pages from full-page caching:

• Add your search page URL to your caching plugin’s “Do Not Cache” list
• Add your detail page URL to the exclusion list
• Keep caching enabled for static pages (homepage, about, etc.)

Configure Cache Expiration #

If you prefer to keep PetMatchPro pages cached, set a short cache TTL (e.g., 5–15 minutes) so visitors see reasonably fresh animal data without excessive API calls.

After Plugin Updates #

When you upload a new version of PetMatchPro:

1. Clear OPcache (Step 5 above)
2. Clear your WordPress caching plugin cache (Step 3)
3. Clear CDN cache if applicable (Step 6)
4. Hard refresh in your browser (Step 1)

This ensures all layers of caching serve the updated files.

Next Steps #

• Performance & Caching — Optimize caching for PetMatchPro
• Animals Not Displaying — Full debug checklist