Kupóny (Coupons)

Modul Coupons umožňuje zobrazovat informace o dostupných kupónech přímo na produktové stránce s možností automatického použití při přidání do košíku.

Aktivace modulu

Modul je volitelný a je třeba ho aktivovat v hlavním nastavení pluginu v sekci Další moduly.

---

Jak funguje

1. Vytvoříte standardní WooCommerce kupón
2. V nastavení kupónu zapnete zobrazení na produktové stránce
3. Na produktech, pro které kupón platí, se zobrazí CTA blok
4. Zákazník může přidat produkt do košíku s automaticky aplikovaným kupónem

---

Nastavení kupónu

1. Vytvořte WooCommerce kupón

Marketing → Kupóny → Přidat kupón

Nastavte standardní parametry kupónu:

• Kód kupónu
• Typ slevy (procenta, pevná částka)
• Omezení použití
• Platnost

2. Zapněte zobrazení na produktové stránce

V nastavení kupónu najděte záložku “Add to Cart with Coupon”:

Pole	Popis
Show on Product Detail Page	Zapne zobrazení CTA bloku na produktech
Apply coupon automatically	Kupón se aplikuje automaticky při přidání do košíku
Title	Nadpis CTA bloku
Button Text	Text tlačítka (podporuje placeholdery)

Placeholdery v textu tlačítka

Placeholder	Popis
{coupon_code}	Kód kupónu
{discounted_price}	Cena po slevě

Příklad:

Koupit za {discounted_price} s kupónem {coupon_code}

---

Nastavení modulu

Pozice info bloku

Pole: Coupon info block position

Určuje, kde se CTA blok zobrazí na produktové stránce.

Pozice	Popis
Before add to cart form	Před formulářem přidání do košíku
After add to cart form	Za formulářem
Before product summary	Před shrnutím produktu
After product summary	Za shrnutím

Styl bloku

Pole: Coupon box style

Styl	Popis
Custom / no style	Bez výchozích stylů - použijte vlastní CSS
Minimal	Jednoduchý bílý box s rámečkem
Bordered CTA	Přerušovaný rámeček, teplé barvy
Shined CTA	Výrazný červený blok s animací

---

Režimy použití kupónu

Automatické použití

Když je zapnuto “Apply coupon automatically”:

1. Zákazník klikne na standardní tlačítko “Přidat do košíku”
2. Produkt se přidá do košíku
3. Kupón se automaticky aplikuje

Výhoda: Jednodušší UX, zákazník nemusí zadávat kód.

Manuální použití (CTA blok)

Když je “Apply coupon automatically” vypnuto:

1. Na produktové stránce se zobrazí CTA blok
2. Zákazník klikne na tlačítko v bloku
3. Je přesměrován do košíku s produktem a aplikovaným kupónem

Výhoda: Zákazník vidí, že využívá speciální nabídku.

---

Validace kupónu

CTA blok se zobrazí pouze pokud:

1. Kupón je platný (datum, limit použití)
2. Kupón platí pro daný produkt
3. Produkt je skladem a lze koupit
4. Produkt má cenu (není zdarma)
5. Sleva skutečně snižuje cenu

---

CSS přizpůsobení

Pro vlastní stylování použijte tyto CSS třídy:

.wpify-woo-discount-coupon-block {
    /* Wrapper celého bloku */
}

.wpify-woo-discount-coupon-block__title {
    /* Nadpis */
}

.wpify-woo-discount-coupon-block__button {
    /* CTA tlačítko */
}

Tip: Vyberte styl “Custom / no style” a použijte vlastní CSS pro plnou kontrolu nad vzhledem.

---

Hooks pro vývojáře

Úprava dat CTA bloku

apply_filters( 'wpify_woo_coupons_block_args', $args, $product );

Parametry

Parametr	Typ	Popis
$args	array	Data pro šablonu (coupon, title, url, product)
$product	WC_Product	Aktuální produkt

Příklad

/**
 * Přidat vlastní data do CTA bloku
 */
function customize_coupon_block( $args, $product ) {
    $args['custom_message'] = 'Limitovaná nabídka!';
    return $args;
}
add_filter( 'wpify_woo_coupons_block_args', 'customize_coupon_block', 10, 2 );

---

Často kladené otázky

Mohu zobrazit více kupónů na jednom produktu?

Ne. Zobrazí se pouze první platný kupón. Pokud máte více kupónů pro stejný produkt, zobrazí se ten s nejnižším pořadím (podle názvu).

Funguje s procentuálními i pevnými slevami?

Ano. Modul podporuje oba typy WooCommerce kupónů:

• percent - procentuální sleva
• fixed_product - pevná sleva na produkt

Zobrazí se blok i když zákazník už kupón použil?

Ano. Validace limitu použití probíhá až při přidání do košíku. Blok se zobrazí, ale při pokusu o použití se zobrazí chybová hláška WooCommerce.

Jak funguje s variabilními produkty?

Kupón se validuje vůči hlavnímu produktu. Pokud kupón platí pro produkt, zobrazí se CTA blok. Při výběru konkrétní varianty se do košíku přidá varianta s aplikovaným kupónem.