Omega Performance Engine — Troubleshooting Guide

Version 1.3.0 Omega Web Apps omegawebapps.com

This guide covers common issues and safe recovery steps when using Omega Performance Engine on production WordPress sites.

5. Troubleshooting

5.1 Layout Issues After Activation

If your layout looks incorrect or elements shift unexpectedly:

• Clear plugin cache (WP Rocket, LiteSpeed, W3TC, etc.).
• Clear server cache (LiteSpeed, NGINX FastCGI, hosting cache).
• Clear CDN cache (Cloudflare, Bunny, Fastly).
• Ensure no other optimization plugin is stripping assets.

5.2 Missing CSS or JavaScript

This usually occurs when another plugin is aggressively removing assets.

• Disable minification/combination in caching plugins.
• Ensure your theme’s CSS is not being deferred by another tool.
• Switch back to Default Mode and test again.

5.3 WooCommerce Checkout Problems

If checkout fields or buttons behave incorrectly:

• Switch to Default Mode.
• Clear all caches.
• Disable duplicate optimizations in caching plugins.
• Ensure no plugin is deferring WooCommerce scripts.

5.4 Aggressive Mode Causing Issues

If enabling Aggressive Mode breaks a page:

• Switch back to Default Mode.
• Clear cache.
• Reload the affected page.

Aggressive Mode is optional and should be tested per site.

5.5 Conflicts With Other Optimization Plugins

Disable overlapping features in:

• WP Rocket
• LiteSpeed Cache
• W3 Total Cache
• Autoptimize
• Asset CleanUp

Common conflicts include:

• Duplicate minification
• Duplicate CSS/JS removal
• Deferred scripts being deferred twice

5.6 CDN or Proxy Issues

If changes don’t appear:

• Purge Cloudflare cache
• Purge hosting cache
• Purge plugin cache

5.7 White Screen or Fatal Error

Extremely rare, but if it happens:

1. Log in via FTP or File Manager.
2. Navigate to /wp-content/plugins/.
3. Rename the plugin folder to omega-performance-engine-disabled.
4. WordPress will automatically deactivate it.

5.8 Nothing Seems to Change After Activation

This is almost always due to caching:

• Clear plugin cache
• Clear server cache
• Clear CDN cache
• Test in an incognito window

5.9 Slow Backend or Admin Panel

Omega Performance Engine does not modify admin performance. If the backend is slow:

• Check for heavy admin plugins
• Disable unused plugins
• Check hosting CPU/RAM limits

5.10 Safe Rollback

To instantly undo all changes:

Deactivate the plugin.