95 lines
2.5 KiB
Plaintext
95 lines
2.5 KiB
Plaintext
---
|
|
title: Installation Guide
|
|
description: Installing WooNooW on your WordPress site
|
|
date: 2024-01-31
|
|
---
|
|
|
|
## Requirements
|
|
|
|
Before installing, ensure your site meets these requirements:
|
|
|
|
| Requirement | Minimum | Recommended |
|
|
|-------------|---------|-------------|
|
|
| WordPress | 6.0+ | Latest |
|
|
| WooCommerce | 7.0+ | Latest |
|
|
| PHP | 7.4+ | 8.1+ |
|
|
| MySQL | 5.7+ | 8.0+ |
|
|
|
|
## Installation Methods
|
|
|
|
### Method 1: WordPress Admin (Recommended)
|
|
|
|
1. Go to **Plugins → Add New**
|
|
2. Click **Upload Plugin**
|
|
3. Select the `woonoow.zip` file
|
|
4. Click **Install Now**
|
|
5. Click **Activate**
|
|
|
|
### Method 2: FTP Upload
|
|
|
|
1. Extract `woonoow.zip` to get the `woonoow` folder
|
|
2. Upload to `/wp-content/plugins/`
|
|
3. Go to **Plugins → Installed Plugins**
|
|
4. Find WooNooW and click **Activate**
|
|
|
|
## Post-Installation
|
|
|
|
After activation, WooNooW automatically:
|
|
|
|
### 1. Creates Store Page
|
|
A new "Store" page is created with the SPA shortcode. This is your main storefront.
|
|
|
|
### 2. Registers Rewrite Rules
|
|
URL routes like `/store/shop` and `/store/product/...` are registered.
|
|
|
|
> **Note**: If you see 404 errors, go to **Settings → Permalinks** and click **Save Changes** to flush rewrite rules.
|
|
|
|
### 3. Sets Default Configuration
|
|
Basic appearance settings are configured with sensible defaults.
|
|
|
|
## Verification Checklist
|
|
|
|
After installation, verify everything works:
|
|
|
|
- [ ] Plugin activated without errors
|
|
- [ ] WooNooW menu appears in admin sidebar
|
|
- [ ] Store page exists (check **Pages**)
|
|
- [ ] `/store` URL loads the SPA
|
|
- [ ] Products display on shop page
|
|
|
|
## WooCommerce Compatibility
|
|
|
|
WooNooW works alongside WooCommerce:
|
|
|
|
| WooCommerce Page | WooNooW Behavior (Full Mode) |
|
|
|------------------|------------------------------|
|
|
| `/shop` | Redirects to `/store/shop` |
|
|
| `/product/...` | Redirects to `/store/product/...` |
|
|
| `/cart` | Redirects to `/store/cart` |
|
|
| `/checkout` | Redirects to `/store/checkout` |
|
|
| `/my-account` | Redirects to `/store/my-account` |
|
|
|
|
When SPA Mode is **Disabled**, WooCommerce pages work normally.
|
|
|
|
## Updating
|
|
|
|
To update WooNooW:
|
|
|
|
1. Download the latest version
|
|
2. Go to **Plugins → Installed Plugins**
|
|
3. Deactivate WooNooW (optional but recommended)
|
|
4. Delete the old version
|
|
5. Install and activate the new version
|
|
|
|
Your settings are preserved in the database.
|
|
|
|
## Uninstalling
|
|
|
|
To completely remove WooNooW:
|
|
|
|
1. Deactivate the plugin (restores WooCommerce page content)
|
|
2. Delete the plugin
|
|
3. (Optional) Delete WooNooW options from database
|
|
|
|
> **Note**: Deactivating restores original WooCommerce shortcodes to Cart, Checkout, and My Account pages.
|