Řešení potíží

Logování

Modul automaticky loguje chyby při generování QR kódů.

Zobrazení logů v administraci

Logy jsou dostupné přímo v administraci WordPress:

WPify Woo → WPify Logs

Zde můžete:

• Vybrat log podle pluginu a data
• Prohlížet detaily jednotlivých záznamů

Umístění logů na FTP

Logy jsou uloženy také na serveru:

wp-content/uploads/logs/

Co se loguje

Událost	Popis
Chyba generování QR	Selhání při vytváření QR kódu
Nepodporovaná měna	Měna objednávky neodpovídá QR standardu

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

QR kód se nezobrazuje

Možné příčiny:

1. Modul není aktivní

   • Zkontrolujte: WPify → WPify Woo
   • Zapněte modul „QR platba”

2. Platební metoda není nastavena

   • Přejděte do nastavení modulu
   • Přidejte platební metodu a bankovní účet

3. Pozice nastavena na „Nezobrazovat”

   • Zkontrolujte nastavení „QR position on thank you page”

4. Nesouhlasí měna nebo země

   • QR kód se zobrazí pouze pokud měna a země odpovídají nastavení účtu
   • Zkontrolujte „Enabled currencies” a „Enabled countries”

---

Chyba: Call to undefined function exec()

Příčina: Server nepodporuje PHP funkci exec() potřebnou pro generování slovenských QR kódů.

Řešení:

1. Přejděte do nastavení modulu
2. Zapněte „Compatibility mode”
3. Uložte změny

Poznámka

Kompatibilní režim používá externí API pro generování QR kódů.

---

QR kód se nezobrazuje v e-mailech

Možné příčiny:

1. Nevybrané typy e-mailů

   • V nastavení platební metody vyberte e-maily v poli „Show in emails”

2. Plain text e-mail

   • QR kód se nezobrazuje v textových e-mailech, pouze v HTML

3. Problém s base64 formátem

   • Zapněte „Save as image” v nastavení modulu

---

QR kód nejde načíst v některých bankovních aplikacích

Příznaky: QR kód se zobrazuje správně, ale některé bankovní aplikace hlásí chybu při načítání (např. „Nenašli jsme správné údaje”).

Možné příčiny a řešení:

1. Chybí „Jméno příjemce”

   • Některé banky (např. AirBank) vyžadují vyplněné jméno příjemce, i když to CZ standard nevyžaduje
   • V nastavení účtu vyplňte pole „Recipient name” (přesný název vlastníka účtu)

2. Nesprávný QR standard pro danou zemi

   • CZ standard funguje pouze pro české banky a měnu CZK
   • Pokud máte nastaveno pro více zemí (SK, RO, …), tyto banky CZ standard nepodporují
   • Řešení: Použijte nastavení „Auto detect by order” - modul automaticky zvolí správný standard podle země a měny objednávky

3. Testujte v jiné aplikaci

   • Různé bankovní aplikace mají různou toleranci k formátu QR
   • Zkuste načíst QR v jiné bankovní aplikaci pro ověření

Tip

Pro více informací o QR standardech a jejich omezeních si přečtěte článek o QR platbách.

---

QR kód je rozbitý / nezobrazuje se správně

Možné příčiny:

1. Neplatná data účtu

   • Zkontrolujte správnost IBAN, čísla účtu
   • Zkontrolujte logy pro detaily chyby

2. Nesprávný QR standard

   • Ověřte, že typ QR odpovídá měně:
     • CZ + CZK
     • SK + EUR
     • HU + HUF
     • EPC + EUR

3. Chybí XZ utils pro SK

   • Zapněte kompatibilní režim

---

Nepodporovaná měna pro QR standard

Chyba v logu: QR payment: Unsupported currency for QR standard.

Příčina: Měna objednávky neodpovídá požadavkům QR standardu.

Řešení:

• Pro CZ standard musí být měna CZK
• Pro SK a EPC standardy musí být měna EUR
• Pro HU standard musí být měna HUF

Pokud máte více měn, nastavte pro každou měnu samostatný účet s odpovídajícím standardem.

---

QR kód se negeneruje pro některé objednávky

Zkontrolujte:

1. Platební metoda objednávky

   • QR se zobrazí pouze pro nakonfigurované platební metody

2. Fakturační země

   • Zkontrolujte nastavení „Enabled countries” pro účet

3. Měna objednávky

   • Zkontrolujte nastavení „Enabled currencies” (pro typ „Auto”)

4. Filtr wpify_woo_skip_qr_payment

   • Zkontrolujte, zda nemáte vlastní kód, který přeskakuje vykreslení

---

E-mailový klient upozorňuje na „externí soubory”

Příčina: Zapnuté ukládání QR jako soubor způsobuje, že e-mail obsahuje odkazy na externí obrázky.

Řešení: Toto je očekávané chování některých e-mailových klientů. Alternativně můžete vypnout „Save as image” a používat base64 formát.

---

Soubory QR kódů nezaplňují disk?

QR kódy se ukládají do wp-content/uploads/qr-payment/. Každá kombinace objednávky a účtu má jeden soubor. Soubory se nepřepisují a zůstávají na disku.

Pro pravidelné čištění starých souborů můžete nastavit cron job nebo použít plugin pro správu médií.

Kontakt na podporu

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

Připravte si tyto informace:

• Verze WordPress
• Verze WooCommerce
• Verze pluginu WPify Woo
• Výpis z logů (WPify Woo → WPify Logs)
• Případně výpis fatal errors z WooCommerce → Stav → Protokoly