# AquaPure WordPress Theme v3.2.0

Complete WordPress theme converted from the AquaPure V3 single-page HTML — identical design, animations, and UX with full admin editability.

---

## ⚡ Quick Installation (5 minutes)

### Option A — Upload ZIP (Recommended)
1. Log into **WordPress Admin → Appearance → Themes**
2. Click **Add New → Upload Theme**
3. Choose `aquapure-theme.zip` → click **Install Now**
4. Click **Activate**
5. Go to **Appearance → Import Sample Data** → click **Import Sample Data**
6. Done — visit your homepage!

### Option B — FTP / cPanel
1. Extract `aquapure-theme.zip`
2. Upload the `aquapure-theme/` folder to `/wp-content/themes/`
3. Activate in **Admin → Appearance → Themes**
4. Import sample data (step 5 above)

---

## 🛠️ Requirements

| Item | Minimum |
|------|---------|
| WordPress | 6.0+ |
| PHP | 8.0+ |
| MySQL | 5.7+ |

---

## 📁 File Structure

```
aquapure-theme/
├── style.css              ← Theme identity + all CSS (design tokens → responsive)
├── functions.php          ← Theme setup, CPTs, customizer, AJAX handlers, meta boxes
├── index.php              ← Homepage (all sections)
├── header.php             ← <head>, nav, booking modal, FABs, back-to-top
├── footer.php             ← Footer, mobile bottom nav, wp_footer()
├── singular.php           ← Generic page/post template
├── 404.php                ← 404 error page
├── assets/
│   ├── js/
│   │   └── main.js        ← All JavaScript (nav, modal, quiz, products, cart…)
│   ├── css/               ← (empty — all CSS in style.css)
│   └── images/            ← Place custom images here
├── inc/
│   └── sample-data.php    ← One-click demo content importer
├── template-parts/        ← (reserved for future partials)
├── languages/             ← Translation-ready (.pot files go here)
└── README.md              ← This file
```

---

## 🎛️ Admin Editing Guide

### Content Sections

| Section | Where to edit |
|---------|--------------|
| Hero headline, CTA, trust items | **Appearance → Customize → 🏠 Hero Section** |
| Stats / proof bar numbers | **Appearance → Customize → 📊 Stats / Proof Bar** |
| Phone, email, WhatsApp, footer text | **Appearance → Customize → 📞 Contact & Footer** |
| Brand colors | **Appearance → Customize → 🎨 Brand Colors** |
| Services | **Admin → Services → Add/Edit** |
| Products | **Admin → Products → Add/Edit** |
| Spare Parts | **Admin → Spare Parts → Add/Edit** |
| AMC Plans | **Admin → AMC Plans → Add/Edit** |
| Testimonials | **Admin → Testimonials → Add/Edit** |
| FAQs | **Admin → FAQs → Add/Edit** |
| Bookings | **Admin → Bookings** (read-only, auto-created on form submit) |
| Logo | **Appearance → Customize → Site Identity → Logo** |

### Adding a Service
1. Go to **Admin → Services → Add New**
2. Enter **Title** (service name)
3. Enter **Content** (description)
4. In the **Service Details** meta box: add Icon (emoji), Price, CTA button text
5. Publish

### Adding a Product
1. Go to **Admin → Products → Add New**
2. Title = product name
3. Fill all fields in **Product Details** meta box (emoji, tags, price, rating, etc.)
4. Publish

### AMC Plan Features Format
In the **Plan Details** meta box, Features field:
```
+ Feature that IS included
+ Another included feature
- Feature NOT included
```
Lines starting with `+` show a ✓ checkmark. Lines starting with `-` show a grey dash.

---

## 📧 Booking Email Notifications

Bookings are saved to **Admin → Bookings** AND emailed to the WordPress admin address.

To change the notification email: **Admin → Settings → General → Email Address**

---

## 🌐 WhatsApp Integration

Set your WhatsApp number in: **Appearance → Customize → 📞 Contact & Footer → WhatsApp Number**

Format: country code + number, no spaces (e.g. `919876543210` for India)

---

## 🎨 Changing Colors

**Appearance → Customize → 🎨 Brand Colors**
- Brand Blue (default `#0057FF`)
- Teal Accent (default `#00C2A8`)
- Dark Ink (default `#0A0F1C`)

---

## 🔍 SEO

The theme outputs:
- `<title>` tags via WordPress title-tag support
- Meta description from tagline or post excerpt
- JSON-LD LocalBusiness schema on the homepage
- Semantic HTML5 landmarks (`<nav>`, `<main>`, `<section>`, `<footer>`)
- ARIA labels on all interactive elements

Recommended: Install **Yoast SEO** or **Rank Math** for full control.

---

## ⚡ Performance Tips

1. Install **WP Rocket** or **LiteSpeed Cache** for page caching
2. Use **Smush** or **ShortPixel** for image optimization
3. Enable GZIP compression in your `.htaccess` or server config
4. The theme uses a single CSS file and a single JS file — no external dependencies beyond Google Fonts

---

## 📱 Responsive Breakpoints

| Breakpoint | Layout |
|-----------|--------|
| 1200px+ | Full desktop (4-column products, side-by-side hero) |
| 1024px | 3-column products |
| 768px | 2-column products, mobile bottom nav shown, desktop nav links hidden |
| 480px | Single column, all stacked |

---

## 🧩 Animations

All animations use CSS transitions + `IntersectionObserver` — no jQuery, no GSAP, no heavy libraries. The scroll-reveal (`.sr` class) gracefully degrades when `prefers-reduced-motion` is enabled.

---

## 🔒 Security

- All AJAX endpoints protected with `wp_nonce`
- All output escaped with `esc_html()`, `esc_attr()`, `esc_url()`
- All input sanitized with `sanitize_text_field()`, `sanitize_textarea_field()`
- Booking CPT has `create_posts => do_not_allow` — only created programmatically

---

## 📄 License

GNU General Public License v2 or later — https://www.gnu.org/licenses/gpl-2.0.html

---

*AquaPure WordPress Theme — Built with ❤️ for clean water and clean code.*
