Funkce exportu a importu usnadňuje zálohování konfigurace pluginu Fakturoid pro WooCommerce a přenos mezi prostředími. Níže najdete kompletní postupy, bezpečnostní upozornění i doporučené scénáře.

Co export obsahuje

  • Všechna nastavení uložená v wc_fakturoid_settings – API přístup, mapování plateb, e-maily, refundy.
  • Další interní hodnoty jako wc_fakturoid_webhook_secret nebo bezpečnostní salt.
  • Licenční klíč vynechává – aktivaci je nutné zadat zvlášť.

Pozor: Exportovaný JSON může obsahovat citlivé údaje (Client Secret, Webhook Secret). Zacházejte s ním jako s hesly.

Kde funkci najdete

  1. Ve WordPressu otevřete České pluginy → Fakturoid pro WooCommerce.
  2. Přejděte na spodní záložku Export/Import.

Screenshoty:

  • Přepínač mezi kartami Export a Import.
  • Dialog pro stažení JSON.
  • Potvrzení o úspěšném importu se zelenou hláškou.

Postup – Export do JSON

  1. Na kartě Export klikněte na Stáhnout konfiguraci.
  2. Prohlížeč uloží soubor wc-fakturoid-settings-YYYY-MM-DD.json.
  3. Sdílejte ho pouze bezpečnou cestou (správce hesel, šifrované úložiště).
  4. Pro přehlednost soubor přejmenujte (např. prod-wc-fakturoid-2026-02-17.json).

Tip: Archivujte poslední dvě zálohy a starší mazejte. Minimalizujete riziko úniku dat.

Postup – Import ze souboru

  1. Otevřete kartu Import.
  2. Zvolte JSON kliknutím na Vybrat soubor.
  3. Stiskněte Importovat nastavení.
  4. Plugin okamžitě přepíše aktuální hodnoty daty ze souboru.
  5. Po dokončení zkontrolujte klíčové sekce a ujistěte se, že vše odpovídá novému prostředí.

Bezpečnost: Po importu smažte dočasné soubory na hostingu (WordPress je ukládá do wp-content/uploads).

Doporučené scénáře

  • Migrace staging → produkce: Exportujte na stagingu, přeneste bezpečně, importujte na produkci a upravte prostředí-specifická pole.
  • Záloha před úpravou: Před větší změnou stáhněte export. V případě chyby ho nahrajte zpět.
  • Multisite nasazení: Nakonfigurujte první web, exportujte a na ostatních importujte s úpravou slugů a licencí.

Jak pracovat s JSON ručně

  • Soubor otevřete v editoru (VS Code, Sublime, PhpStorm).
  • Dodržujte syntaxi – uvozovky, závorky a logické hodnoty true/false bez uvozovek.
  • Po úpravě ověřte validitu např. na jsonlint.com.

Varování: Jakákoli chyba v syntaxi způsobí, že import selže s hláškou „Soubor se nepodařilo dekódovat“.

Omezení a časté dotazy

  • Přenese import i tokeny? Ano, ale po přesunu na jiný server doporučujeme znovu uložit sekci Napojení na API.
  • Import selhal? Zkontrolujte formát JSON a velikost souboru. Upravovaný soubor znovu validujte.
  • Lze exportovat jen část nastavení? Ne – exportuje se celý balíček. Citlivé hodnoty případně smažte ručně před sdílením.
  • Jak často zálohovat? Při každé významné změně nebo před aktualizací pluginu/WooCommerce.

Doporučení pro screenshoty

  • Záložka Export s tlačítkem „Stáhnout konfiguraci“.
  • Průběh ukládání souboru v prohlížeči.
  • Dialog importu se zvoleným souborem a potvrzením.

Související kapitoly

Po importu vždy projděte citlivé sekce a případně znovu vygenerujte security salt nebo webhook secret – staré odkazy a podpisy se tím zneplatní.