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.
150 lines
3.8 KiB
Markdown
150 lines
3.8 KiB
Markdown
# Frequently Asked Questions
|
|
|
|
Quick answers to common questions about WooNooW.
|
|
|
|
---
|
|
|
|
## General
|
|
|
|
### What is WooNooW?
|
|
|
|
WooNooW is a WooCommerce plugin that transforms your store into a modern Single Page Application (SPA). It provides instant page loads, a beautiful UI, and seamless shopping experience.
|
|
|
|
### Do I need WooCommerce?
|
|
|
|
Yes. WooNooW is an enhancement layer for WooCommerce. You need WooCommerce installed and activated.
|
|
|
|
### Will WooNooW affect my existing products?
|
|
|
|
No. WooNooW reads from WooCommerce. Your products, orders, and settings remain untouched.
|
|
|
|
---
|
|
|
|
## SPA Mode
|
|
|
|
### What's the difference between Full and Disabled mode?
|
|
|
|
| Mode | Behavior |
|
|
|------|----------|
|
|
| **Full** | All WooCommerce pages redirect to SPA. Modern, fast experience. |
|
|
| **Disabled** | WooCommerce pages use native templates. WooNooW admin still works. |
|
|
|
|
### Can I switch modes anytime?
|
|
|
|
Yes. Go to **WooNooW → Appearance → General** and change the SPA Mode. Changes take effect immediately.
|
|
|
|
### Which mode should I use?
|
|
|
|
- **Full**: For the best customer experience with instant loads
|
|
- **Disabled**: If you have theme customizations you want to keep
|
|
|
|
---
|
|
|
|
## Compatibility
|
|
|
|
### Does WooNooW work with my theme?
|
|
|
|
WooNooW's SPA is independent of your WordPress theme. In Full mode, the SPA uses its own styling. Your theme affects the rest of your site normally.
|
|
|
|
### Does WooNooW work with page builders?
|
|
|
|
The SPA pages are self-contained. Page builders work on other pages of your site.
|
|
|
|
### Which payment gateways are supported?
|
|
|
|
WooNooW supports all WooCommerce-compatible payment gateways:
|
|
- PayPal
|
|
- Stripe
|
|
- Bank Transfer (BACS)
|
|
- Cash on Delivery
|
|
- And more...
|
|
|
|
---
|
|
|
|
## SEO
|
|
|
|
### Is WooNooW SEO-friendly?
|
|
|
|
Yes. WooNooW uses:
|
|
- Clean URLs (`/store/product/product-name`)
|
|
- Dynamic meta tags for social sharing
|
|
- Proper redirects (302) from WooCommerce URLs
|
|
|
|
### What about my existing SEO?
|
|
|
|
WooCommerce URLs remain the indexed source. WooNooW redirects users to the SPA but preserves SEO value.
|
|
|
|
### Will my product pages be indexed?
|
|
|
|
Yes. Search engines index the WooCommerce URLs. When users click from search results, they're redirected to the fast SPA experience.
|
|
|
|
---
|
|
|
|
## Performance
|
|
|
|
### Is WooNooW faster than regular WooCommerce?
|
|
|
|
Yes, for navigation. After the initial load, page transitions are instant because the SPA doesn't reload the entire page.
|
|
|
|
### Will WooNooW slow down my site?
|
|
|
|
The initial load is similar to regular WooCommerce. Subsequent navigation is much faster.
|
|
|
|
### Does WooNooW work with caching?
|
|
|
|
Yes. Use page caching and object caching for best results.
|
|
|
|
---
|
|
|
|
## Customization
|
|
|
|
### Can I customize colors and fonts?
|
|
|
|
Yes. Go to **WooNooW → Appearance** to customize:
|
|
- Primary, secondary, and accent colors
|
|
- Body and heading fonts
|
|
- Logo and layout options
|
|
|
|
### Can I add custom CSS?
|
|
|
|
Currently, use your theme's Additional CSS feature. A custom CSS field may be added in future versions.
|
|
|
|
### Can I modify the SPA templates?
|
|
|
|
The SPA is built with React. Advanced customizations require development knowledge.
|
|
|
|
---
|
|
|
|
## Addons
|
|
|
|
### What are WooNooW addons?
|
|
|
|
Addons extend WooNooW with additional features like loyalty points, advanced analytics, etc.
|
|
|
|
### How do I install addons?
|
|
|
|
Addons are installed as separate WordPress plugins. They integrate automatically with WooNooW.
|
|
|
|
### Do addons work when SPA is disabled?
|
|
|
|
Most addon features are for the SPA. When disabled, addon functionality may be limited.
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### I see a blank page. What do I do?
|
|
|
|
1. Check SPA Mode is set to "Full"
|
|
2. Flush permalinks (**Settings → Permalinks → Save**)
|
|
3. Clear all caches
|
|
4. See [Troubleshooting](troubleshooting) for more
|
|
|
|
### How do I report a bug?
|
|
|
|
Contact support with:
|
|
- Steps to reproduce the issue
|
|
- WordPress/WooCommerce/WooNooW versions
|
|
- Any error messages
|
|
- Screenshots if applicable
|