68c3423f50
Phase 1: Core Documentation
- Created docs/ folder with 8 markdown documentation files
- Getting Started, Installation, Troubleshooting, FAQ
- Configuration docs (Appearance, SPA Mode)
- Feature docs (Shop, Checkout)
- PHP registry with filter hook for addon extensibility
Phase 2: Documentation Viewer
- DocsController.php with REST API endpoints
- GET /woonoow/v1/docs - List all docs (with addon hook)
- GET /woonoow/v1/docs/{slug} - Get document content
- Admin SPA /help route with sidebar navigation
- Markdown rendering with react-markdown
- Added Help & Docs to More page for mobile access
Filter Hook: woonoow_docs_registry
Addons can register their own documentation sections.
3.5 KiB
Troubleshooting
Common issues and their solutions.
Blank Pages
Symptom
WooCommerce pages (shop, cart, checkout) show blank content.
Solutions
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
Symptom
Visiting /store/shop or /store/product/... shows a 404 error.
Solutions
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
Symptom
Products show placeholder images instead of actual images.
Solutions
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
Symptom
SPA feels slow or laggy.
Solutions
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
Symptom
Checkout page won't load or payment fails.
Solutions
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
Symptom
Order confirmation emails not being received.
Solutions
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
Symptom
WooNooW doesn't work after installing another plugin.
Steps to Diagnose
- Deactivate other plugins one by one
- Switch to default theme (Twenty Twenty-Three)
- Check error logs in
wp-content/debug.log
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:
-
Collect Information
- WordPress version
- WooCommerce version
- WooNooW version
- PHP version
- Error messages (from debug.log)
-
Enable Debug Mode Add to
wp-config.php:define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); -
Contact Support Provide the collected information for faster resolution.