# Admin Guide — Noble Collectable

For the shop owner (non-technical). All tasks are performed in the WordPress admin dashboard.

---

## Getting Started

1. **Access the admin dashboard:** Visit `your-domain.com/wp-admin`
2. **Log in** with your username and password (set up during installation)
3. **Home:** You'll see the WordPress dashboard with quick-access shortcuts

---

## Adding a New Product

### Step 1: Open the Product Editor
- Left sidebar → **Products** → **Add New**

### Step 2: Basic Information
- **Product Name** (Title): E.g., "Kylian Mbappé, PSA 9, 2024 Heritage Chrome #15"
- **Description:** A short description of the card, e.g.:
  ```
  2024 Heritage Chrome edition of Kylian Mbappé.
  Graded PSA 9 by Professional Sports Authenticator.
  Card shows excellent centering and color. Light edge wear consistent with a 9.
  ```

### Step 3: Add Images
- Click **Set featured image** to upload the main card photo
- Click **Add product gallery images** to add 3–6 additional photos (different angles, back of card, etc.)
- **Tip:** Photos should be at least 1000×1300 pixels for clear display

### Step 4: Set Price & Stock
- **Regular price:** The selling price (e.g., $450.00)
- **Stock quantity:** How many copies you have in inventory
- **SKU:** A unique code for this product (e.g., NC-PSA-MB-2024-15)

### Step 5: Assign Categories
- Scroll down to **Product categories**
- Check boxes for:
  - **League:** (Premier League, La Liga, etc.)
  - **Team:** (e.g., Paris Saint-Germain)
  - **Set:** (e.g., 2024 Heritage Chrome)
  - **Era:** (e.g., Current 2015+)

### Step 6: Add Attributes (Filters)
- Scroll to **Product attributes**
- For each attribute, select the value:
  - **Grade:** PSA 9, PSA 10, etc.
  - **Condition:** Mint / Near Mint / Excellent
  - **Edition Type:** Standard / Refractor / Chrome / etc.
  - **Autograph:** Yes / No
- Attributes allow customers to filter products on the shop page

### Step 7: Publish
- Click **Publish** to make the product visible on the shop
- Click **Preview** to see how it looks before publishing

---

## Updating a Product

### Change Price or Stock
1. Products → **All Products**
2. Click the product name to edit
3. Update price or stock quantity
4. Click **Update**

### Quick Edit (Bulk Changes)
1. Products → **All Products**
2. Hover over a product name → click **Quick Edit**
3. Change price, stock, or status (Published / Draft)
4. Click **Update**

### Archive/Hide a Product
1. Products → **All Products**
2. Hover over product → click **Trash** to remove, or **Edit** to set status to **Draft** (hides from shop but keeps in system)

---

## Managing Orders

### View Orders
- Left sidebar → **Orders**
- See all customer orders with status (Pending, Processing, Shipped, Completed)

### Process an Order
1. Click the order number to open it
2. **Order details** show:
   - Customer name & email
   - Items ordered & total
   - Shipping & billing address
3. **Change status:**
   - Initially: **Pending Payment** (if payment not yet received)
   - After payment: Change to **Processing** (you're preparing to ship)
   - After shipment: Change to **Shipped** (include tracking number)
   - Final: **Completed**
4. **Add notes:** Use the **Order notes** box to leave internal notes or communicate with the customer
5. **Send email to customer:** Click **Send** next to any status change to notify them automatically

### Print Shipping Label (Phase 3)
- Once enabled: Click **Print label** to generate a shipping label (integration with Stripe/PayPal shipping)

---

## Managing Payments

### Check Payment Status
- Orders page shows payment status for each order
- **Pending Payment** = customer hasn't paid yet (send reminder email)
- **Paid** = payment received

### Payment Methods (Setup in Phase 3)
- Navigate to **WooCommerce** (if plugin is installed) → **Settings** → **Payments**
- Enable/disable payment methods (Stripe, PayPal, etc.)
- Configure API keys (provided by payment provider)
- **Note:** Detailed payment setup is done in Phase 3 after initial launch

### View Payouts
- Log into your **Stripe/PayPal account directly** to see payouts, not in WordPress
- WordPress shows if payment was received; the payment provider's dashboard shows settlement

---

## Customer Communication

### Email a Customer
1. Go to **Orders** → open the order
2. **Add note** to the order (internal, customer doesn't see it)
3. **Customer email** will see updates when you change order status
4. To send a custom email: Use a third-party service (Mailchimp, etc.) or reply via Gmail if customer initiates contact

### Email Settings
- Left sidebar → **Settings** → **General**
- Admin email: Emails from orders will come to this address
- Shop email: Some systems may use this for transactional emails

---

## Managing Inventory & Stock

### Bulk Update Stock
- Products → **All Products**
- Hover over product → **Quick Edit**
- Update **Stock quantity**
- Click **Update**

### Low Stock Alerts (Optional, Phase 3)
- WooCommerce can notify you when stock falls below a threshold
- Set this up in **WooCommerce** → **Settings** → **Products** → **Inventory**

### Import Products from CSV (Advanced, Phase 3)
- For large inventory uploads, CSV import is available
- Example: Bulk upload 100 cards at once with prices, stock, images

---

## Viewing Reports & Analytics

### Sales Overview
- Left sidebar → **WooCommerce** → **Overview** (if WooCommerce → Reports is available)
- See total sales, revenue, top products

### Customer List
- Left sidebar → **Customers** (if available)
- See customer names, email, order count, total spent

---

## Security & Backups (Important!)

### Change Your Password
1. Left sidebar → **Users** → **Your Profile**
2. Update password regularly (especially after setup)

### Regular Backups (Backup your store)
- **On cPanel:** Use **cPanel Backups** to back up your entire site
- **Automatic:** Set up automatic daily backups via cPanel
- **Recovery:** If anything breaks, cPanel can restore from a backup

### Updates
- Left sidebar → **Dashboard**
- WordPress will notify you of new updates (core, plugins, themes)
- Review updates monthly and apply them (they fix security issues and bugs)
- **Tip:** Always back up before updating

---

## Troubleshooting

### "Product not showing on shop page"
- Is it **Published**? Check Products → All Products
- Is it in a **Category**? Assign categories if filtered view is active
- Is it **In stock**? Check stock quantity

### "Payment not working"
- In Phase 3, double-check payment provider API keys in WooCommerce → Settings → Payments
- Test with a small transaction first

### "Customer can't see products"
- Check if products are in the correct category/language
- If bilingual: Check language filter (French vs. English version of site)

### "Site is slow"
- Images too large? Optimize in Tools → **Image Optimization** (if plugin is installed)
- Too many products? It's normal to slow down over time; consider pagination/caching in Phase 3

---

## Frequently Asked Questions

**Q: How do I set a discount/promo code?**
A: That's in WooCommerce → **Coupons** → **Add Coupon**. Set discount %, end date, etc. Customers enter the code at checkout.

**Q: Can customers leave reviews on products?**
A: Yes, if enabled in WooCommerce → **Settings** → **Products** → **Reviews**. Reviews appear on product pages.

**Q: How do I change the shop's name or tagline?**
A: Left sidebar → **Settings** → **General**. Change **Site Title** and **Tagline**.

**Q: Do I need to ship internationally?**
A: In WooCommerce → **Settings** → **Shipping**, you can enable/disable shipping to specific countries and set rates.

**Q: How do I track shipped orders?**
A: Add a **tracking number** in the order details when you mark it "Shipped". The system can email the customer the tracking link (depends on shipping provider integration in Phase 3).

---

**For more help:** Contact your developer (Yousha Rizvi) or consult [WooCommerce documentation](https://docs.woocommerce.com/document/home/).

---

**Next Phase:** See [`ROADMAP.md`](./ROADMAP.md) for when advanced features like CSV import, email automation, and payment integration will be set up.
