Tato kapitola vysvětluje, jak plugin pracuje s e-maily WooCommerce a jak vytváří zabezpečené odkazy na stažení faktur. Vše nastavíte v sekci E-maily a bezpečné odkazy na stránce pluginu.

Cíl sekce

  • Rozhodnout, zda se PDF faktury přikládá k e-mailům.
  • Nastavit, zda se místo PDF preferuje webová linka (Webfaktura).
  • Spravovat bezpečnostní salt, který chrání odkazy ke stažení.

Kde najít nastavení

  1. WordPress administrace → České pluginy → Fakturoid pro WooCommerce.
  2. Sjeďte k sekci E-maily a bezpečné odkazy (nachází se za webhooky).

Screenshot checklist:

  • Celá sekce v adminu s viditelnými přepínači.
  • Příklad e-mailu „Objednávka dokončena“ s vloženým odkazem nebo přílohou.
  • Front-end detail objednávky s tlačítky ke stažení.

Popis voleb

1. Přikládat PDF fakturu do e-mailu

Co dělá: Pokud je zaškrtnuto, plugin stáhne PDF z Fakturoidu a připojí ho ke WooCommerce e-mailu „Objednávka dokončena“.

  • Výhody: Zákazník dostane vše okamžitě, vhodné pro B2B odběratele.
  • Nevýhody: PDF může zabírat místo v e-mailové schránce, časté vylučování do spamu.
  • Tip: Pokud máte mnoho objednávek denně, sledujte velikost adresáře wp-content/uploads/wc-fakturoid/ – plugin ukládá PDF lokálně.

2. Preferovat webovou fakturu (linka v e-mailu)

Co dělá: Do e-mailu vkládá HTML linku na webovou verzi faktury ve Fakturoidu. PDF se přestane přikládat (i když je první volba zapnutá).

  • Kdy použít: Když nechcete posílat přílohy (filtry spamu, sdílení odkazů s účetní).
  • Poznámka: Webová linka vyžaduje aktivní token ve Fakturoidu; pokud zákazníkovi vyprší session, vyžádá si nová hesla.

3. Bezpečnostní salt pro download tokeny

  • Popis: Tajný řetězec používaný pro výpočet HMAC tokenu, který chrání odkazy ke stažení (přes pluginový endpoint fakturoid-invoice).
  • Chování:
    • Generuje se automaticky při instalaci.
    • Můžete ho obnovit tlačítkem Vygenerovat bez reloadu stránky.
    • Po změně staré odkazy přestanou fungovat – zákazníky informujte.
  • Tip: Salt držte v tajnosti, nikde ho veřejně nepublikujte.

Jak vypadá e-mail zákazníka

  • Pokud je zapnuté PDF → e-mail „Objednávka dokončena“ obsahuje přílohu typu faktura-XXXX.pdf.
  • Pokud preferujete web → e-mail obsahuje odstavec „Stáhnout fakturu: PDF / zobrazit online“ s odkazy.

Screenshot (doporučený): Zachyťte e-mail v HTML podobě s uvedenými odkazy. Doporučené rozlišení 1280×720, citlivé údaje začernit.

Bezpečné odkazy na front-endu

  • Na stránce „Můj účet → Objednávky → Detail“ se zobrazují tlačítka pro stažení.
  • Odkazy ve tvaru https://vasedomena.cz/fakturoid-invoice/{id}?download_token=...
  • Token je kombinací salt + e-mail zákazníka + datum vytvoření objednávky → platný minimálně 24 hodin.*
  • Pokud zákazník zadá špatný e-mail (podle objednávky), odkaz ho nepustí ke stažení.

*Token se přepočítává na základě „bucketu“ času, který vychází z data vytvoření objednávky. Pokud zákazník žádá odkaz po několika dnech, získá nový token (platný opět 24 hodin od vytvoření).

Generování nového salt

  1. V sekci klikněte na tlačítko Vygenerovat.
  2. Salt se automaticky zapíše do formuláře a uloží do databáze (AJAX požadavek).
  3. Staré odkazy přestanou fungovat okamžitě.
  4. V e-mailu nebo na front-endu se vytvoří všechny odkazy s novým tokenem.

Screenshot: Zaznamenejte upozornění po vygenerování (WordPress upozornění „Salt byl úspěšně vygenerován“).

Doporučení a best practices

  • Testovací objednávka: Po změně salt vždy vytvořte nebo upravte testovací objednávku, abyste ověřili funkčnost linků.
  • Pravidelná kontrola složky wc-fakturoid v uploads: Pokud generujete mnoho PDF, naplánujte cron, který staré soubory maže (plugin sám nečistí).
  • Podpora mobilních zařízení: Pokud zákazníci často otevírají e-maily v mobilu, ověřte, že odkazy jsou snadno kliknutelné a srozumitelně popsané.

Nejčastější potíže

ProblémPravděpodobná příčinaŘešení
Příloha PDF chybíFakturoid dočasně nevrátil PDFZkontrolujte log, případně použijte webovou linku jako fallback.
Odkaz hlásí „Přístup odepřen“E-mail zákazníka neodpovídáOvěřte e-mail objednávky; při ruční úpravě e-mailu se token invaliduje.
Odkaz vede na 404Permalink pro endpoint není zaregistrovánAktivujte plugin, nebo ručně přiřaďte endpoint (viz flush_permalinks).
Salt je prázdnýAJAX neproběhl kvůli právůmZkontrolujte konzoli prohlížeče. Uživatel musí mít právo spravovat plugin.

Jak udělat kvalitní screenshoty

  1. Připravte testovací objednávku s vystavenou fakturou.
  2. Otevřete e-mail a detail objednávky v režimu Chrome DevTools, pokud potřebujete simulovat mobil.
  3. V e-mailu vyznačte odkaz nebo přílohu (např. zvýrazňovačem v editoru obrázků).
  4. Na front-endu vyfoťte tlačítka pro stažení PDF a webové faktury.

Související dokumenty

Pokračujte na diagnostiku a logování, abyste měli jistotu, že všechny e-maily a odkazy fungují a případné chyby rychle dohledáte.