# 🚀 Quick Start Guide - Bulk Email System

## Step-by-Step Setup (5 minutes)

### 1. Install Dependencies
```powershell
cd "c:\Rohan\Lorvantiq Ventures\SaroGenix\Code"
composer install
```

### 2. Configure SMTP Settings
Edit `config/config.php`:
```php
'smtp' => [
    'host' => 'smtp.gmail.com',  // Your SMTP server
    'username' => 'your-email@gmail.com',
    'password' => 'your-app-password',  // Use App Password for Gmail
],
```

### 3. Update Company Information
In `config/config.php`, set your company details:
```php
'company' => [
    'name' => 'Your Company Name',
    'logo_url' => 'https://yourwebsite.com/logo.png',
    'website' => 'https://yourwebsite.com',
    // ... other fields
],
```

### 4. Start Local Server
```powershell
php -S localhost:8000
```

### 5. Open Product Manager
Visit: http://localhost:8000/product_manager.html

### 6. Add Your First Product
- Enter product name, price, description, link
- Upload 1-5 product images (drag & drop)
- Click "Save Product"

### 7. Send Test Email
- Click "Use in Email" on your product
- Add a test recipient (your email)
- Click "Send Test Email"
- Check your inbox!

### 8. Send Bulk Campaign
- Add multiple recipients or upload CSV
- Click "Send Bulk Emails"
- Monitor progress in real-time

---

## 📧 Gmail Setup (If using Gmail)

1. Enable 2-Factor Authentication on your Google Account
2. Generate App Password:
   - Visit: https://myaccount.google.com/security
   - Security → 2-Step Verification → App passwords
   - Generate password for "Mail" / "Windows Computer"
   - Copy the 16-character password
3. Use this App Password in `config/config.php`

---

## 🎨 About Image Sliders in Emails

**Q: Can we add interactive image sliders like on websites?**

**A: No** - Email clients block JavaScript for security, so interactive carousels won't work.

**Our Solution:**
- ✅ Display **multiple product images** in a beautiful static grid
- ✅ Works in **all email clients** (Gmail, Outlook, Apple Mail)
- ✅ Shows main featured image + additional images in rows
- ✅ All images are **clickable** and link to your product page
- ✅ Responsive layout that looks great on mobile and desktop

**Result:** Professional multi-image display without JavaScript limitations!

---

## 📂 File Structure Overview

```
product_manager.html     → Upload & manage products
send_emails_ui.php      → Send emails with saved products
config/config.php       → Your SMTP & company settings
uploads/products/       → Your uploaded images (auto-created)
data/products.json      → Product database (auto-created)
```

---

## 💡 Tips

1. **Test first** - Always send a test email before bulk sending
2. **Use quality images** - 800x600px, under 500KB each
3. **Upload 2-4 images** - Show different product angles
4. **Check spam folder** - First emails may land in spam
5. **Start small** - Test with 5-10 recipients first

---

## 🆘 Common Issues

**"SMTP connection failed"**
→ Check username/password in config.php

**"Cannot upload images"**
→ Ensure `uploads/products/` directory exists and is writable

**"No products showing"**
→ Make sure you're running the PHP server (`php -S localhost:8000`)

**"Emails going to spam"**
→ Normal for first sends. Recipients marking as "Not Spam" helps

---

## ✅ You're Ready!

Start adding products and sending beautiful emails! 📧

Need help? Check README.md for detailed documentation.