Adresy.appWtyczka WooCommerce — autocomplete i walidacja adresów PRG
Oficjalna wtyczka adresy.app dla WooCommerce. Autocomplete polskich adresów z bazy PRG (30 mln+ punktów adresowych), walidacja w locie i tryb blokowania checkout — gotowa do użycia po wgraniu pliku ZIP w panelu WordPress.
Co robi wtyczka?
Wtyczka adresy.app dla WooCommerce podłącza się do formularza checkout i dodaje dwie funkcje:
- Autocomplete — gdy klient zaczyna wpisywać adres, pojawia się lista podpowiedzi z oficjalnej bazy PRG (GUGiK). Po wybraniu adresu pola ulicy, miasta i kodu pocztowego wypełniają się automatycznie.
- Walidacja — po opuszczeniu pola adresu (zdarzenie
blur) wtyczka sprawdza, czy wpisany adres istnieje w PRG. Jeśli nie — wyświetla ostrzeżenie lub blokuje przejście do płatności.
Instalacja
- Pobierz plik ZIP z wtyczką (przycisk powyżej).
- W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wgraj wtyczkę.
- Wgraj plik ZIP i kliknij Zainstaluj teraz, a następnie Aktywuj.
- Przejdź do WooCommerce → Ustawienia → Adresy.app i wklej klucz API z panelu api.adresy.app.
- Gotowe — odśwież checkout i przetestuj autocomplete.
Konfiguracja
| Opcja | Opis | Domyślnie |
|---|---|---|
| Klucz API | Klucz z panelu adresy.app — wymagany dla limitów powyżej planu Free | anonymous |
| Tryb walidacji | warn — ostrzeżenie, block — blokada checkout | warn |
| Autocomplete | Włącz / wyłącz podpowiedzi w polu adresu | włączone |
| Override | Pokazuje checkbox „mój adres nie ma w rejestrze PRG" | włączone |
Tryb warn vs block
W trybie warn klient widzi żółte ostrzeżenie, ale może kontynuować zakup — może zaznaczyć checkbox Mój adres nie istnieje w rejestrze PRG. W trybie block przycisk „Złóż zamówienie" jest nieaktywny, dopóki adres nie zostanie potwierdzony lub zaznaczony checkbox override.
Wymagania
- WordPress 5.8+
- WooCommerce 6.0+
- PHP 7.4+
- Klucz API adresy.app (plan Free wystarczy do 3 000 zapytań/mies.)
Funkcje
- Autocomplete adresów z bazy PRG (30 mln+ punktów adresowych)
- Walidacja w locie — tryb warn lub block
- Checkbox override dla adresów spoza rejestru
- Konfiguracja przez panel WordPress — bez edycji kodu
- Zgodność z WooCommerce 6.x, 7.x, 8.x
- Lekki frontend (~8 kB JS + CSS)
Najczęściej zadawane pytania
Czy wtyczka działa z moim motywem?
Wtyczka podpina się do standardowych pól WooCommerce (
#billing_address_1, #billing_city, #billing_postcode). Działa z większością motywów — w tym Storefront, Flatsome, Divi i OceanWP.Czy autocomplete działa bez klucza API?
Tak — bez klucza API wtyczka działa w trybie anonimowym z limitem planu Free (30 req/min, 3 000 req/mies.). Dla sklepów z dużym ruchem zalecamy klucz API na planie Starter lub Business.
Czy wtyczka obsługuje adres rozliczeniowy i adres dostawy?
Domyślnie obsługuje adres rozliczeniowy (billing). W ustawieniach można włączyć także pole adresu dostawy (shipping address).
Czy wtyczka spowalnia stronę?
Nie — skrypt ładuje się asynchronicznie, a zapytania do API mają debounce 300 ms. Odpowiedź API wynosi poniżej 50 ms.