Řešení problémů

Běžné problémy a řešení

Formulář se na stránce nezobrazuje

Možné příčiny:

1. Modul není aktivní

   • Zkontroluj: WPify → WPify Woo
   • Aktivuj modul „Odstoupení a reklamace”

2. Stránka není přiřazena v nastavení

   • Přejdi do WPify → WPify Woo → Odstoupení a reklamace
   • Přiřaď stránku do Stránka pro odstoupení (a/nebo Stránka pro reklamaci)
   • Bez přiřazené stránky shortcode/blok tichu vrátí prázdno

3. Shortcode není vložený do stránky

   • Vlož [wpify_woo_withdrawal_form] (nebo Gutenberg blok Formulář pro odstoupení) do obsahu stránky

4. ?form= parametr neodpovídá typu shortcodu

   • Pokud máš oba shortcody na jedné stránce a v URL je ?form=claim, withdrawal shortcode renderuje prázdný wrapper (a naopak)
   • Záměrné chování — na URL je vždy aktivní jen jeden formulář

---

Blok v editoru se neobjevuje nebo nic nezobrazuje

Možné příčiny:

1. JS není sestavený

   • Po update pluginu spusť npm run build — editor JS bloku se kompiluje pomocí wp-scripts

2. Hard cache v editoru

   • Reloadni editor pomocí Ctrl+Shift+R

3. Modul vypnutý

   • Blok v editoru ukáže admin-only červený placeholder, pokud je polovina vypnutá (stránka nepřiřazena)

---

Zákazník nedostává potvrzovací e-mail

Možné příčiny:

1. WC e-mail je vypnutý

   • Přejdi do WooCommerce → Nastavení → E-maily
   • Najdi „Odstoupení — potvrzení zákazníkovi” (nebo reklamace ekvivalent) a zapni

2. E-mail jde na billing email, ne na zadaný

   • Záměrné — z bezpečnostních důvodů customer notifikace vždy jde na billing_email (žádné přesměrování)

3. E-mail server / SMTP špatně nakonfigurovaný

   • Otestuj nejdřív obecnou WP e-mail funkčnost
   • Použij plugin jako WP Mail SMTP pro spolehlivé doručování

4. E-mail trigger před inicializací WC mailera

   • Zkontroluj error log pro warningy o WC()->mailer()

---

Admin nedostává notifikační e-mail

Možné příčiny:

1. WC e-mail je vypnutý

   • Přejdi do WooCommerce → Nastavení → E-maily
   • Najdi „Odstoupení — notifikace administrátorovi” (nebo reklamace ekvivalent) a zapni

2. Příjemci je prázdné

   • Zkontroluj pole Příjemci na stránce nastavení e-mailu
   • Default = admin_email pokud prázdné

---

Chyba „Invalid form type”

Příčina: REST endpoint dostal request bez form type pole.

Oprava: Známý bug ve starších verzích, kde REST endpoint očekával type ale formulář posílal wpify_woo_request_type. Aktualizuj na nejnovější verzi. Pokud problém přetrvává, zkontroluj že byl formulář vyrenderován nejnovější šablonou (ne cachované HTML).

---

Po submit formuláře tlačítko probkliklo „Pracuje…” a nic se nestalo

Možné příčiny:

1. Prohlížeč auto-vyplnil honeypot pole

   • Některé prohlížeče (zejména starší Chrome) auto-vyplňují jakýkoli <input>, který vypadá email-related
   • Nejnovější verze používá field name wpify_woo_url aby se tomu vyhnula — aktualizuj pokud používáš starší verzi

2. Time-trap fired (formulář submitnut do 1 sekundy od načtení stránky)

   • Počkej alespoň 1 sekundu po načtení před submitem

3. Validace silently failed (starší verze)

   • Nejnovější verze vrátí jasnou chybovou zprávu

4. JavaScript error v konzoli

   • Otevři DevTools v prohlížeči → Console — zkontroluj chyby

---

Zákazník dostává „Tato objednávka není způsobilá…” chybu

Příčina: Objednávka je v blokovaném stavu.

Default blokované stavy:

• refunded (Vráceno)
• cancelled (Zrušeno)
• failed (Selhalo)
• checkout-draft, auto-draft (Návrh)

Oprava: Buď změň stav objednávky (v WC adminu) na aktivní, nebo použij filtr wpify_woo_withdrawal_claims_blocked_statuses pro custom úpravu.

---

Lhůta pro odstoupení vypadá špatně

Možné příčiny:

1. Period start status není konfigurován dle tvého workflowu

   • Default je „Dokončeno”. Pokud tvůj shop používá custom „Doručeno” stav pro reálné dodání, vyber ho v Stavy objednávky, od kterých běží lhůta

2. Legacy objednávka (před aktivací modulu)

   • Pro objednávky, které existovaly před aktivací modulu, plugin použije fallback (date_completed → date_paid → date_created). Konfigurované period_start_statuses se NEvynucují retrospektivně.

3. Per-produkt override je nastavený

   • Zkontroluj záložku Odstoupení a reklamace u produktu pro override hodnotu

---

„V této objednávce nejsou způsobilé položky”

Možné příčiny:

1. Lhůta vypršela pro všechny položky
2. Všechny produkty vyloučené z odstoupení/reklamace per-produkt nastavením
3. Objednávka nemá line items

Formulář ukazuje individuální reason tagy („Lhůta vypršela” / „Vyloučeno prodejcem”) vedle disabled položek v eligibility sekci.

---

„Příliš mnoho pokusů. Zkuste to prosím později.”

Příčina: Vrstva B rate-limit zachytl.

Cooldown: 1 hodina. Transient wpify_woo_req_attempts_{md5(ip)} se automaticky expiruje.

Oprava pro zaseknutého legitimního usera:

• Zvyš limit v Nastavení → Zabezpečení → Maximum pokusů per IP za hodinu
• Nebo smaž transient ručně přes WP-CLI: wp transient delete wpify_woo_req_attempts_*

---

Počet položek v admin sloupci nesedí s tím, co viděl zákazník

Příčina: Zákazníkův submit byl filtrován server-side.

scope = whole_order (celá objednávka) znamená „všechny eligible položky v okamžiku podání” — položky vyloučené per-produkt nastavením nebo s vypršelou lhůtou NEjsou zahrnuté. Jen finální filtrovaný seznam je uložen v items_json.

---

Email styling neodpovídá mým customizacím

Příčina: Theme override email-styles.php se nenačítá.

Pluginové email šablony používají class="td" a spoléhají na WC email-styles.php (procesovaný Emogrifierem do inline CSS). Pro customizaci:

1. Zkopíruj wp-content/plugins/woocommerce/templates/emails/email-styles.php do wp-content/themes/[tvoje-tema]/woocommerce/emails/email-styles.php
2. Customizuj tam
3. WC nativní e-maily i naše withdrawal/claim e-maily budou používat tvé styly

---

HPOS — metabox se nezobrazuje v detailu objednávky

Příčina: Starší verze pluginu registrovala metabox jen na legacy shop_order screenu.

Oprava: Aktualizuj na nejnovější verzi. Plugin deklaruje HPOS kompatibilitu přes FeaturesUtil::declare_compatibility('custom_order_tables', …) a registruje metabox na obou screenech shop_order i woocommerce_page_wc-orders.

---

Cache plugin servíruje zastaralý formulář

Příčina: Full-page cache (WP Rocket, LiteSpeed, server-level Varnish) cachoval stránku formuláře včetně zastaralých nonce a time-trap tokenů.

Oprava: Plugin nastavuje DONOTCACHEPAGE a nocache_headers() na přiřazených form stránkách. Pokud tvůj cache plugin nerespektuje tyto hlavičky, manuálně vyřaď withdrawal/claim stránky z cache.

Logy

Plugin používá Wpify\Log\RotatingFileLog s parent slugem wpify. K logům lze přistoupit dvěma způsoby:

1. Administrace: WPify → WPify Logs

Vyber soubor logu z dropdownu (jeden soubor per plugin per den) a klikni na Display log. Vybraný soubor se vyrenderuje do tabulky s časem záznamu, úrovní (DEBUG / INFO / NOTICE / WARNING / ERROR — barevně rozlišené badge), zprávou a kontextem. Pod tabulkou lze nastavit, kolik log souborů per plugin se má uchovávat (default 5).

Vestavěný filtr podle úrovně ani fulltextové vyhledávání tam není — vyber denní soubor a procházej záznamy.

2. Filesystem: wp-content/uploads/wpify-logs/wpify_log_wpify-woo_*.log

Úrovně používané modulem:

• error — DB exceptions, e-mail send failures
• warning — rate-limit hits, honeypot trips, time-trap fails, neplatné tokeny
• info — úspěšná podání (jen request_id + order_id)

Při řešení selhaných submission se nejdřív podívej do logů.

Kontakt na podporu

Pokud problém přetrvává, kontaktuj podporu na support@wpify.io.

Připrav prosím následující informace:

• WordPress verze
• WooCommerce verze (a HPOS zapnuto?)
• Verze pluginu WPify Woo
• Logged-in vs. guest scénář
• Prohlížeč + verze
• Screenshot problému
• Výpis z wp-content/uploads/wpify-logs/wpify-woo-*.log v době problému