Moduł PrestaShop — autocomplete i walidacja adresów PRG
Oficjalny moduł adresy.app dla PrestaShop. Autocomplete adresów z bazy PRG (GUGiK) i walidacja w formularzu adresu dostawy — instalacja przez panel administracyjny, bez modyfikacji szablonów .tpl.
Co robi moduł?
Moduł adresy.app dla PrestaShop dodaje autocomplete i walidację polskiego adresu do formularza dostawy w procesie zakupowym. Działa przez wbudowany hook PrestaShop — nie wymaga modyfikacji plików szablonów.
Instalacja
- Pobierz archiwum ZIP modułu (przycisk powyżej).
- W panelu PrestaShop przejdź do Moduły → Menedżer modułów → Załaduj moduł.
- Załaduj plik ZIP i zatwierdź instalację.
- Po instalacji kliknij Konfiguruj i wklej klucz API z panelu api.adresy.app.
- Przetestuj autocomplete na stronie checkout.
Opcje konfiguracyjne
- Klucz API — wymagany dla limitów powyżej planu Free
- Tryb walidacji —
warn(ostrzeżenie) lubblock(blokada formularza) - Override — checkbox dla adresów spoza PRG z opcjonalnym komunikatem o dodatkowych kosztach dostawy
Wymagania
- PrestaShop 1.7.6+ lub 8.x
- PHP 7.4+
- Klucz API adresy.app
Funkcje
- Autocomplete z bazy PRG (30 mln+ punktów adresowych)
- Instalacja przez panel modułów PrestaShop
- Tryb warn lub block
- Checkbox override dla adresów spoza rejestru PRG
- Kompatybilny z PrestaShop 1.7 i 8.x
- Walidacja na zdarzeniu blur — bez przeładowania strony
Najczęściej zadawane pytania
Czy moduł działa z PrestaShop 8?
Tak — moduł jest kompatybilny z PrestaShop 1.7.6+, 8.0 i 8.1.
Czy autocomplete waliduje tylko polskie adresy?
Tak — moduł aktywuje autocomplete i walidację tylko gdy klient wybierze Polskę jako kraj dostawy. Dla innych krajów formularz działa standardowo.
Czy moduł wymaga modyfikacji szablonów .tpl?
Nie — moduł korzysta z hooków PrestaShop i wstrzykuje skrypt dynamicznie. Żadne pliki szablonów nie są modyfikowane.