refactor: Migrate documentation content, rebuild UI components, and update core architecture.
This commit is contained in:
gitfromwildan
39
docs/resources/changelog.mdx
Normal file
39
docs/resources/changelog.mdx
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: Changelog
|
||||
description: Updates and version history for WooNooW Plugin
|
||||
---
|
||||
|
||||
Track all updates, new features, bug fixes, and improvements for WooNooW Plugin.
|
||||
|
||||
## Version 1.0.0 (Initial Release)
|
||||
|
||||
**Release Date:** February 2026
|
||||
|
||||
### 🎉 Features
|
||||
|
||||
- **Full WooCommerce Enhancement Suite** - Complete storefront modernization
|
||||
- **Admin SPA** - Modern React-based admin dashboard
|
||||
- **Customer SPA** - Fast, mobile-first shopping experience
|
||||
- **Page Builder** - Visual drag-and-drop page creation
|
||||
- **Licensing Module** - Sell software licenses with activation management
|
||||
- **Software Distribution** - Distribute updates for WordPress plugins/themes
|
||||
- **Subscription Module** - Recurring billing and subscription management
|
||||
- **Newsletter Module** - Email marketing integration
|
||||
- **Wishlist Module** - Customer wishlists and save-for-later
|
||||
- **RajaOngkir Integration** - Indonesia shipping rates
|
||||
|
||||
### 🛠️ Core Components
|
||||
|
||||
- Visual Editor with live preview
|
||||
- Header & Footer builder
|
||||
- Dynamic section components (Hero, Features, Testimonials, etc.)
|
||||
- Appearance customization (colors, typography, layouts)
|
||||
- Email notification system
|
||||
- Security settings (2FA, rate limiting)
|
||||
|
||||
### 📦 Developer Tools
|
||||
|
||||
- REST API endpoints
|
||||
- Hook & filter system
|
||||
- Addon bridge architecture
|
||||
- React component integration
|
||||
114
docs/resources/faq.mdx
Normal file
114
docs/resources/faq.mdx
Normal file
@@ -0,0 +1,114 @@
|
||||
---
|
||||
title: Frequently Asked Questions
|
||||
description: Quick answers to common questions about WooNooW
|
||||
date: 2024-01-31
|
||||
---
|
||||
|
||||
## General
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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.
|
||||
</Accordion>
|
||||
<Accordion title="Do I need WooCommerce?">
|
||||
Yes. WooNooW is an enhancement layer for WooCommerce. You need WooCommerce installed and activated.
|
||||
</Accordion>
|
||||
<Accordion title="Will WooNooW affect my existing products?">
|
||||
No. WooNooW reads from WooCommerce. Your products, orders, and settings remain untouched.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
---
|
||||
|
||||
## SPA Mode
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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. |
|
||||
</Accordion>
|
||||
<Accordion title="Can I switch modes anytime?">
|
||||
Yes. Go to **WooNooW → Appearance → General** and change the SPA Mode. Changes take effect immediately.
|
||||
</Accordion>
|
||||
<Accordion title="Which mode should I use?">
|
||||
- **Full**: For the best customer experience with instant loads
|
||||
- **Disabled**: If you have theme customizations you want to keep
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
---
|
||||
|
||||
## Compatibility
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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.
|
||||
</Accordion>
|
||||
<Accordion title="Does WooNooW work with page builders?">
|
||||
The SPA pages are self-contained. Page builders work on other pages of your site.
|
||||
</Accordion>
|
||||
<Accordion title="Which payment gateways are supported?">
|
||||
WooNooW supports all WooCommerce-compatible payment gateways:
|
||||
- PayPal
|
||||
- Stripe
|
||||
- Bank Transfer (BACS)
|
||||
- Cash on Delivery
|
||||
- And more...
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
---
|
||||
|
||||
## SEO
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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
|
||||
</Accordion>
|
||||
<Accordion title="What about my existing SEO?">
|
||||
WooCommerce URLs remain the indexed source. WooNooW redirects users to the SPA but preserves SEO value.
|
||||
</Accordion>
|
||||
<Accordion title="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.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
---
|
||||
|
||||
## Performance
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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.
|
||||
</Accordion>
|
||||
<Accordion title="Will WooNooW slow down my site?">
|
||||
The initial load is similar to regular WooCommerce. Subsequent navigation is much faster.
|
||||
</Accordion>
|
||||
<Accordion title="Does WooNooW work with caching?">
|
||||
Yes. Use page caching and object caching for best results.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
---
|
||||
|
||||
## Customization
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="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
|
||||
</Accordion>
|
||||
<Accordion title="Can I add custom CSS?">
|
||||
Currently, use your theme's Additional CSS feature. A custom CSS field may be added in future versions.
|
||||
</Accordion>
|
||||
<Accordion title="Can I modify the SPA templates?">
|
||||
The SPA is built with React. Advanced customizations require development knowledge.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
198
docs/resources/troubleshooting.mdx
Normal file
198
docs/resources/troubleshooting.mdx
Normal file
@@ -0,0 +1,198 @@
|
||||
---
|
||||
title: Troubleshooting
|
||||
description: Common issues and their solutions
|
||||
date: 2024-01-31
|
||||
---
|
||||
|
||||
## Blank Pages
|
||||
|
||||
WooCommerce pages (shop, cart, checkout) show blank content.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Check SPA Mode Setting">
|
||||
- Go to **WooNooW → Appearance → General**
|
||||
- Ensure **SPA Mode** is set to "Full"
|
||||
- If you want native WooCommerce, set to "Disabled"
|
||||
</StepperItem>
|
||||
<StepperItem title="Flush Permalinks">
|
||||
- Go to **Settings → Permalinks**
|
||||
- Click **Save Changes** (no changes needed)
|
||||
- This refreshes rewrite rules
|
||||
</StepperItem>
|
||||
<StepperItem title="Clear Cache">
|
||||
- If using a caching plugin:
|
||||
- Clear page cache
|
||||
- Clear object cache
|
||||
- Purge CDN cache (if applicable)
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 404 Errors on SPA Routes
|
||||
|
||||
Visiting `/store/shop` or `/store/product/...` shows a 404 error.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Flush Permalinks">
|
||||
- Go to **Settings → Permalinks**
|
||||
- Click **Save Changes**
|
||||
</StepperItem>
|
||||
<StepperItem title="Check Store Page Exists">
|
||||
- Go to **Pages**
|
||||
- Verify "Store" page exists and is published
|
||||
- The page should contain `[woonoow_spa]` shortcode
|
||||
</StepperItem>
|
||||
<StepperItem title="Check SPA Page Setting">
|
||||
- Go to **WooNooW → Appearance → General**
|
||||
- Ensure **SPA Page** is set to the Store page
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Product Images Not Loading
|
||||
|
||||
Products show placeholder images instead of actual images.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Regenerate Thumbnails">
|
||||
- Install "Regenerate Thumbnails" plugin
|
||||
- Run regeneration for all images
|
||||
</StepperItem>
|
||||
<StepperItem title="Check Image URLs">
|
||||
- Ensure images have valid URLs
|
||||
- Check for mixed content (HTTP vs HTTPS)
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Slow Performance
|
||||
|
||||
SPA feels slow or laggy.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Enable Caching">
|
||||
- Install a caching plugin (WP Super Cache, W3 Total Cache)
|
||||
- Enable object caching (Redis/Memcached)
|
||||
</StepperItem>
|
||||
<StepperItem title="Optimize Images">
|
||||
- Use WebP format
|
||||
- Compress images before upload
|
||||
- Use lazy loading
|
||||
</StepperItem>
|
||||
<StepperItem title="Check Server Resources">
|
||||
- Upgrade hosting if on shared hosting
|
||||
- Consider VPS or managed WordPress hosting
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Checkout Not Working
|
||||
|
||||
Checkout page won't load or payment fails.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Check Payment Gateway">
|
||||
- Go to **WooCommerce → Settings → Payments**
|
||||
- Verify payment method is enabled
|
||||
- Check API credentials
|
||||
</StepperItem>
|
||||
<StepperItem title="Check SSL Certificate">
|
||||
- Checkout requires HTTPS
|
||||
- Verify SSL is properly installed
|
||||
</StepperItem>
|
||||
<StepperItem title="Check for JavaScript Errors">
|
||||
- Open browser Developer Tools (F12)
|
||||
- Check Console for errors
|
||||
- Look for blocked scripts
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Emails Not Sending
|
||||
|
||||
Order confirmation emails not being received.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Check Email Settings">
|
||||
- Go to **WooNooW → Settings → Notifications**
|
||||
- Verify email types are enabled
|
||||
</StepperItem>
|
||||
<StepperItem title="Check WordPress Email">
|
||||
- Test with a plugin like "Check & Log Email"
|
||||
- Consider using SMTP plugin (WP Mail SMTP)
|
||||
</StepperItem>
|
||||
<StepperItem title="Check Spam Folder">
|
||||
- Emails may be in recipient's spam folder
|
||||
- Add sender to whitelist
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Plugin Conflicts
|
||||
|
||||
WooNooW doesn't work after installing another plugin.
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Steps to Diagnose">
|
||||
- Deactivate other plugins one by one
|
||||
- Switch to default theme (Twenty Twenty-Three)
|
||||
- Check error logs in `wp-content/debug.log`
|
||||
</StepperItem>
|
||||
<StepperItem title="Check WordPress Email">
|
||||
- Test with a plugin like "Check & Log Email"
|
||||
- Consider using SMTP plugin (WP Mail SMTP)
|
||||
</StepperItem>
|
||||
<StepperItem title="Common Conflicting Plugins">
|
||||
- Other WooCommerce template overrides
|
||||
- Page builder plugins (sometimes)
|
||||
- Heavy caching plugins (misconfigured)
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Getting More Help
|
||||
|
||||
If you can't resolve the issue:
|
||||
|
||||
<div className="pl-4">
|
||||
<Stepper>
|
||||
<StepperItem title="Collect Information">
|
||||
- WordPress version
|
||||
- WooCommerce version
|
||||
- WooNooW version
|
||||
- PHP version
|
||||
- Error messages (from debug.log)
|
||||
</StepperItem>
|
||||
<StepperItem title="Enable Debug Mode">
|
||||
- Add to `wp-config.php`:
|
||||
```php
|
||||
define('WP_DEBUG', true);
|
||||
define('WP_DEBUG_LOG', true);
|
||||
```
|
||||
</StepperItem>
|
||||
<StepperItem title="Contact Support">
|
||||
- Provide the collected information for faster resolution.
|
||||
</StepperItem>
|
||||
</Stepper>
|
||||
</div>
|
||||
Reference in New Issue
Block a user