Pridáva automatické dopĺňanie adresy pomocou Swiftyperu do pokladne WooCommerce (fakturácia a doprava).
== Popis ==
Tento plugin integruje službu Swiftyper Places do pokladne WooCommerce na automatické dopĺňanie polí ulice, mesta a PSČ.
Hlavné vlastnosti:
– Automatické dopĺňanie fakturačnej a/alebo dodacej adresy (prepínanie podľa rozsahu).
– Minimálna dĺžka pre zníženie volaní API (konfigurovateľné).
– Obmedzenie krajiny: postupujte podľa krajiny pokladne alebo vyberte viacero krajín (SK, CZ, PL, AT, CH, LI).
– Lokálna kópia SDK Swiftyper JS (bez externého odľahčovania).
– Tlačidlo „Test API kľúča“ pre správcu s overením na strane servera a prehľadnou diagnostikou.
Čo potrebujete:
– Kľúč API Swiftyper Places s povoleným obmedzením domény. Pozrite si https://developers.swiftyper.sk/places
Súkromie:
– Frontend používa verejný kľúč, ktorý poskytnete; obmedzte ho podľa domény v konzole Swiftyper.
== Inštalácia ==
1. Nahrajte doplnok a aktivujte ho.
2. Po aktivácii budete presmerovaní na: WooCommerce → Nastavenia → Automatické dopĺňanie adresy (Swiftyper).
3. Zadajte svoj kľúč Swiftyper Places API (obmedzený na doménu) a kliknite na tlačidlo „Testovať kľúč API“.
4. Vyberte:
– Povoliť pre fakturáciu a/alebo dopravu.
– Minimálny počet znakov pred vyhľadávaním (napr. 3).
– Krajiny, v ktorých sa má vyhľadávať (viacnásobný výber). Ponechajte prázdne, aby nasledovalo pole krajiny pokladne.
5. Uložte zmeny.
== Často kladené otázky ==
= „Testovací kľúč API“ zobrazuje chybu 400/Nepodporovaná požiadavka =
– Uistite sa, že používate kľúč Places.
– Overte, či je v konzole Swiftyper povolený presný pôvod vašej stránky (schéma + doména + port).
= Môžem obmedziť, kde je povolené automatické dopĺňanie? =
Áno. Použite dve začiarkavacie políčka na povolenie fakturácie a/alebo dopravy.
= Ako znížim počet volaní API počas písania? =
Použite nastavenie „Minimálny počet znakov“ (napr. 3 začína zhodou od 3. znaku).
= Ako fungujú krajiny? =
– Ak v administrácii vyberiete krajiny, automatické dopĺňanie vyhľadá iba tie (napr. SK + CZ).
– Ak nie sú vybrané žiadne, nasleduje hodnota vybranej krajiny WooCommerce.
= Je Swiftyper SDK načítaný z CDN? =
Nie. Lokálna kópia je súčasťou súboru assets/swiftyper.js, aby spĺňala požiadavky kontroly doplnkov.
== Snímky obrazovky ==
1. Nastavenia administrátora s testom kľúča API, prepínačmi, minimálnou dĺžkou a výberom viacerých krajín.
2. Pole adresy pokladne s návrhmi.
== Denník zmien ==
= 1.0.1 =
– Pridaný „Testovací kľúč API“ AJAX na strane servera (vyhýba sa CORS a zobrazuje čitateľné chyby).
– Pridané nastavenie minimálnej dĺžky pre prah vyhľadávania.
– Pridaný výber viacerých krajín (SK, CZ, PL, AT, CH, LI).
– Vylepšená robustnosť frontendu (žiadne dvojité viazanie, rešpektuje prepínače fakturácie/dopravy).
– Zatvorenie rozbaľovacej ponuky pri výbere.
– Pridaná lokálna SWIFTYPER SDK; odstránené používanie CDN na úspešné vykonanie kontroly pluginu.
– Vylepšené overovanie nonce a čistenie vstupov pre nastavenia a AJAX.
== Oznámenie o aktualizácii ==
= 1.0.1 =
Prepína na lokálnu SWIFTYPER SDK a pridáva nové nastavenia. Skontrolujte stránku administrátora a znova uložte konfiguráciu.
== Licencia ==
Tento plugin je licencovaný pod licenciou GPLv2 alebo novšou.