Tato kapitola popisuje, jak plugin Fakturoid pro WooCommerce ukládá diagnostické informace a jak je využít při řešení problémů. Pokrývá jak WordPress debug log, tak interní tabulku wc_fakturoid_api_logs dostupnou přímo v administraci.

K čemu logování slouží

  • Debug logování (WordPress) – záznamy o chybách, upozorněních a hookech v souboru wp-content/debug.log.
  • Logování volání Fakturoid API – detailní přehled každé komunikace s API v databázi. V UI dostupné přes admin stránku České pluginy → Logy Fakturoid.
  • Retence logů – automatické mazání starých záznamů, aby databáze nerostla do nekonečna.

Kde nastavení najdete

  1. WordPress administrace → České pluginy → Fakturoid pro WooCommerce.
  2. Sekce Diagnostika a logování (téměř na konci stránky).

Screenshoty:

  • Celý blok s přepínači logování.
  • Admin stránka „Logy Fakturoid“ s vyfiltrovaným záznamem.
  • Detail logu v databázi (pokud potřebujete dokumentovat JSON odpověď).

Pole v sekci – vysvětlení

1. Zapnout debug logování

  • Co dělá: Aktivuje WP_DEBUG_LOG, aby se všechny zprávy zapisovaly do wp-content/debug.log.
  • Doporučení: Zapínejte pouze dočasně při ladění.
  • Upozornění: Velké logy mohou zabírat místo a prozrazovat interní informace. Po vyřešení potíží logování vypněte a soubor smažte.

2. Logování volání Fakturoid API

  • Možnosti:
    • Vypnuto
    • Pouze chyby
    • Všechna volání
  • Doporučení:
    • Běžný provoz → Pouze chyby
    • Ladění připojení nebo webhooků → dočasně Všechna volání
  • Kam se loguje: Do databázové tabulky wp_wc_fakturoid_api_logs (prefix wp_ závisí na instalaci).
  • Prohlížení: V menu České pluginy se objeví položka Logy Fakturoid s přehledem ve formátu WP_List_Table.

3. Automatické mazání API logů

  • Čísla: 0 (vypnuto), 7, 30, 90, 180, 365 dní.
  • Chování: Cron plánuje denní úlohu, která smaže starší záznamy. Hodnota 0 znamená, že logy zůstávají navždy.
  • Tip: Zvažte strategii retence podle interních pravidel (např. 30 dní pro e-shop s nižším trafficem, 90 dní pro B2B).

4. Smazat data při odinstalaci

  • Popis: Pokud je zaškrtnuto, při odinstalaci pluginu se odstraní nastavení, logy, tabulky a tokeny.
  • Pozor: Tato volba nemá vliv na běžné deaktivace – týká se pouze akce „Odinstalovat“ na stránce Pluginy.

Logy Fakturoid v administraci

Po zapnutí logování API uvidíte v menu položku České pluginy → Logy Fakturoid. Obsahuje tabulku s těmito sloupci:

  • Čas (created_at)
  • Metoda (GET, POST…)
  • Endpoint
  • Status (HTTP kód)
  • Chyba (stručná hláška, pokud nastala)
  • Detaily – zkrácený výpis query, request a response.

Filtrace: V horní části tabulky je vyhledávací pole; můžete hledat podle endpointu, chybové hlášky nebo části JSON odpovědi.

Screenshot: Ukázka tabulky se zvýrazněným řádkem – vhodné pro dokumentaci případných incidentů.

Postup pro řešení problémů

  1. Zapněte debug a API logy (všechna volání).
  2. Replikujte problém – např. vystavte fakturu, odešlete webhook.
  3. Otevřete Logy Fakturoid a vyfiltrujte nejnovější záznam.
  4. Zkontrolujte sloupec Status a Chyba.
  5. Klikněte na detail (pokud potřebujete), zkopírujte JSON a odešlete technické podpoře.
  6. Po analýze logy vypněte a starší záznamy smažte.

Tip: Při komunikaci s podporou přiložte číslo objednávky, ID faktury a výřez logu. Urychlí to analýzu.

Nejčastější chybové kódy a řešení

StatusVýznamDoporučený postup
401Unauthorized – špatný tokenZnovu uložte „Napojení na API“, aby se token obnovil.
403Forbidden – přístup zakázánOvěřte, že OAuth má správná oprávnění.
404Not Found – endpoint neexistujeZkontrolujte URL (např. chyba v ID faktury).
422Unprocessable Entity – špatná dataPodívejte se na error_message, často chybějící povinné pole.
429Too Many Requests – limit APIPočkejte pár minut, Fakturoid má rate limit 60 požadavků/min.
500Server ErrorDočasný problém na straně Fakturoidu, zkuste znovu později.

Práce s debug.log

  • Soubor je umístěný v wp-content/debug.log.
  • Ujistěte se, že WP_DEBUG_LOG je zapnutý (plugin ho přepíná za vás).
  • Před sdílením logu smažte hesla, tokeny a osobní údaje, které se mohou v logu objevit.
  • Po vyřešení potíží log vypněte a soubor smažte, aby se zmenšila velikost instalace.

Doporučení pro screenshoty

  • Nastavení diagnostiky v adminu – zvýraznit přepínače a vybranou retenci.
  • Tabulka logů se záznamem chyby (např. 401 Unauthorized).
  • Výpis debug.log v editoru (např. VS Code) s relevantní částí.

Související témata

Po nastavení logování můžete pokračovat ke kapitolám o refundech a automatizaci storen, abyste pokryli celý životní cyklus objednávky.