Toret QR platby uživatelská dokumentace (generováno Claude)

Verze: 3.1.0
Pro: WordPress 6.2+ a WooCommerce 6.7+

---

1. Úvod – Co plugin dělá

Plugin Toret QR Platby automaticky přidává QR kódy pro platbu bankovním převodem do vašeho WooCommerce eshopu. Zákazníci mohou platbu provést jednoduše naskenováním QR kódu v mobilní bankovní aplikaci.

✨ Hlavní funkce

• 📱 QR kódy podle standardů – Česká QR Platba, slovenská PayBySquare, mezinárodní SEPA
• 📧 Automatické zobrazení v emailech – QR kód se přidá do emailů při stavech „Čeká na platbu“ a „Zpracovává se“
• 🎉 Thank you page – QR kód se zobrazí zákazníkovi hned po dokončení objednávky
• 📄 PDF faktury – Integrace s PDF Invoices, Booster a Toret Faktura
• 🏦 Více bankovních účtů – Různé účty pro různé platební metody
• 🌍 Multi-měna – Různé účty pro CZK, EUR a další měny

---

2. Instalace a aktivace

Krok 1: Instalace pluginu

1. Přihlaste se do administrace WordPressu
2. Přejděte do Pluginy → Přidat nový
3. Nahrajte soubor toret-qrplatby.zip
4. Klikněte na Aktivovat plugin

Krok 2: Aktivace licence

1. Přejděte do WooCommerce → QR Platby
2. Otevřete záložku Licence
3. Vložte váš licenční klíč
4. Klikněte na Ověřit

Krok 3: Kontrola bankovních údajů

Před použitím pluginu vyplňte bankovní údaje v:
WooCommerce → Nastavení → Platby → Bankovní převod

Vyplňte:

• Název účtu
• Číslo účtu (formát: předčíslí-číslo/kód banky nebo IBAN)
• BIC/SWIFT (pro IBAN účty)

---

3. Základní nastavení

V administraci WordPressu přejděte do: WooCommerce → QR Platby

Záložky nastavení:

• 📜 Licence – Aktivace licence
• 🏦 Bankovní účet & VS – Nastavení účtů a variabilních symbolů
• 🎨 Nastavení QR kódu – Vzhled a velikost
• 👁️ Viditelnost QR kódu – Kde se QR zobrazí
• 📋 Viditelnost platebních údajů – Co se zobrazí zákazníkovi
• 💱 Měny – Nastavení účtů pro různé měny
• 📄 Pluginy pro fakturaci – Integrace s PDF

---

4. Nastavení bankovního účtu a VS

4.1 Podporované platební metody

Vyberte platební metody, pro které chcete QR kódy zobrazovat. Standardně: Bankovní převod, Toret Platba na účet.

4.2 Variabilní symbol

Možnost	Kdy použít
ID objednávky	Standardní WooCommerce (doporučeno)
Číslo objednávky	WooCommerce čísla objednávek
Sequential Order Numbers	Plugin Sequential Order Numbers
Custom Order Numbers	Plugin Custom Order Numbers
PDF Invoices číslo faktury	VS z PDF Invoices pluginu

💡 Tip: Pro většinu eshopů stačí výchozí „ID objednávky“.

---

5. Nastavení vzhledu QR kódu

Text před a za QR kódem

Text před QR kódem: Zaplaťte prosím pomocí QR kódu:
Text za QR kódem: Děkujeme za vaši objednávku!

Zpráva pro příjemce platby

Můžete použít placeholdery:

• $order_id – ID objednávky
• $order_number – Číslo objednávky
• $first_name – Jméno zákazníka
• $last_name – Příjmení zákazníka

Příklad: Objednávka č. $order_number

Velikost QR kódu

• 128px – Malý
• 256px – Střední (doporučeno)
• 512px – Velký

---

6. Viditelnost QR kódu

Zobrazení v emailech

• ☑️ Viditelný při stavu „Čeká na platbu“ (On-hold)
• ☑️ Viditelný při stavu „Zpracovává se“ (Processing)
• Vlastní stav – Volitelně vyberte další stav

Zobrazení na Thank you page

• ☑️ Viditelný na stránce Děkujeme
• Hook – Kde se QR zobrazí (doporučeno: výchozí)

7. Viditelnost platebních údajů

Kromě QR kódu se zákazníkovi zobrazují i klasické platební údaje (číslo účtu, VS atd.).

Tabulka viditelnosti údajů

Pro každý bankovní účet zaškrtněte, co se má zobrazit:

• ☑️ IBAN – Zobrazit IBAN číslo
• ☑️ BIC – Zobrazit BIC/SWIFT
• ☑️ Číslo – Zobrazit klasické číslo účtu
• ☑️ VS – Zobrazit variabilní symbol

💡 Tip: Pro české účty obvykle stačí Číslo a VS. Pro mezinárodní platby zapněte IBAN a BIC.

---

8. Nastavení měn

Pro multi-měnový eshop můžete nastavit různé bankovní účty pro různé měny.

Aktivace multi-měny

• ☑️ Zobrazit účet pouze pro vybranou měnu

⚠️ Upozornění: QR kódy fungují pouze pro CZK a EUR!

Příklad nastavení

1. Účet CZ: 123456789/0100 → měna CZK
2. Účet EUR: CZ6508000000192000145399 → měna EUR

Výsledek:

• Objednávka v CZK → účet č. 1 s QR kódem
• Objednávka v EUR → účet č. 2 s QR kódem
• Objednávka v USD → výchozí účet BEZ QR

---

9. Integrace s PDF faktury

9.1 Toret Faktura

• ☑️ Přidat QR kód do dokumentu Toret Faktura

9.2 PDF Invoices & Packing Slips

Hook pro QR kódy v PDF:

• wpo_wcpdf_after_document_label – Za nadpisem (doporučeno)
• wpo_wcpdf_after_order_details – Za detaily objednávky

Nastavení textu a stylů:

• Text před QR kódem
• CSS styl textu před QR
• Text za QR kódem
• CSS styl QR obrázku

9.3 Booster for WooCommerce

Použijte shortcode v šabloně faktury:

[tqr_booster_img]

---

10. Časté otázky (FAQ)

❓ QR kód se nezobrazuje. Co dělám špatně?

Zkontrolujte:

1. Máte aktivovanou licenci?
2. Je „Bankovní převod“ zapnutý v platbách?
3. Máte vyplněné bankovní údaje?
4. Je zaškrtnuto zobrazení QR kódu?
5. Je metoda vybraná v „Podporované platební metody“?

❓ QR kód je v PDF příliš malý. Jak to změním?

V záložce Pluginy pro fakturaci → CSS styl QR obrázku:

width: 200px;
height: 200px;

❓ Podporuje plugin vícejazyčné weby?

Ano! Plugin je kompatibilní s Polylang. Texty můžete přeložit v Polylang → Překlady řetězců.

❓ Funguje s platbou zálohou?

Ano! Plugin automaticky detekuje zálohy a vygeneruje QR kód pro částku zálohy.

---

🎯 Rychlý návod – Nejčastější nastavení

Běžný český eshop

1. Licence: Zadejte a ověřte licenční klíč
2. Bankovní účet & VS: Ponechte výchozí (ID objednávky)
3. Nastavení QR: Text, velikost 256px, zpráva „Objednávka č. $order_number“
4. Viditelnost: Zapnout pro On-hold, Processing, Thank you page
5. Hotovo!

Multi-měnový eshop (CZK + EUR)

1. Nastavte dva účty ve WooCommerce
2. Měny: Zapnout multi-měnu, přiřadit CZK a EUR
3. Hotovo!

---

🔧 Řešení problémů

QR kód se nezobrazuje v PDF

Řešení:

• Vyberte jiný hook, např. wpo_wcpdf_after_order_details
• Ověřte, že allow_url_fopen je zapnuté na serveru

VS obsahuje písmena a QR nefunguje

Řešení:

• V nastavení VS zvolte „Přeskočit písmena“
• Nebo „VS ve zprávě příjemci“

Zobrazuje se více QR kódů najednou

Řešení:

• V Viditelnost QR kódu skryjte QR pro nepotřebné účty

---

📞 Potřebujete pomoc?

• 📖 Dokumentace: documentation.toret.cz/qr-platby
• 💬 Podpora: toret.cz/podpora
• 🌐 Web: toret.cz

---

Děkujeme, že používáte Toret QR Platby! 🎉