Troubleshooting

Common issues and their solutions

Blank Pages

WooCommerce pages (shop, cart, checkout) show blank content.

1

Check SPA Mode Setting

  • Go to WooNooW → Appearance → General
  • Ensure SPA Mode is set to "Full"
  • If you want native WooCommerce, set to "Disabled"
2

Flush Permalinks

  • Go to Settings → Permalinks
  • Click Save Changes (no changes needed)
  • This refreshes rewrite rules
3

Clear Cache

  • If using a caching plugin:
  • Clear page cache
  • Clear object cache
  • Purge CDN cache (if applicable)

404 Errors on SPA Routes

Visiting /store/shop or /store/product/... shows a 404 error.

1

Flush Permalinks

  • Go to Settings → Permalinks
  • Click Save Changes
2

Check Store Page Exists

  • Go to Pages
  • Verify "Store" page exists and is published
  • The page should contain [woonoow_spa] shortcode
3

Check SPA Page Setting

  • Go to WooNooW → Appearance → General
  • Ensure SPA Page is set to the Store page

Product Images Not Loading

Products show placeholder images instead of actual images.

1

Regenerate Thumbnails

  • Install "Regenerate Thumbnails" plugin
  • Run regeneration for all images
2

Check Image URLs

  • Ensure images have valid URLs
  • Check for mixed content (HTTP vs HTTPS)

Slow Performance

SPA feels slow or laggy.

1

Enable Caching

  • Install a caching plugin (WP Super Cache, W3 Total Cache)
  • Enable object caching (Redis/Memcached)
2

Optimize Images

  • Use WebP format
  • Compress images before upload
  • Use lazy loading
3

Check Server Resources

  • Upgrade hosting if on shared hosting
  • Consider VPS or managed WordPress hosting

Checkout Not Working

Checkout page won't load or payment fails.

1

Check Payment Gateway

  • Go to WooCommerce → Settings → Payments
  • Verify payment method is enabled
  • Check API credentials
2

Check SSL Certificate

  • Checkout requires HTTPS
  • Verify SSL is properly installed
3

Check for JavaScript Errors

  • Open browser Developer Tools (F12)
  • Check Console for errors
  • Look for blocked scripts

Emails Not Sending

Order confirmation emails not being received.

1

Check Email Settings

  • Go to WooNooW → Settings → Notifications
  • Verify email types are enabled
2

Check WordPress Email

  • Test with a plugin like "Check & Log Email"
  • Consider using SMTP plugin (WP Mail SMTP)
3

Check Spam Folder

  • Emails may be in recipient's spam folder
  • Add sender to whitelist

Plugin Conflicts

WooNooW doesn't work after installing another plugin.

1

Steps to Diagnose

  • Deactivate other plugins one by one
  • Switch to default theme (Twenty Twenty-Three)
  • Check error logs in wp-content/debug.log
2

Check WordPress Email

  • Test with a plugin like "Check & Log Email"
  • Consider using SMTP plugin (WP Mail SMTP)
3

Common Conflicting Plugins

  • Other WooCommerce template overrides
  • Page builder plugins (sometimes)
  • Heavy caching plugins (misconfigured)

Getting More Help

If you can't resolve the issue:

1

Collect Information

  • WordPress version
  • WooCommerce version
  • WooNooW version
  • PHP version
  • Error messages (from debug.log)
2

Enable Debug Mode

  • Add to wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
3

Contact Support

  • Provide the collected information for faster resolution.

Published on Jul 16, 1936