Rádi vám představujeme nejnovější verzi našeho oblíbeného pluginu pro automatickou kontrolu plateb u Fio banky. Verze 1.6.0 přináší zásadní vylepšení v oblasti ladění, modernizaci kódu a řadu nových funkcí, které vám usnadní správu a diagnostiku plateb.
🚀 Hlavní novinky verze 1.6.0
1. Pokročilý systém ladění a diagnostiky
Nová verze obsahuje komplexní systém pro ladění, který vám pomůže rychle identifikovat a vyřešit případné problémy.
2. Modernizace kódu s Namespace strukturou
Plugin nyní používá moderní PHP namespace architekturu pro lepší organizaci kódu a eliminaci konfliktů s jinými pluginy.
3. Inteligentní rate limiting
Implementovali jsme chytré omezení četnosti API volání, které respektuje limity FIO banky (30 sekund mezi požadavky).
4. Vylepšená bezpečnost a výkonnost
Všechny API volání jsou nyní více zabezpečená a optimalizovaná pro lepší výkon.
🔧 Nová funkce ladění – Kompletní návod
Aktivace režimu ladění
- Přejděte do administrace WordPress
WooCommerce → Nastavení → Platby → FIO Kontrola plateb - Najděte sekci „Ladění a diagnostika“
Scroll dolů na konec stránky s nastavením
Sekce je označená ikonou 🔧 - Zapněte ladění
Zaškrtněte políčko „Ladění“
Popis: „Zapnout detailní logování chyb a aktivit pluginu do WordPress error logu + zobrazit nástroj pro test FIO API připojení“ - Uložte nastavení
Klikněte na „Uložit změny“
Co se stane po zapnutí ladění?
Po aktivaci režimu ladění se vám zobrazí nová sekce „Test připojení k FIO API“ s následujícími funkcemi:
🧪 Test připojení k FIO API
Tlačítko „Test připojení“
- Automaticky testuje všechny vaše FIO API tokeny
- Zobrazuje detailní výsledky pro každý token
- Odhaduje čas potřebný pro test (30s prodleva mezi tokeny)
Co test kontroluje:
- ✅ Platnost API tokenu
- ✅ Síťové připojení k FIO API
- ✅ Rate limiting (dodržování 30s intervalu)
- ✅ Strukturu odpovědi z API
- ✅ Dostupnost účtu a posledních transakcí
📋 Textové pole s výsledky testu
Po spuštění testu se zobrazí detailní report obsahující:
=== Test připojení k FIO API (11.08.2025 10:30:15) ===
Testování 2 tokenů...
⏱️ Odhadovaný čas: ~30 sekund (30s prodleva mezi tokeny)
--- Testování tokenu 1/2 ---
🔑 Token: aBcD...eFgH (první 4 a poslední 4 znaky)
📡 Testování připojení...
✅ API token je platný
✅ Připojení k FIO API úspěšné (HTTP 200)
✅ JSON odpověď je validní
ℹ️ Informace o účtu:
- Číslo účtu: 1234567890/2010
- Měna: CZK
- Datum od: 2025-08-04
- Datum do: 2025-08-11
- Počet transakcí: 15
⏳ Čekání 30 sekund před dalším tokenem (rate limiting)...
--- Testování tokenu 2/2 ---
...📝 Detailní logování
Když je ladění zapnuté, plugin automaticky loguje:
Do WordPress error.log:
- Všechny API požadavky na FIO banku
- Rate limiting informace
- Chyby při párování plateb
- Debug informace o zpracování transakcí
Příklady log záznamů:
[11-Aug-2025 08:30:15 UTC] FIO Checker: Rate limit - čekání 25 sekund
[11-Aug-2025 08:30:45 UTC] FIO Checker: Načítání dat z FIO API pro token aBcD****
[11-Aug-2025 08:30:46 UTC] FIO Checker: Nalezeno 12 nových transakcí
[11-Aug-2025 08:30:47 UTC] FIO Checker: Spárována platba 123456 s objednávkou #1001🔍 Interpretace výsledků testů
✅ Úspěšný test znamená:
- Token funguje správně
- Připojení k FIO API je stabilní
- Účet je dostupný a aktivní
- Plugin může normálně načítat transakce
❌ Možné chyby a jejich řešení:
„Token je neplatný“
- Zkontrolujte, zda je token správně zkopírován
- Ověřte v FIO internetbanking, že je token stále aktivní
„Síťová chyba připojení“
- Problém s internetovým připojením
- Dočasná nedostupnost FIO API
- Firewall blokuje připojení
„Rate limit překročen“
- Normální situace – plugin čeká 30 sekund
- Jiná aplikace už volala API
„Neplatná JSON odpověď“
- Dočasná chyba FIO API
- Zkuste test opakovat za chvíli
📊 Monitoring výkonu
S aktivním laděním můžete sledovat:
- Četnost API volání – v error.log
- Časy odpovědi FIO API
- Úspěšnost párování plateb s objednávkami
- Rate limiting dodržování
🚨 Kdy ladění vypnout?
Doporučujeme ladění používat pouze:
- ✅ Při řešení problémů
- ✅ Při nastavování nových tokenů
- ✅ Pro pravidelné kontroly (jednou týdně)
Vypněte ladění když:
- ❌ Plugin funguje bez problémů
- ❌ Error.log se příliš plní
- ❌ Pro běžný provoz
🏗️ Technické vylepšení v 1.6.0
Namespace architektura
WooFioChecker\
├── Plugin (hlavní třída)
├── Admin\
│ ├── Settings (nastavení)
│ └── PostsList (správa plateb)
└── Core\
├── Functions (FIO API komunikace)
└── Helpers (pomocné funkce)Vylepšená bezpečnost
- Všechny API tokeny jsou nyní maskovány v logách
- Lepší sanitizace vstupních dat
- Ochrana před rate limiting abuse
Optimalizace výkonu
- Minimalizace API volání
- Chytré cache mechanismy
- Rychlejší zpracování velkého množství transakcí
📈 Statistiky a metriky
Plugin nyní poskytuje detailní informace o:
- Počtu zpracovaných transakcí
- Úspěšnosti párování plateb
- Výkonu API volání
- Rate limiting compliance
🔄 Upgrade z předchozí verze
Upgrade je plně automatický:
- Aktualizujte plugin standardním způsobem
- Všechna nastavení zůstanou zachována
- Žádná dodatečná konfigurace není potřeba
🆘 Podpora a řešení problémů
Krok 1: Zapněte ladění
Podle návodu výše zapněte režim ladění a proveďte test připojení.
Krok 2: Analyzujte výsledky
Podívejte se na výsledky testu a error.log záznamy.
Krok 3: Kontaktujte podporu
Pokud problém přetrvává, kontaktujte naši podporu na support@ceskepluginy.cz s:
- Výsledky testu připojení
- Relevantní záznamy z error.log
- Popis problému
📝 Changelog verze 1.6.0
✨ Nové funkce
- Pokročilý systém ladění a diagnostiky
- Test připojení k FIO API s detailními výsledky
- Inteligentní rate limiting (30s mezi API voláními)
- Modernizace kódu s PHP namespace strukturou
- Vylepšené logování a error reporting
🔧 Vylepšení
- Optimalizace výkonu API komunikace
- Lepší zabezpečení API tokenů
- Vylepšená správa chyb a výjimek
- Konzistentnější uživatelské rozhraní
- Detailnější error reporting
🐛 Opravené chyby
- Vyřešeno párování plateb u vysokého objemu transakcí
- Opraveno načítání dat při změně časového rozsahu
- Stabilizace při dočasné nedostupnosti FIO API
- Opraveno zobrazení dat u různých formátů účtů
🔒 Bezpečnost
- Vylepšená validace vstupních dat
- Lepší ochrana API tokenů v logách
- Bezpečnější zpracování dat z FIO API
