Prevent Browser Caching

Je hebt de site gewijzigd, maar een klant of bezoeker ziet nog de oude versie en jij moet zeggen “leeg je browsercache”? Deze plugin maakt dat gesprek overbodig.

Prevent Browser Caching zorgt dat browsers altijd de actuele versie van je site laden — zonder de browsercache uit te zetten en de site trager te maken.

Wat het doet

• CSS & JS versies. WordPress laadt bestanden met een “ver” parameter in de URL (bijvoorbeeld style.css?ver=4.9.6). Browsers houden het bestand in de cache totdat die parameter verandert. In de aanbevolen automatische modus stelt de plugin de versie in op basis van de wijzigingsdatum van het bestand zelf: de browsercache werkt volledig, en op het moment dat je een bestand updatet krijgt elke bezoeker het nieuwe.
• Afbeeldingsversies. Wanneer je een bestand in de Mediabibliotheek bewerkt of vervangt, krijgen bezoekers de nieuwe afbeelding in plaats van die uit de cache.
• HTML pagina actualiteit. Vraagt browsers om te controleren of er een nieuwere versie van een pagina is voordat ze een kopie uit de cache tonen — lost “ik zie op mijn telefoon nog steeds de oude pagina” op.
• One-click update. The “Update versions” toolbar button forces fresh copies of all assets for every visitor — and shows a short report of what exactly happened.
• Page cache stays in sync (opt-in). If a page-cache plugin is active, updating versions can also clear its cache — so cached HTML stops referencing the old file versions and every visitor sees the new site immediately. One checkbox turns it on, and after every update the plugin reports what was refreshed and what happened to the page cache. Works with WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, WP-Optimize, Breeze, Cache Enabler, Hummingbird, SiteGround Optimizer, Swift Performance and Comet Cache.
• Snellere herhaalbezoeken (optioneel, nieuw in 3.2). Omdat versies actualiteit garanderen, kan de plugin je statische bestanden veilig met browsercache headers van een jaar leveren — precies de oplossing voor de Lighthouse audit “Serve static assets with an efficient cache policy”. Hij schrijft de regels via de eigen .htaccess API van WordPress op Apache/LiteSpeed (bij deactivering weer verwijderd), toont een kant-en-klaar snippet voor nginx, en haalt dan echt een van je CSS bestanden op om te controleren of de headers echt werken — het resultaat staat op de instellingenpagina.
• Automatisch verversen na updates (optioneel, nieuw in 3.2). Updates van plugins, thema’s en WordPress wijzigen CSS en JS bestanden. Met deze optie wordt elke update — ook automatische achtergrondupdates — gevolgd door een versieverversing (en het opschonen van de paginacache als die optie aanstaat), zodat bezoekers na een update nooit een kapotte lay-out zien.
• CLI & AI agents. WP-CLI commando’s (wp pbc update, wp pbc status) en WordPress abilities laten deployscripts en AI agents de versies veilig updaten.

Standaard veilig

• Externe URL’s (betaalscripts, CDN’s, diensten van derden) blijven ongemoeid — sommige gaan stuk wanneer er een onverwachte “ver” parameter bijkomt. Je kunt versies voor externe URL’s met één selectievakje weer aanzetten.
• Specifieke bestanden (op een deel van de URL) of script- en stijl-handles kunnen van versies uitgesloten worden — CSS, JS en afbeeldingen allemaal.
• Als er een paginacache plugin actief is, stappen de headers voor HTML actualiteit automatisch opzij.
• Another plugin’s page cache is never cleared unless you enable that yourself — the purge-on-update integration is opt-in, and the report after every update tells you whether the page cache was cleared or left alone.
• De headers voor langdurige cache zijn ook optioneel, en alleen beschikbaar zolang CSS/JS versies aanstaan — de plugin laat browsers nooit bestanden een jaar vasthouden zonder een manier om ze te vernieuwen. De optie uitzetten (of de plugin deactiveren) verwijdert de regels volledig.

Updatemodi

• Automatisch, wanneer een bestand wijzigt (aanbevolen) — versie = wijzigingsdatum van het bestand. Nul klikken, volledige cache.
• Bij elke paginaweergave — ontwikkelmodus: CSS & JS worden nooit gecacht (afbeeldingen en pagina’s blijven ongemoeid). Gebruik dit alleen tijdens actieve ontwikkeling.
• Handmatig — versies veranderen alleen wanneer je op de knop “Versies updaten” drukt.

Voor ontwikkelaars

De aanbevolen manier om de CSS/JS versie via code in te stellen is de pbc_assets_version filter. Voeg dit toe aan het functions.php bestand van je thema en wijzig de waarde wanneer je de bestanden wilt updaten:

Omdat hij de eigen add_filter() van WordPress gebruikt, blijft hij veilig werken ook als de plugin ooit gedeactiveerd wordt — je site gaat niet stuk.

Filters voor fijnafstemming:

• pbc_skip_src( $skip, $src, $handle ) — geef true terug om de URL van een bepaald bestand ongemoeid te laten.
• pbc_assets_version( $ver, $src, $handle ) — wijzig de versie die op een bepaald bestand toegepast wordt.
• pbc_purge_page_cache( $purge, $plugin_name ) — geef false terug om het opschonen van de paginacache bij versie-updates te voorkomen.
• pbc_after_bump( $result ) — actie die afgaat na elke versie-update, met de nieuwe tijdstempel en de uitkomst van het opschonen.
• pbc_cache_policy_rules( $rules, $options ) — wijzig de gegenereerde regels voor langdurige cache voordat ze naar .htaccess geschreven (of als snippet getoond) worden.
• pbc_after_auto_bump( $context ) — action fired after an automatic post-update refresh, with the update type and the purge outcome.
• PBC_DISABLE_HTACCESS_WRITE — define this constant as true (e.g. in wp-config.php) and the plugin will never write to .htaccess itself; the settings page shows the rules for manual setup instead.

WP-CLI

• wp pbc update — updates the versions (and clears the detected page cache when the settings option is on). Add --skip-purge to leave the page cache alone for that run.
• wp pbc status — toont de modus, wat een versie krijgt, de laatste handmatige update en de gedetecteerde paginacache plugin. Ondersteunt --format=table|json|yaml.

Abilities (AI agents & automatisering)

Op WordPress 6.9+ registreert de plugin twee abilities, vindbaar via de Abilities API, REST en de MCP adapter — zo kunnen AI agents en tools voor sitebeheer de plugin bedienen zonder eigen koppelcode:

• prevent-browser-caching/bump-versions — update the versions; optional boolean input purge (set false to skip the page-cache purge).
• prevent-browser-caching/status — read-only report of the current configuration.

Beide vereisen de manage_options rechten.

Verouderd: eerdere versies documenteerden in plaats daarvan een prevent_browser_caching() functie. Die werkt nog precies zoals hiervoor — hij zet de beheerinstellingen van de plugin uit en geeft je volledige controle — maar ik raad de filter hierboven aan: een kale functieaanroep in functions.php veroorzaakt een fatale fout als de plugin ooit gedeactiveerd wordt. Blijf je de functie gebruiken, bescherm hem dan:

Bedankt

Many of the recent improvements started as reports and questions in the support forum — thank you to everyone who took the time to describe a problem or share an idea. If something doesn’t work as expected on your site, please open a topic there: it genuinely helps make the plugin better for everyone.