PrestaShop Checkout i płatności

DataFirefly Address Lookup: autouzupełnianie adresu w checkoucie PrestaShop 8 i 9

Autouzupełnianie adresu w checkoucie: bezpłatne francuskie API plus opcjonalne Google Places

Ogranicz błędy adresowe i przyśpiesz składanie zamówienia. Klient wpisuje kod pocztowy, miasto uzupełnia się samo. Wpisuje ulicę, pojawia się pełny adres.

PrestaShop 8 i 9 Bezpłatne francuskie API Przyjazny RODO Bez bazy danych
  • Zwrot w 30 dni
  • 12 miesięcy aktualizacji
  • Wsparcie 24 h
www.datafirefly.com/pl/
Autouzupełnianie adresu przy kasie PrestaShop
v1.0.0 · zaktualizowano 2026-05-15
Co robi

W skrócie.

01

Bezpłatne francuskie API

Napędzane przez api-adresse.data.gouv.fr, oficjalne API państwa francuskiego oparte na Base Adresse Nationale. Bez klucza, bez odczuwalnych limitów, z pełnym pokryciem terytorium.

02

Google Places opcjonalnie

Dla klientów spoza Francji, w tym z Polski, podłącz swój klucz Google Places i korzystaj z pokrycia światowego. Ograniczenie listą dozwolonych krajów.

03

Kod pocztowy, potem miasto, potem ulica

Klient wpisuje kod pocztowy: miasto pojawia się automatycznie. Wpisuje początek nazwy ulicy: podpowiedź uzupełnia adres, numer i potwierdza kod pocztowy.

04

PrestaShop 8 i 9

Zgodny z motywami Classic i Hummingbird, z checkoutem jednostronicowym i wieloetapowym. Standardowe hooki, zero nadpisań szablonów, zero tabel w bazie danych.

Wersja pełna

Wszystko, co warto wiedzieć, zanim zainstalujesz.

Szczegółowe spojrzenie na to, jak działa DataFirefly Address Lookup: autouzupełnianie adresu w checkoucie PrestaShop 8 i 9, dlaczego zbudowaliśmy go w ten sposób i jaka myśl stoi za powyższymi funkcjami.

§ 01

Niewidoczny problem, który kosztuje: źle wpisane adresy

Jeden klient na dziesięciu wpisuje swój adres z literówką, niepełną nazwą ulicy albo błędnym kodem pocztowym. Efekt: zwrócone przesyłki, koszty ponownej wysyłki, przeciążona obsługa klienta, koszyki porzucone w momencie checkoutu. W PrestaShop natywny formularz adresowy nie oferuje żadnej pomocy: klient wpisuje na ślepo. DataFirefly Address Lookup rozwiązuje ten problem, zamieniając formularz adresowy w inteligentnego asystenta, który podpowiada, uzupełnia i weryfikuje w czasie rzeczywistym.

§ 02

Francuskie API BAN, bezpłatne i oficjalne

Moduł domyślnie używa api-adresse.data.gouv.fr, oficjalnego API państwa francuskiego. To ta sama baza, z której korzystają francuskie usługi pocztowe i systemy publiczne: pełne pokrycie terytorium, ciągła aktualizacja, znormalizowane adresy. Bez klucza API, bez abonamentu, bez kosztów użycia. Zapytania idą bezpośrednio z przeglądarki klienta do API, więc Twój serwer nigdy nie jest obciążany, a Twoje łącze nie jest zużywane.

§ 03

Google Places do adresów polskich i międzynarodowych

Jeśli sprzedajesz w Polsce albo w innych krajach, włącz silnik Google Places jako uzupełnienie. Wpisz swój klucz API w konfiguracji, ogranicz go po referrerze HTTP w Google Cloud Console, a moduł automatycznie przełączy się na Google, gdy klient wybierze kraj inny niż Francja. Możesz też ograniczyć Google do listy krajów (na przykład PL, CZ, SK, DE), aby kontrolować swój budżet Google Cloud. Dla sklepu działającego głównie w Polsce to Google Places będzie silnikiem podstawowym.

§ 04

Przepływ klienta: kod pocztowy, miasto, ulica

Klient zaczyna wypełniać adres. Wpisuje kod pocztowy: jeśli pasuje tylko jedna miejscowość, miasto uzupełnia się samo, w przeciwnym razie pojawia się selektor miast. Zaczyna wpisywać ulicę: moduł odpytuje bazę adresową z filtrem po znanym już kodzie pocztowym i proponuje pasujące adresy. Jedno kliknięcie i trzy pola wypełniają się naraz znormalizowanym adresem. Trzy interakcje, zero zbędnego pisania.

§ 05

Integracja bez tarcia na wszystkich checkoutach

Moduł podłącza się do standardowego hooka actionFrontControllerSetMedia i wstrzykuje swój JavaScript oraz CSS wyłącznie na stronach zawierających formularz adresowy: zamówienie, mój adres, moje dane, rejestracja. Zero nadpisań szablonów Smarty. Zero tabel w bazie danych. Zero zależności od konkretnego motywu: Classic, Hummingbird i większość motywów zewnętrznych działa bez konfiguracji.

§ 06

Odporność: zgodność z checkoutem jednostronicowym i wieloma formularzami

Jednostronicowy checkout PrestaShop przeładowuje formularz adresowy przy każdej zmianie kroku, a niektóre rozszerzenia zewnętrzne robią to samo. Moduł obsługuje te przeładowania dzięki MutationObserver połączonemu z natywnymi zdarzeniami PrestaShop: updatedAddressForm, updatedAddress, updatedDeliveryForm, changedCheckoutStep. Jeśli wyświetlone są dwa formularze adresowe naraz (dostawa i faktura), każdy otrzymuje własne, niezależne autouzupełnianie.

§ 07

Wydajność i prywatność: bez serwera pośredniego

Wszystkie zapytania autouzupełniania idą bezpośrednio z przeglądarki klienta do wybranego API (BAN albo Google). Twój serwer PrestaShop nigdy nie jest angażowany przez moduł w trakcie wpisywania: zero obciążenia CPU, zero zużytego łącza, zero dodanego opóźnienia. Po stronie RODO: żaden przepływ danych przez DataFirefly, żadne zbieranie danych po stronie DataFirefly, żadne ciasteczka zewnętrzne zakładane przez moduł.

§ 08

Konfiguracja w dwie minuty

Zainstaluj moduł, otwórz jego konfigurację i dla Francji działa od razu. Dla Google Places: włącz opcję, wklej swój klucz, wybierz listę dozwolonych krajów. Ustaw minimalną liczbę znaków przed uruchomieniem podpowiedzi, opóźnienie debounce oraz włączenie albo wyłączenie podświetlania pasujących fragmentów. Ani jednej linii kodu do zmiany.