|
Applies to: WordPress Plugin Where: WP Admin > Settings tab > Technical Settings |
Overview
Caching plugins improve your site’s performance by serving pre-built HTML pages to visitors. However, caching can interfere with the consent banner’s script injection — visitors may see a cached page that does not include the latest banner configuration or autoblocking modifications.
Compliance by Hu-manity.co includes a Caching compatibility toggle that activates integration modules for popular caching plugins, ensuring the consent banner works correctly with cached pages.
What the Caching Compatibility Toggle Does
When enabled, the plugin:
- Detects active caching plugins on your site automatically.
- Loads compatibility modules specific to each detected caching plugin. These modules hook into the caching plugin’s output pipeline to ensure the consent banner script and autoblocking modifications are included in cached pages.
- Adjusts script injection timing so the consent widget (
hu-banner.min.js) is properly inserted even when pages are served from cache.
The toggle is enabled by default for new installations.
Supported Caching Plugins
The following caching plugins have dedicated compatibility modules:
| Caching Plugin | Supported |
|---|---|
| Autoptimize | Yes |
| Breeze (Cloudways) | Yes |
| Hummingbird (WPMU DEV) | Yes |
| LiteSpeed Cache | Yes |
| Speed Optimizer (SiteGround) | Yes |
| SpeedyCache | Yes |
| WP Fastest Cache | Yes |
| WP-Optimize | Yes |
| WP Rocket | Yes |
| WP Super Cache | Yes |
How to Enable Caching Compatibility
- Go to
WP Admin → Compliance by Hu-manity.co → Settings tab. - Scroll to the Technical Settings section.
- Toggle Caching compatibility to on.
- Click Save Changes.
The plugin automatically detects which supported caching plugins are active and loads the appropriate compatibility modules. No additional configuration is needed.
When to Enable This Setting
Enable Caching compatibility if:
- You use any of the supported caching plugins listed above.
- Your hosting provider has a built-in page cache (e.g., SiteGround, Cloudways, WP Engine, Kinsta, Flywheel).
- You use a CDN that caches full HTML pages (e.g., Cloudflare APO, StackPath).
- Your consent banner is not appearing on some pages but works on others (symptom of cached vs. uncached pages).
Hosting-Level Page Caches
Some managed WordPress hosts (WP Engine, Kinsta, Flywheel, Pressable) use server-level page caching that operates outside of WordPress plugins. The Caching compatibility toggle addresses WordPress-plugin-level caching. For server-level caches:
- Purge the host’s page cache after activating or reconfiguring the plugin.
- If using Cloudflare with full-page caching (APO), purge the Cloudflare cache as well.
- Ensure the consent banner script is not excluded from cached pages by the host’s caching rules.
After Enabling: Purge Your Cache
After enabling or disabling Caching compatibility (or after making any banner configuration change), always purge your site’s cache so visitors receive fresh pages with the updated banner configuration:
- Go to your caching plugin’s settings and click its Purge or Clear Cache button.
- If your hosting provider has a separate cache, purge that as well.
- Test by opening your site in an incognito/private browser window.
Compatibility with Consent-Aware Plugins
The Caching compatibility toggle covers cached HTML. Some plugins on your site also gate their own behaviour on consent — separately from anything in the cached HTML. Compliance by Hu-manity.co talks to those plugins through the WP Consent API integration (available from v3.1.0).
When the WP Consent API plugin is installed alongside Compliance, the following plugins read your banner’s consent decisions automatically — no per-plugin snippets, no caching plugin involved:
- WooCommerce (analytics + marketing pixels)
- Google Site Kit (GA4, Ads, Tag Manager)
- Burst Statistics (cookie vs cookieless mode)
- WP Statistics
- Pixel Manager for WooCommerce
- AddToAny
- AFL UTM Tracker
Toggle the integration on or off at Settings tab → Configuration → WP Consent API. The toggle is on by default once both plugins are detected, and disabled (greyed out) when the WP Consent API plugin is not installed. See WP Consent API Integration for the full reference.
For social-feed plugins, see Smash Balloon Compatibility. Smash Balloon Instagram and Twitter feeds are handled by a native bridge inside the banner; Facebook and YouTube feeds need the legacy-cookie bridge snippet.
Troubleshooting
Banner appears inconsistently (some pages yes, some no)
This is the classic symptom of a page cache serving stale HTML. Purge the cache and verify Caching compatibility is enabled.
Banner appears but autoblocking does not work on cached pages
Autoblocking modifies script tags in the HTML output. If a cached page was generated before autoblocking was enabled, it still contains the original unmodified script tags. Purge the cache completely after enabling autoblocking.
Caching compatibility is enabled but not taking effect
The compatibility modules only load when the plugin status is Active (connected to your Hu-manity.co account). If the plugin is not connected, caching compatibility modules are skipped. Verify your plugin connection status first.
Using a caching plugin not in the supported list
If your caching plugin is not listed above, the Caching compatibility toggle will not have a dedicated module for it. In most cases the banner will still work because it is injected via standard WordPress hooks. If you experience issues, contact support with your caching plugin name and the symptoms you observe.