Common Issues and Solutions

This comprehensive troubleshooting guide addresses the most frequently encountered issues with ZiziCache and provides step-by-step solutions to resolve them quickly and effectively.

Cache-Related Issues

Cache Not Working

Symptoms

• Page loading times haven’t improved
• No cache files generated in wp-content/cache/
• Performance metrics show no cache hits
• Cache status shows as disabled

Solutions

1. Check Cache Enable Setting:
   • Navigate to ZiziCache � Caching
   • Ensure “Enable page cache” is checked
   • Save settings and test
2. Verify Directory Permissions:

      # Check wp-content/cache directory permissions
      ls -la wp-content/cache/
      # Set correct permissions if needed
      chmod 755 wp-content/cache/
      chown www-data:www-data wp-content/cache/
      

3. Clear Existing Cache:

   wp zizi-cache purge-everything

   Then manually trigger preload:

   wp zizi-cache preload-cache

4. Check for Plugin Conflicts:
   • Deactivate other caching plugins
   • Disable conflicting optimization plugins temporarily
   • Test cache functionality

Cache Files Not Updating

Symptoms

• Content changes not visible on frontend
• Old cached versions persist
• Manual cache clear doesn’t work

Solutions

1. Force Cache Purge:

   wp zizi-cache purge-everything

2. Check Cache Lifetime Settings:
   • Go to ZiziCache � Caching
   • Review cache lifetime configuration
   • Consider shorter cache periods for dynamic content
3. Verify Cache Exclusions:
   • Check if URLs are excluded from caching
   • Review cookie-based exclusions
   • Ensure proper cache bypass rules

Preload Process Issues

Symptoms

• Preload process stalls or fails
• Incomplete cache generation
• High server load during preload

Solutions

1. Check Server Resources:
   • Monitor CPU and memory usage
   • Ensure adequate server resources
   • Consider preload during off-peak hours
2. Adjust Preload Settings:
   • Reduce concurrent preload requests
   • Increase delays between requests
   • Limit preload to essential pages
3. Use CLI for Large Sites:

   wp zizi-cache preload-cache --debug

Optimization Issues

CSS/JavaScript Minification Problems

Symptoms

• Broken website layout
• JavaScript errors in console
• Missing styles or functionality

Solutions

1. Disable Minification Temporarily:
   • Go to ZiziCache � Optimization
   • Uncheck CSS/JS minification
   • Test site functionality
2. Add Exclusions:
   • Identify problematic files
   • Add them to exclusion lists
   • Re-enable minification
3. Clear Optimized Files:

   wp zizi-cache purge-everything

Font Optimization Issues

Symptoms

• Fonts not loading properly
• Flash of Unstyled Text (FOUT)
• Slow font loading

Solutions

1. Check Font Intelligence:
   • Go to ZiziCache � Optimization � Font Optimization
   • Verify Font Intelligence is enabled
   • Run font analysis refresh
2. Verify Font Preload Settings:
   • Check preload font URLs
   • Ensure correct font file paths
   • Validate font-display settings
3. Test Font Loading:
   • Use browser dev tools Network tab
   • Check for 404 errors on font files
   • Verify font MIME types

Image Lazy Loading Problems

Symptoms

• Images not loading when scrolled into view
• JavaScript errors related to lazy loading
• Images showing as broken

Solutions

1. Check Browser Compatibility:
   • Test in different browsers
   • Verify JavaScript support
   • Check for browser extensions blocking scripts
2. Adjust Lazy Loading Settings:
   • Increase threshold distance
   • Exclude above-the-fold images
   • Add problematic images to exclusions
3. Debug Lazy Loading:
   • Enable browser console logging
   • Check for JavaScript errors
   • Verify intersection observer support

Performance Issues

Slow Database Performance

Symptoms

• High database query counts
• Slow page load times
• Database timeout errors

Solutions

1. Use Database Cleanup:
   • Go to ZiziCache � Database
   • Run manual cleanup for revisions, spam, transients
   • Enable scheduled cleanup
2. Optimize Database Tables:

   wp zizi-cache database-optimize

3. Implement Index Recommendations:
   • Check Database � Index Recommendations
   • Apply suggested database indexes
   • Monitor performance improvement
4. Enable Object Caching:
   • Install Redis or Memcached
   • Configure object cache
   • Test with: wp zizi-cache object-cache-flush

High Memory Usage

Symptoms

• PHP memory limit errors
• Site crashes during high traffic
• Performance metrics showing memory issues

Solutions

1. Increase PHP Memory Limit:

      # In wp-config.php
      ini_set('memory_limit', '256M');
      # Or in .htaccess
      php_value memory_limit 256M
      

2. Optimize Resource Usage:
   • Enable aggressive caching
   • Disable unnecessary optimizations
   • Limit concurrent processes
3. Monitor Memory Usage:
   • Use Performance Metrics dashboard
   • Track memory usage patterns
   • Identify memory-intensive operations

Plugin Conflicts

Common Conflicting Plugins

Other Caching Plugins

• WP Rocket: Disable if using ZiziCache
• W3 Total Cache: Conflicts with page caching
• WP Super Cache: Duplicate caching functionality
• LiteSpeed Cache: Server-level cache conflicts

Optimization Plugins

• Autoptimize: CSS/JS optimization conflicts
• WP Optimize: Database optimization overlap
• Smush: Image optimization conflicts
• Async JavaScript: Script loading conflicts

Conflict Resolution Steps

1. Identify Conflicts:
   • Deactivate suspected plugins one by one
   • Test ZiziCache functionality after each deactivation
   • Document which plugins cause issues
2. Configure Compatibility:
   • Disable overlapping features in conflicting plugins
   • Use ZiziCache’s plugin integration settings
   • Configure exclusions for conflicting functionality
3. Replace Conflicting Plugins:
   • Consider removing redundant optimization plugins
   • Use ZiziCache’s comprehensive optimization features
   • Maintain only essential non-conflicting plugins

Server Configuration Issues

Apache Configuration

Htaccess Issues

• Rewrite Rules Conflicts:
  • Check for conflicting rewrite rules
  • Ensure ZiziCache rules load first
  • Test htaccess syntax validity
• Cache Headers:
  • Verify cache control headers
  • Check for conflicting expires headers
  • Ensure proper MIME type configuration

Nginx Configuration

Cache Rules

• Location Blocks:

     location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg)$ {
         expires 1y;
         add_header Cache-Control "public, immutable";
     }
     

• Cache Bypass:

     location / {
         try_files /wp-content/cache/$uri/index.html $uri $uri/ /index.php?$args;
     }
     

PHP Configuration

OPcache Settings

opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.revalidate_freq=2

Memory and Execution Limits

memory_limit = 256M
max_execution_time = 300
max_input_vars = 3000

Debugging Tools and Techniques

Enable Debug Mode

WordPress Debug

# In wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

ZiziCache Debug

• Enable verbose logging in plugin settings
• Monitor debug log: wp-content/debug.log
• Use CLI debug mode: wp zizi-cache preload-cache --debug

Performance Testing Tools

Browser Tools

• Chrome DevTools: Network, Performance, Console tabs
• Firefox Developer Tools: Network Monitor, Performance panel
• Safari Web Inspector: Timeline and Network tabs

External Testing Tools

• GTmetrix: Comprehensive performance analysis
• Google PageSpeed Insights: Core Web Vitals assessment
• WebPageTest: Detailed waterfall analysis
• Pingdom: Performance monitoring and alerts

Log Analysis

Error Logs

• PHP Error Log: Check for PHP errors and warnings
• WordPress Debug Log: Monitor plugin-specific issues
• Server Error Log: Apache/Nginx error documentation

Performance Logs

• Slow Query Log: Identify database bottlenecks
• Access Logs: Traffic pattern analysis
• Cache Logs: Cache hit/miss statistics

Recovery Procedures

Emergency Cache Disable

Quick Disable via File

# Create disable file
touch wp-content/cache/zizi-cache-disabled.txt
# Or via FTP/cPanel
# Upload empty file named 'zizi-cache-disabled.txt' to wp-content/cache/

Database Disable

# Via WP-CLI

wp option update zizi_cache_settings '{enableCache":false}'