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:
    php
    define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
  3. Contact Support
    • Provide the collected information for faster resolution.

Last updated Jan 31, 2024