==============================================================
      HERO SLIDER - QUICK REFERENCE GUIDE
==============================================================

📍 LOCATION: /admin/slider.php

🎯 QUICK START (5 minutes)
──────────────────────────────────────────────────────────

1. Login to Admin Panel
2. Click "Hero Slider" in sidebar
3. Fill in form:
   - Title: "Your Slide Title"
   - Description: "Slide description"
   - Button Text: "Click Here"
   - Button Link: "page.php"
   - Upload background image
   - Set display order (1 = first)
   - Check "Active on Homepage"
4. Click "Add Slide"
5. Done! Slide appears on homepage instantly

──────────────────────────────────────────────────────────

⏱️  FESTIVAL MANAGEMENT (5 steps)
──────────────────────────────────────────────────────────

For Diwali/Christmas/Events:

Step 1: CREATE SLIDES
   ✓ Add 2-3 festival-themed slides
   ✓ Upload festive images
   ✓ Set button links to relevant pages

Step 2: SET PRIORITY
   ✓ Display Order = 1 (show first)

Step 3: ACTIVATE
   ✓ Check "Active on Homepage"

Step 4: PUBLISH
   ✓ Click "Add Slide"

Step 5: DEACTIVATE LATER
   ✓ Edit slide → Uncheck "Active"
   ✓ Or delete slide

──────────────────────────────────────────────────────────

📋 FORM FIELDS EXPLAINED
──────────────────────────────────────────────────────────

Field                  | What to enter
─────────────────────────────────────────────────────────
Slide Title            | Main big text (e.g., "Festival Offers")
Description            | Smaller text below title
Button Text            | Label for clickable button
Button Link            | Where button takes you (menupage-veg.php)
Background Image       | Full-width banner image (required)
Layer Image            | Optional decorative overlay (PNG)
Display Order          | 1=first, 2=second, etc.
Active on Homepage     | ☑ = show, ☐ = hide

──────────────────────────────────────────────────────────

🖼️  IMAGE SIZES
──────────────────────────────────────────────────────────

Background Image:
  • Size: 1920 x 600 pixels (best)
  • Type: JPG or PNG
  • Max: 5MB

Decorative Layer:
  • Size: 400-500 pixels wide
  • Type: PNG (transparent)
  • Max: 2MB

──────────────────────────────────────────────────────────

🔄 EDIT EXISTING SLIDE
──────────────────────────────────────────────────────────

1. Find slide in list
2. Click "Edit" button
3. Update any field
4. Upload new image (optional, old auto-deletes)
5. Click "Update Slide"

──────────────────────────────────────────────────────────

❌ DELETE SLIDE
──────────────────────────────────────────────────────────

1. Find slide in list
2. Click "Delete" button
3. Confirm deletion
4. Images auto-deleted from server

──────────────────────────────────────────────────────────

✅ USEFUL BUTTON LINKS
──────────────────────────────────────────────────────────

menupage-veg.php          → Vegetarian menu
menupage-nonveg.php       → Non-vegetarian menu
catering-events.php       → Catering bookings
online-delivery.php       → Online orders
reservation.php           → Table reservations
gallery.php               → Gallery/Photos

──────────────────────────────────────────────────────────

💡 TIPS & TRICKS
──────────────────────────────────────────────────────────

✓ Lower display order = appears first
  (1 appears before 2 which appears before 3)

✓ Use high-quality, compressed images
  (Don't use 10MB raw photos)

✓ Test on mobile before publishing
  (Verify images look good on phones)

✓ Create seasonal variations
  (Keep separate sets for each festival)

✓ Schedule in advance
  (Create slides weeks ahead)

✓ Archive old content
  (Delete past campaign slides)

──────────────────────────────────────────────────────────

🐛 TROUBLESHOOTING
──────────────────────────────────────────────────────────

Problem: Slide won't appear on homepage
→ Check: Is "Active on Homepage" checked?
→ Fix: Edit slide and enable checkbox

Problem: Images not uploading
→ Check: File size under 5MB?
→ Check: File type is JPG/PNG/PNG?
→ Fix: Compress image first

Problem: Old image still showing
→ Solution: Clear browser cache (Ctrl+Shift+Del)

Problem: Database table doesn't exist
→ Solution: System creates automatically on first use
→ Or manually run SQL setup from guide

──────────────────────────────────────────────────────────

📊 DATABASE TABLE: hero_slides
──────────────────────────────────────────────────────────

Fields:
• id              - Unique ID
• title           - Slide title
• description     - Slide description  
• button_text     - Button label
• button_link     - Button destination
• background_image - BG image path
• layer_image     - Decorative image
• is_active       - 1=visible, 0=hidden
• display_order   - Sort order
• created_at      - Creation timestamp
• updated_at      - Last edit timestamp

──────────────────────────────────────────────────────────

🎭 FESTIVAL EXAMPLES
──────────────────────────────────────────────────────────

DIWALI EXAMPLE:
  Title: "Celebrate Diwali with Our Special Dishes"
  Description: "Delicious traditional treats"
  Button: "Order Now"
  Link: menupage-veg.php
  Order: 1

CHRISTMAS EXAMPLE:
  Title: "Holiday Season Feast"
  Description: "Festive Christmas menu available"
  Button: "Explore Menu"
  Link: menupage-nonveg.php
  Order: 1

NEW YEAR EXAMPLE:
  Title: "Ring in 2025 with Us"
  Description: "Special New Year celebrations & menu"
  Button: "Book Table"
  Link: reservation.php
  Order: 1

──────────────────────────────────────────────────────────

✨ BEST PRACTICES
──────────────────────────────────────────────────────────

BEFORE PUBLISHING:
  ✓ Proofread text for typos
  ✓ Test button links work
  ✓ Verify images look good
  ✓ Check on mobile view
  ✓ Match brand colors/style

AFTER PUBLISHING:
  ✓ Check homepage slider works
  ✓ Try clicking buttons
  ✓ Verify on different devices
  ✓ Monitor for issues

MAINTENANCE:
  ✓ Delete old promotional slides
  ✓ Update images seasonally
  ✓ Archive past campaigns
  ✓ Keep 3-5 active slides max

──────────────────────────────────────────────────────────

📞 SUPPORT
──────────────────────────────────────────────────────────

For issues or questions, refer to:
• Full Guide: HERO_SLIDER_GUIDE.md
• Check database table structure
• Verify folder permissions
• Review error messages

──────────────────────────────────────────────────────────

Last Updated: December 2025 | Version: 1.0
