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:
– Vytorený účet na Swiftyper (aj bezplatný)
– Kľúč API Swiftyper s povoleným obmedzením domény.
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.
== Licencia ==
Tento plugin je licencovaný pod licenciou GPLv2 alebo novšou.