# Promo Popup — Dokumentacija

## Opis

Popup koji se prikazuje na naslovnoj stranici (`/`) nakon što korisnik scrolla 300px prema dolje. Prikazuje se jednom po satu po uređaju (localStorage timer). Upravljanje je dostupno kroz admin panel.

---

## Datoteke

| Datoteka | Opis |
|---|---|
| `app/Livewire/Admin/PromoPopupManager.php` | Admin Livewire klasa — upload slike, naslov, podnaslov, enable/disable |
| `resources/views/livewire/admin/promo-popup-manager.blade.php` | Admin UI forma |
| `resources/views/admin/promo-popup/index.blade.php` | Admin wrapper stranica |
| `resources/views/pages/home.blade.php` | Popup HTML (Alpine.js, čita JSON config) |
| `storage/app/promo-popup.json` | Config — enabled, image, title, subtitle |
| `public/images/promo/` | Direktorij za promo slike |

---

## Config JSON

`storage/app/promo-popup.json`:

```json
{
    "enabled": true,
    "image": "naziv_slike.png",
    "title": "Današnja ponuda",
    "subtitle": "Krčma Petrić"
}
```

| Polje | Tip | Opis |
|---|---|---|
| `enabled` | boolean | Uključuje/isključuje popup na naslovnoj |
| `image` | string | Naziv datoteke slike iz `public/images/promo/` |
| `title` | string | Naslov u headeru popupa (obavezno) |
| `subtitle` | string | Podnaslov/branding u headeru (opcionalno) |

---

## Ponašanje popupa

- Okida se na **scroll > 300px** od vrha stranice
- Prikazuje se **jednom po satu** — timestamp se sprema u `localStorage` pod ključem `promo_popup_last_shown`
- Zatvara se klikom na **overlay**, klikom na **× gumb** ili pritiskom tipke **Escape**
- Ako je `enabled: false` ili `image` prazan — popup se **ne renderira uopće** (PHP `@if`)

---

## Admin upravljanje

URL: `/admin/promo-popup`  
Dostupno u: Admin → Promo Popup (navigacijski dropdown)

Mogućnosti:
- Uključiti/isključiti popup
- Promijeniti naslov i podnaslov
- Uploadati novu sliku (max 5 MB, sprema se u `public/images/promo/`)
- Pregled trenutne i nove slike prije spreme

---

## Dodavanje nove slike (ručno)

1. Kopirati sliku u `public/images/promo/`
2. U adminu odabrati tu sliku kroz upload **ili** ručno ažurirati `storage/app/promo-popup.json`

```bash
cp nova_slika.png /home/krcma/public_html/lv/public/images/promo/
```