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.
174 lines
3.5 KiB
Markdown
174 lines
3.5 KiB
Markdown
# 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
|
|
|
|
1. **Deactivate other plugins** one by one
|
|
2. **Switch to default theme** (Twenty Twenty-Three)
|
|
3. **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:
|
|
|
|
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.
|