# Installation Guide

This guide covers installing WooNooW on your WordPress site.

## 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.