OptiCache Conflict Detection
=============================

OptiCache automatically detects plugins, themes, and hosting
environments that may conflict with its optimization features.


CACHING PLUGINS (High Severity)
-------------------------------
These plugins provide overlapping functionality and should
typically be disabled when using OptiCache.

W3 Total Cache
  Features: Page cache, browser cache, minify, GZIP

WP Super Cache
  Features: Page cache

WP Fastest Cache
  Features: Page cache, minify, GZIP, browser cache

LiteSpeed Cache
  Features: Page cache, minify, browser cache, GZIP

Cache Enabler
  Features: Page cache

WP Rocket
  Features: Page cache, minify, defer JS, browser cache, GZIP

SG Optimizer
  Features: Page cache, minify, GZIP

Breeze
  Features: Page cache, minify, GZIP

Hummingbird
  Features: Page cache, minify, GZIP, browser cache

Swift Performance
  Features: Page cache, minify, GZIP

Comet Cache
  Features: Page cache

Solid Performance
  Features: Page cache

Airlift
  Features: Page cache, minify, GZIP

Borlabs Cache
  Features: Page cache, minify

FastPixel Caching
  Features: Page cache, minify

FlyingPress
  Features: Page cache, minify, defer JS, GZIP

Hyper Cache
  Features: Page cache

NitroPack
  Features: Page cache, minify, defer JS, lazy load, GZIP

SpeedyCache
  Features: Page cache, minify, GZIP

10Web Booster
  Features: Page cache, minify, lazy load

LWS Optimize
  Features: Page cache, minify, GZIP

Super Page Cache
  Features: Page cache


OBJECT CACHE PLUGINS (High Severity)
------------------------------------
These plugins conflict with OptiCache object caching.
Use only one object cache solution.

Docket Cache
  Features: Object cache

Redis Object Cache
  Features: Object cache
  Note: OptiCache includes Redis object caching.
        Disable this plugin to avoid conflicts.

Nginx Helper
  Features: Page cache (server-level)

Varnish HTTP Purge
  Features: Page cache (server-level)


OPTIMIZATION PLUGINS (Medium/Low Severity)
------------------------------------------
These plugins may conflict with specific OptiCache features.
Disable overlapping features in one or the other.

Autoptimize
  Features: Minify, combine

Async JavaScript
  Features: Defer JS, async JS

Fast Velocity Minify
  Features: Minify, combine

Minify HTML
  Features: HTML minification

Flying Scripts
  Features: Defer JS

Perfmatters
  Features: Defer JS, delay JS, minify, lazy load, unused CSS removal, disable emojis,
            script manager, local analytics
  Note: OptiCache includes equivalent optimization features. Disable
        overlapping features in Perfmatters or OptiCache.

WP-Optimize
  Features: Minify, page cache

Clearfy
  Features: Minify

Clearfy
  Features: Minify, disable emojis, security hardening, XML-RPC disable
  Note: OptiCache includes equivalent optimization and hardening
        features. Disable overlapping features in one or the other.

WP OPcache
  Features: OPcache management
  Note: OptiCache includes OPcache management. You can safely
        disable WP OPcache.

Headers Security Advanced & HSTS WP
  Features: Security headers
  Note: OptiCache includes equivalent security headers. Disable
        this plugin if using OptiCache's Security Headers option.

Jetpack
  Features: Lazy load, image CDN, asset CDN
  Note: Disable Site Accelerator in Jetpack > Settings > Performance
        if using OptiCache lazy loading.


THEMES WITH BUILT-IN OPTIMIZATION
---------------------------------

Avada Theme
  Location: Avada > Performance
  Detects these features when enabled:
    - JS Compiler
    - CSS Compiling
    - Async Media Queries
    - jQuery in Footer
    - GZIP Compression
    - Lazy Loading
    - Defer Scripts
    - Async Scripts
    - Font Preloading
    - Font Display Swap
    - Disable Emojis
  After disabling: Click "Reset Avada Caches" button and save to fully remove conflicts.

Divi Theme
  Location: Divi > Theme Options > Performance
  Detects these features when enabled:
    - Minify and Combine Scripts
    - Minify and Combine Styles
    - Defer Scripts

BeTheme
  Location: BeTheme > Theme Options > Performance
  Detects these features when enabled:
    - CSS Minification
    - JS Minification
    - CSS Combination
    - JS Combination
    - Lazy Loading
    - Async JavaScript
    - Local Google Fonts

The7 Theme
  Location: Theme Options > Performance
  Detects these features when enabled:
    - Lazy Loading
    - Custom JS/CSS
    - Fast Velocity Minify Integration
  Note: The7 recommends FVM for asset optimization. Disable FVM
        if using OptiCache minification features.

Astra Theme
  Location: Customizer > Performance
  Detects these features when enabled:
    - Local Google Fonts
    - Font Preloading
  Note: Lightweight theme, generally compatible with OptiCache.

GeneratePress Theme
  Location: Customizer > General > Performance
  Detects these features when enabled:
    - Combine CSS (Premium)
  Note: Lightweight theme, generally compatible with OptiCache.

Kadence Theme
  Location: Customizer > Performance
  Detects these features when enabled:
    - Local Fonts
  Note: Check Performance settings for optimization features.

Hello Elementor Theme
  Note: Lightweight starter theme with minimal optimization
        features. Generally compatible with OptiCache.

Blocksy Theme
  Location: Customizer > Performance
  Detects these features when enabled:
    - Lazy Loading
  Note: Check Customizer for performance options.

OceanWP Theme
  Location: Theme Panel > Scripts & Styles
  Detects these features when enabled:
    - Minify JS
    - Minify CSS
  Note: Requires Ocean Extra plugin for full optimization features.

Neve Theme
  Location: Customizer > Performance
  Detects these features when enabled:
    - Local Google Fonts (Pro)
  Note: Lightweight theme, generally compatible with OptiCache.

Salient Theme
  Location: Theme Options > General Settings > Performance
  Detects these features when enabled:
    - Delay Javascript Execution
    - Load Google Fonts Locally
    - Lazy Load Page Builder Element Images
    - Move jQuery to Footer
    - Font Display Swap
    - Remove Block Editor (Gutenberg) CSS
    - Remove Global Font Awesome
    - Remove WordPress Emoji Script/CSS
  Note: Salient has extensive built-in performance features.
        Disable overlapping features in Salient or OptiCache.

Customizr Theme
  Location: Customizer > Advanced Options > Website Performances
  Detects these features when enabled:
    - Minified CSS Stylesheet
    - Load Images on Scroll (Lazy Load)
  Note: Check Advanced Options > Website Performances for
        optimization settings.

X Theme / Pro Theme (Themeco)
  Location: Assets are pre-minified; Cornerstone handles asset splitting
  Detects: Theme presence, Cornerstone page builder
  Note: X Theme and Pro come pre-minified with Cornerstone builder
        splitting CSS per element. Do not double-minify assets.
        Exclude Cornerstone scripts from JS/CSS combination.
        Test CSS/JS optimization carefully.


PAGE BUILDERS (Warnings)
------------------------
These may require careful testing with CSS/JS optimization.

Elementor / Elementor Pro
  Detects: Optimized Asset Loading, CSS Loading experiments
  Note: Test CSS/JS combination carefully

WPBakery Page Builder
  Note: Some components may break with CSS/JS combination

Oxygen Builder
  Note: Has its own asset handling - test carefully

Cornerstone (Themeco)
  Note: Part of X Theme and Pro Theme. Has its own asset handling
        and splits CSS per element. Exclude Cornerstone assets from
        JS/CSS combination and minification to avoid builder conflicts.


HOSTING ENVIRONMENTS (Warnings)
-------------------------------
Some hosts have built-in caching that may conflict.

WP Engine
  Note: Has built-in page caching. Consider disabling
        OptiCache page caching.

Cloudflare
  Note: Coordinate cache headers and browser caching
        settings between Cloudflare and OptiCache.

SiteGround
  Note: SuperCacher detected. Consider using SG Optimizer
        for full compatibility.

Kinsta
  Note: Has built-in page caching. Disable OptiCache
        page caching.

Flywheel
  Note: Has built-in caching. Consider disabling
        OptiCache page caching.


HOW IT WORKS
------------
OptiCache checks for these conflicts on admin pages and
displays warnings on the Status tab. When conflicts are
detected, you'll see recommendations for which features
to disable in either OptiCache or the conflicting plugin/theme.


RECOMMENDATIONS
---------------
1. Disable duplicate features - Don't run two minifiers
   or two page caches simultaneously

2. Check theme settings - Many premium themes have
   performance options that overlap with OptiCache

3. Hosting cache - If your host provides caching,
   consider disabling OptiCache page cache

4. Test thoroughly - After disabling conflicts,
   test your site for any issues
