0.9

content/promotions/_index.md

@@ -0,0 +1,13 @@
++++
+title = "Akcie a zľavy"
+description = "Správa pravidiel košíka a voucherov"
+sort_by = "weight"
+template = "section.html"
++++
+
+Tu spravujete všetky typy zľav - automatické zľavy v košíku aj manuálne zľavové kódy.
+
+## Obsah sekcie
+
+- [Pravidlá košíka](cart-rules) - Automatické zľavy pri splnení podmienok
+- [Vouchery](vouchers) - Zľavové kódy a ich generovanie

content/promotions/cart-rules.md

@@ -0,0 +1,217 @@
++++
+title = "Pravidlá košíka"
+description = "Automatické zľavy pri splnení podmienok"
+date = 2026-02-03
+weight = 1
++++
+
+Pravidlá košíka sú automatické zľavy, ktoré sa aplikujú, keď zákazník splní určité podmienky. Zákazník **nemusí zadávať žiadny kód** - systém pravidlá aplikuje automaticky.
+
+## Vytvorenie nového pravidla
+
+### Krok 1: Základné informácie
+
+**Názov**
+- Interný názov pre administráciu
+- Zákazník ho neuvidí (pokiaľ nenastavíte badge)
+- Príklad: "Zľava 10% nad 50€", "Doprava zdarma nad 30€"
+
+**Popis** (voliteľné)
+- Poznámky pre ostatných adminov
+- Zákazník ho neuvidí
+
+**Kanál**
+- Vyberte, pre ktorý obchod platí (shop.sk, shop.cz)
+- Alebo nechajte prázdne pre všetky kanály
+
+**Aktívne**
+- Zaškrtnite, aby pravidlo fungovalo
+- Odškrtnite na dočasné vypnutie
+
+### Krok 2: Platnosť
+
+**Platné od / Platné do**
+- Nastavte časové obdobie, kedy pravidlo funguje
+- Príklad: Vianočná akcia od 1.12. do 24.12.
+- Môžete nechať prázdne pre trvalé pravidlo
+
+### Krok 3: Priorita a kombinovanie
+
+**Priorita**
+- Číslo od 1 vyššie
+- **Čím nižšie číslo, tým vyššia priorita**
+- Pravidlá sa aplikujú od najnižšieho čísla
+
+**Príklad:**
+- Priorita 1: Zľava 20% (aplikuje sa ako prvá)
+- Priorita 2: Doprava zdarma (aplikuje sa potom)
+
+**Kombinovanie pravidiel**
+- **Exclusive** - Toto pravidlo sa nemôže kombinovať s inými. Ak sa aplikuje, ostatné sa ignorujú.
+- **Stackable** - Môže sa kombinovať s inými pravidlami
+
+**Tip:** Ak máte pravidlo "Zľava 50%" ktoré nechcete kombinovať s ničím, nastavte Exclusive.
+
+### Krok 4: Podmienky
+
+Nastavte, kedy sa pravidlo má aplikovať:
+
+**Minimálna suma košíka**
+- Pravidlo sa aplikuje, ak je suma v košíku aspoň táto hodnota
+- Príklad: 50 € (zľava len nad 50€)
+
+**Maximálna suma košíka**
+- Pravidlo sa aplikuje, ak je suma v košíku najviac táto hodnota
+- Príklad: Zľava len pre nákupy do 100€
+
+**Minimálny počet produktov**
+- Koľko kusov musí byť v košíku
+- Príklad: Aspoň 3 kusy
+
+**Maximálny počet produktov**
+- Najviac kusov v košíku
+- Príklad: Zľava len pre malé nákupy (max 5 kusov)
+
+**Rola zákazníka**
+- Pravidlo len pre určité typy zákazníkov
+- Príklad: Len pre "Premium" alebo "Verified" zákazníkov
+
+**Prvá objednávka**
+- Zaškrtnite, ak má platiť len pre úplne prvý nákup zákazníka
+- Perfektné pre uvítacie zľavy
+
+### Krok 5: Typ zľavy
+
+**Percentuálna zľava**
+- Zadajte percento (napr. 10, 20, 50)
+- Príklad: 15% zľava = zadajte "15"
+
+**Doprava zdarma**
+- Zákazník neplatí za dopravu
+- Netreba zadávať žiadnu hodnotu
+
+### Krok 6: Obmedzenia použitia
+
+**Celkový limit použití**
+- Koľkokrát môže byť pravidlo použité celkovo
+- Príklad: 100 = len prvých 100 zákazníkov
+- Nechajte prázdne pre neobmedzené
+
+**Limit na zákazníka**
+- Koľkokrát môže jeden zákazník použiť pravidlo
+- Príklad: 1 = každý zákazník len raz
+- Nechajte prázdne pre neobmedzené
+
+## Pravidlá s konkrétnymi produktmi
+
+Pravidlá môžu byť naviazané na konkrétne produkty. Existujú dva typy rolí produktov:
+
+### Roly produktov
+
+**CONDITION (Podmienka)**
+- Tieto produkty **musia byť v košíku**, aby sa pravidlo aplikovalo
+- Sami o sebe **nedostanú zľavu**
+- Príklad: "Kúp knihu X, získaš 20% zľavu na všetko ostatné"
+
+**DISCOUNT (Zľava)**
+- Tieto produkty **dostanú zľavu**, keď sa pravidlo aplikuje
+- Môžu byť v košíku aj nemusia (závisí od podmienok)
+- Príklad: "20% zľava na všetky tričká"
+
+### Príklad kombinácie:
+
+**Pravidlo:** Kúp knihu, získaj 50% zľavu na záložku
+
+1. Pridajte knihu s rolou **CONDITION**
+2. Pridajte záložku s rolou **DISCOUNT**
+3. Nastavte zľavu 50%
+
+**Výsledok:**
+- Ak má zákazník knihu v košíku, záložka bude so zľavou 50%
+- Kniha sama zostane za plnú cenu
+- Ak nemá knihu v košíku, záložka bude za plnú cenu
+
+### Nastavenie produktov
+
+Pre každý produkt môžete zadať:
+
+**Množstvo**
+- Koľko kusov musí/môže byť v košíku
+- Príklad: "Kúp 3 knihy, získaj 4. zadarmo"
+
+**Typ zľavy produktu** (len pre DISCOUNT rolu)
+- Percentuálna alebo pevná suma
+- Môže byť odlišná od hlavnej zľavy pravidla
+
+**Hodnota zľavy produktu** (len pre DISCOUNT rolu)
+- Konkrétna zľava pre tento produkt
+
+## Zobrazenie v košíku
+
+### Badge (Odznak)
+Text, ktorý sa zobrazí v košíku, keď je pravidlo **aktívne**.
+
+**Príklad:**
+- Badge text: "Vianočná zľava 15%"
+- Zobrazí sa v košíku ako zelený odznak
+
+### Progress bar (Indikátor progresu)
+Ak chcete ukázať zákazníkovi, koľko ešte chýba na splnenie podmienky.
+
+**Zapnite progress bar:**
+- Zaškrtnite "Zobraziť progress bar"
+
+**Progress správa:**
+- Použite `:count` na zobrazenie chýbajúcej sumy
+- Príklad: "Pridajte ešte :count € na dopravu zdarma"
+- Systém automaticky nahradí `:count` číslom
+
+**Ako to vyzerá:**
+```
+Pridajte ešte 12,50 € na dopravu zdarma
+[=========>          ] 75%
+```
+
+### Zobrazenie na produkte
+
+Ak má pravidlo produkty s rolou CONDITION alebo DISCOUNT, badge sa zobrazí aj na stránke produktu:
+- "Pri kúpe získate 20% zľavu"
+- "Súčasť akcie: Doprava zdarma"
+
+## Príklady pravidiel
+
+### 1. Doprava zdarma nad 30€
+- Podmienka: Minimálna suma 30€
+- Zľava: Doprava zdarma
+- Progress správa: "Pridajte ešte :count € na dopravu zdarma"
+
+### 2. Zľava 15% pre prvý nákup
+- Podmienka: Prvá objednávka = Áno
+- Zľava: 15%
+- Badge: "Uvítacia zľava 15%"
+
+### 3. Kúp 3, zaplať za 2
+- Produkt s rolou DISCOUNT: Pridajte produkt, množstvo: 3
+- Zľava produktu: 33,33%
+
+### 4. Študentská zľava
+- Podmienka: Rola zákazníka = "Verified"
+- Zľava: 10%
+- Badge: "Študentská zľava"
+
+## Časté chyby
+
+❌ **Konfliktné podmienky** - Min suma 50€ a Max suma 30€ (nikdy sa nesplní)  
+❌ **Zlá priorita** - Exclusive pravidlo má nízku prioritu, nikdy sa nepoužije  
+❌ **Chýbajúci progress text** - Progress bar zapnutý, ale text prázdny  
+❌ **Produkt v oboch rolách** - Produkt je CONDITION aj DISCOUNT zároveň
+
+## Kontrolný zoznam
+
+Pred aktivovaním skontrolujte:
+- ✅ Podmienky dávajú zmysel
+- ✅ Priorita je správne nastavená
+- ✅ Badge text je vyplnený (ak ho chcete)
+- ✅ Progress správa obsahuje `:count` (ak používate)
+- ✅ Limity sú rozumné (nebudú vyčerpané za 5 minút)
+- ✅ Pravidlo je aktívne a v správnom časovom období

content/promotions/vouchers.md

@@ -0,0 +1,253 @@
++++
+title = "Vouchery"
+description = "Zľavové kódy a ich generovanie"
+date = 2026-02-03
+weight = 2
++++
+
+Vouchery sú zľavové kódy, ktoré zákazníci zadávajú pri objednávke. Na rozdiel od pravidiel košíka, voucher **musí byť manuálne zadaný**.
+
+## Ako fungujú vouchery
+
+Vouchery sa vytvárajú z **šablón** (templates). Šablóna určuje:
+- Aký typ zľavy
+- Ako sa kódy generujú
+- Kto ich môže použiť
+- Koľkokrát
+
+**Proces:**
+1. Vytvoríte šablónu voucheru
+2. Systém vygeneruje konkrétne kódy podľa šablóny
+3. Zákazníci zadajú kód pri objednávke
+
+## Vytvorenie šablóny
+
+### Krok 1: Základné informácie
+
+**Názov**
+- Interný názov pre administráciu
+- Príklad: "Letná akcia 2026", "Vianočné vouchery"
+
+**Popis** (voliteľný)
+- Poznámky pre adminov
+
+**Kanál**
+- Pre ktorý obchod platí
+- Alebo nechajte prázdne pre všetky
+
+**Zobrazovaný názov** (voliteľný)
+- Názov, ktorý uvidia zákazníci
+- Príklad: "Letná zľava"
+
+### Krok 2: Vzor kódu
+
+Určuje, ako budú vyzerať vygenerované kódy.
+
+**Statický kód:**
+- Zadajte presný kód
+- Príklad: `WELCOME10`
+- Všetci používajú rovnaký kód
+
+**Dynamický kód s náhodnou časťou:**
+- Použite `{RANDOM:X}` kde X je počet znakov
+- Príklad: `SAVE{RANDOM:6}` → vygeneruje `SAVEA3K9P2`, `SAVEX7M4Q1`, atď.
+- Každý kód je jedinečný
+
+### Krok 3: Stratégia generovania
+
+Určuje, **kedy a ako** sa kódy vytvárajú:
+
+#### STATIC - Jeden statický kód
+- Vytvorí sa **jeden kód** pre všetkých
+- Všetci zákazníci používajú rovnaký
+- Príklad: `WELCOME10` - jeden kód pre všetkých
+
+**Kedy použiť:**
+- Verejné kampane
+- Kódy na sociálne siete
+- Newsletter pre všetkých
+
+#### BULK - Hromadné generovanie
+- Admin manuálne vygeneruje **X kódov naraz**
+- Kódy sa rozdávajú jednotlivo
+- Príklad: Vygenerujete 1000 kódov pre influencerov
+
+**Kedy použiť:**
+- Distribúcia partnerom
+- Fyzické kupóny (tlač)
+- Limitované kampane
+
+**Ako generovať:**
+1. Vytvorte šablónu
+2. Kliknite "Generovať kódy"
+3. Zadajte počet (napr. 100)
+4. Systém vytvorí 100 jedinečných kódov
+
+#### UNIQUE_PER_ORDER - Automaticky po objednávke
+- Systém **automaticky** vytvorí kód po objednávke
+- Každý zákazník dostane vlastný kód
+- Príklad: Po kúpe za 100€ dostane kód na 10% zľavu pri ďalšom nákupe
+
+**Kedy použiť:**
+- Odmena za nákup
+- Motivácia pre ďalší nákup
+- VIP program
+
+**Nastavenie automatického generovania:**
+- Zapnite "Automatické generovanie"
+- Minimálna suma objednávky: napr. 100€
+- Oneskorenie: koľko dní po objednávke (napr. 7)
+- Platnosť: koľko dní má kód platiť (napr. 30)
+
+#### ON_DEMAND - Na požiadanie
+- Admin vytvorí kód **manuálne podľa potreby**
+- Pre konkrétneho zákazníka
+- Príklad: Zákaznícky servis kompenzuje problém
+
+**Kedy použiť:**
+- Riešenie reklamácií
+- Individuálne žiadosti
+- VIP zákazníci
+
+**Ako vytvoriť:**
+1. Otvorte šablónu
+2. Kliknite "Vytvoriť voucher"
+3. Voliteľne priraďte používateľovi alebo emailu
+
+### Krok 4: Typ zľavy
+
+**Percentuálna zľava**
+- Zadajte percento (napr. 10, 20, 50)
+
+**Pevná suma**
+- Zadajte konkrétnu sumu (napr. 5€)
+
+**Doprava zdarma**
+- Neplatí za dopravu
+
+### Krok 5: Podmienky
+
+Rovnaké ako pri pravidlách košíka:
+
+**Minimálna suma košíka**
+- Voucher sa dá použiť len pri nákupe aspoň za túto sumu
+- Príklad: 50€
+
+**Maximálna suma košíka**
+- Voucher platí len do tejto sumy
+
+**Minimálny počet produktov**
+- Koľko kusov musí byť v košíku
+
+**Maximálny počet produktov**
+- Najviac kusov v košíku
+
+**Rola zákazníka**
+- Len pre určité typy zákazníkov
+
+**Prvá objednávka**
+- Len pre prvý nákup
+
+### Krok 6: Limity použitia
+
+**Limit na kód**
+- Koľkokrát môže byť **jeden kód** použitý
+- Príklad: 1 = každý kód len raz
+- Nechajte prázdne pre neobmedzené
+
+**Celkový limit šablóny**
+- Koľkokrát môžu byť **všetky kódy** z tejto šablóny použité celkovo
+- Príklad: 100 = len prvých 100 použití
+
+### Krok 7: Platnosť
+
+**Platné od / Platné do**
+- Časové obdobie, kedy kódy fungujú
+- Pre automaticky generované kódy sa nastaví individuálne
+
+## Priradenie voucheru
+
+Vouchery môžu byť:
+
+**Verejné**
+- Ktokoľvek môže použiť
+- Nie sú priradené nikomu
+
+**Priradené používateľovi**
+- Len konkrétny prihlásený zákazník môže použiť
+
+**Priradené emailu**
+- Len osoba s týmto emailom môže použiť
+- Nemusí byť registrovaná
+
+## Export a distribúcia
+
+### Export kódov
+1. Otvorte šablónu
+2. Kliknite "Exportovať vouchery"
+3. Stiahnete CSV so všetkými kódmi
+
+### Použitie exportu:
+- Email kampaň (každý dostane iný kód)
+- Tlač kupónov
+- Partnerská distribúcia
+
+## Sledovanie použitia
+
+Pre každú šablónu vidíte:
+- Koľko kódov bolo vygenerovaných
+- Koľko bolo použitých
+- Koľko je ešte dostupných
+
+Pre každý kód vidíte:
+- Kedy bol vytvorený
+- Kto ho použil
+- Kedy bol použitý
+
+## Príklady použitia
+
+### 1. Newsletter kupón
+- Stratégia: STATIC
+- Kód: `NEWSLETTER15`
+- Zľava: 15%
+- Limit na kód: Neobmedzený
+- Celkový limit: 500
+
+### 2. Vouchery pre influencerov
+- Stratégia: BULK
+- Vzor: `INFLUENCER{RANDOM:6}`
+- Vygenerujete: 50 kódov
+- Zľava: 20%
+- Limit na kód: 10 (každý influencer môže dať 10 ľuďom)
+
+### 3. Odmena po nákupe
+- Stratégia: UNIQUE_PER_ORDER
+- Automatické: Áno
+- Min objednávka: 100€
+- Oneskorenie: 3 dni
+- Zľava: 10%
+- Platnosť: 30 dní
+
+### 4. Kompenzácia zákazníkovi
+- Stratégia: ON_DEMAND
+- Vytvoríte manuálne
+- Priradíte emailu zákazníka
+- Zľava: 20€ pevná suma
+- Limit: 1 použitie
+
+## Časté chyby
+
+❌ **BULK generovanie omylom** - Vygenerovali ste 10 000 kódov namiesto 100  
+❌ **Chýbajúce {RANDOM}** - Vzor nemá náhodnú časť, všetky kódy rovnaké  
+❌ **Príliš krátka platnosť** - Automatický voucher platí 1 deň (zákazník nestihne)  
+❌ **Verejný voucher bez limitu** - Kód sa rozšíri a každý ho použije 100x
+
+## Kontrolný zoznam
+
+Pred aktivovaním šablóny:
+- ✅ Stratégia generovania zodpovedá účelu
+- ✅ Vzor kódu dáva zmysel (obsahuje {RANDOM} ak má)
+- ✅ Limity sú rozumné
+- ✅ Podmienky sú správne nastavené
+- ✅ Platnosť je dostatočne dlhá
+- ✅ Pre BULK: Skutočne chcete vygenerovať toľko kódov?