Belgian Address Autocomplete: konfiguracja i pomoc

• Belgijskie podpowiedzi adresów. Oficjalne rejestry regionalne w natywnych formularzach konta i zamówienia, także dla gości.
• Uzupełniane razem. Ulica i numer domu, czterocyfrowy kod oraz miasto z wybranej podpowiedzi.
• Stały zakres: Belgia. Flandria, Bruksela i Walonia razem; lokal i samą ulicę uzupełniasz ręcznie.
• Zaplecze. Pomoc pracownikom przy adresach w Klienci > Adresy.
• Codzienne wpisywanie. Dotyk, klawiatura i komunikaty czytników ekranu; wpisywanie ręczne nadal działa.
• Bez konta usługi. Darmowy moduł i dane regionalne, cztery przełączniki, bez klucza.

• Podpowiadaj adresy podczas wpisywania przez klienta: główny przełącznik, pierwszy w formularzu.
• W formularzu adresu na koncie klienta: natywne adresy konta.
• W formularzach adresu podczas zamówienia (także dla gości i osobnych adresów do faktury): także goście i osobne adresy do faktury.
• W formularzu adresu w panelu administracyjnym (adresy klientów, nowe zamówienia): adresy klientów i natywne nowe zamówienia.

Otwórz Konfiguruj w Menedżerze modułów lub pozycję Belgian Address w menu zaplecza. Jedna strona zawiera sekcje Configuration, Integrity, License, Update i Support (nazwy angielskie). Cztery przełączniki są w podanej kolejności, potem Zapisz. Domyślnie są włączone. Nie ma pola klucza, konta ani kraju usługi. W multistore wybierz jeden sklep, którym możesz zarządzać; ustawienia są zapisywane dla tego sklepu. Za formularzem są uwagi: zakres/darmowa usługa, wpisywanie ręczne, prywatność, CSP i pokrewne usługi. Teksty ustawień są po angielsku, niemiecku, francusku, polsku, włosku, hiszpańsku i niderlandzku; to nie obietnica danych adresowych w siedmiu językach.

Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste oznacza wszystkie kraje formularza, lista ogranicza dany moduł. Belgian Address pozostaje przy BE. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji. Możesz zostawić globalną usługę dla innych krajów. Błąd nie uruchamia automatycznie innej usługi.

Dodaj trzy regiony Belgii do Content Security Policy

Źródła connect-src ustalone z kodu to https://geo.api.vlaanderen.be, https://geoservices.irisnet.be i https://geoservices.wallonie.be. Żaden zewnętrzny SDK ani arkusz stylów nie jest ładowany. Połącz przykład z obecną polityką, zachowując reguły motywu, inline/nonces i innych modułów. Z French Address Autocomplete dodaj też https://data.geopf.fr do connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://geo.api.vlaanderen.be https://geoservices.irisnet.be https://geoservices.wallonie.be;

Zachowaj mieszkanie i szczegóły dostawy

Kraj, drugi wiersz, imię, firma i telefon pozostają bez zmian. Dopisz lub zachowaj lokal, skrzynkę, piętro, wejście i budynek w drugim wierszu. Sprawdź ulicę, numer domu, kod i miasto przed zapisem. Sama ulica wymaga dopisania numeru. Taki wybór z Flandrii czyści kod; Bruksela i Walonia zachowują kod zwrócony w danych. Dopisz brakujące informacje ręcznie.

Wymagania

• Ogólny zakres PrestaShop: PS 1.6 – 9.x. Dokładne zadeklarowane minimum: PrestaShop 1.6.1.0, PHP od 7.1.
• Natywne pola adresowe i wygląd Bootstrap 3, 4 lub 5. Belgia musi być dostępna; aktywuj ją, jeśli tam dostarczasz.
• Sprawdź, czy Belgia jest aktywna i dostępna w używanych natywnych formularzach adresu.

Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji. Belgian Address działa samodzielnie.

Instalacja nie potwierdza dostępności usługi ani każdej kombinacji platformy i motywu. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji.

Podpowiedzi zaczynają się po trzech znakach i 300 ms przerwy. Cztery bezpośrednie żądania GET pytają równolegle Flandrię, Brukselę po francusku i niderlandzku oraz Walonię. Flandria używa c=10&q=..., Bruksela spatialReference=4326, stałego language=fr lub nl i address, Walonia address. Filtry prefiksów słów i liczb ograniczają niedokładne dopasowania, uwzględniając wielkość liter i akcenty. Do pięciu różnych wyników jest łączonych na przemian, z usuwaniem duplikatów według ulicy, kodu i miasta. Gdy Walonia nie zwróci pasującego wiersza, a tekst ma co najmniej trzy słowa, próbuje raz bez ostatniego słowa, nadal filtrując pełnym tekstem. Tylko dla Walonii apostrofy i operatory stają się spacjami. Po pierwszym użytecznym wyniku wolniejsze usługi mają jeszcze sekundę przed anulowaniem. Inne regiony mogą zwrócić wyniki mimo awarii jednego.

Przy trwającym wyszukiwaniu po 600 ms pojawia się zwykły wiersz „Wyszukiwanie adresów…” (źródło: „Searching addresses…”). Każde żądanie HTTP kończy się po dziesięciu sekundach. Powtórzenie Walonii może wydłużyć całe wyszukiwanie; nie ma wspólnego limitu dziesięciu sekund. Klient może przez cały czas wpisywać adres ręcznie.

Pola wybranego adresu

Wybór uzupełnia address1, postcode i city bez kolejnego zapytania. Flandria rozdziela ulicę/numer, czterocyfrowy kod i miasto; Bruksela dostarcza osobne pola ulicy, numeru, kodu i gminy; Walonia odczytuje adresy poziomu 4, przenosi początkowy numer za ulicę i usuwa końcowe podkreślenia miasta. Kod pozostaje czterocyfrowy bez spacji. Zwrócone litery i końcówki z ukośnikiem mogą pozostać, ale lokal dopisujesz ręcznie po wyborze. Wpisany lokal musi pasować do zwróconego wiersza i może dać brak wyników. Same ulice pojawiają się tylko bez poprawnego adresu z numerem i bez wpisanej cyfry. Wybór ulicy z Flandrii czyści kod, Bruksela/Walonia zachowują zwrócony. Dopisz numer i brakujący kod. Brak województwa i specjalnego trybu miejscowości bez ulic. Lista ma dwa wiersze: ulica/numer, potem kod + miasto.

Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste oznacza wszystkie kraje formularza, lista ogranicza dany moduł. Belgian Address pozostaje przy BE. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji. Możesz zostawić globalną usługę dla innych krajów. Błąd nie uruchamia automatycznie innej usługi.

W Klienci > Adresy pracownik może wybrać belgijską podpowiedź po rozmowie z klientem, aby wpisać ulicę, kod i miasto. Przełącznik zaplecza działa niezależnie od konta i zamówienia.

Kod obejmuje też natywne okna adresu nowego zamówienia obsługiwane przez stronę adresów klientów. Własne trasy i formularze wymagają testu. Checkout Revolution może załadować ten sam silnik dla swoich formularzy adresowych i korzystać z tych samych ustawień usługi dla danego sklepu.

Na telefonie dotknij wyniku pod ulicą. Strzałki i Enter obsługują wybór z klawiatury, Escape lub Tab zamyka listę. Czytniki ekranu otrzymują komunikaty o wynikach. Wspólny komponent korzysta z wyglądu Bootstrap motywu.

Pod wynikami widnieje © Digitaal Vlaanderen, paradigm.brussels, SPW. Bez dopasowania lista pozostaje zamknięta, a awaria usługi jest komunikowana. Ręczne wpisywanie i edycja działają nadal. Zapis nie wymaga podpowiedzi i nie sprawdza możliwości doręczenia.

Prywatność i źródło danych

Przeglądarka wysyła tekst ulicy do trzech regionów, jako q dla Flandrii i address dla Brukseli/Walonii. Stałe opcje obejmują liczbę wyników, odniesienie przestrzenne i francuski/niderlandzki język Brukseli. Walonia dostaje oczyszczony tekst i ewentualne skrócone powtórzenie, nadal filtrowane pełnym tekstem. Nie dodaje się parametrów klucza, wybranego kraju, języka strony, imienia, e-maila, telefonu, firmy ani drugiego wiersza. Cały tekst wyszukiwania jest wysyłany. Połączenia ujawniają IP i możliwe informacje przeglądarki (nagłówki Origin i Referer) według zasad przeglądarki. Poświadczenia są wyłączone. Każde żądanie HTTP ma limit dziesięciu sekund; powtórzenie może wydłużyć wyszukiwanie. Wybór jest lokalny. Brak historii i proxy sklepu; diagnostyka pomija zapytania i zwrócone adresy. PrestaShop zapisuje adres normalnie. Opisz połączenia w polityce prywatności. Widoczny podpis: © Digitaal Vlaanderen, paradigm.brussels, SPW.

• Rejestry regionalne nie gwarantują każdego adresu, aktualności, ciągłej dostępności ani nieograniczonego użycia. Zapisane odpowiedzi nie potwierdzają bieżących wyników lub miejscowości bez ulic.
• Błędne wiersze są odrzucane; prefiksy mogą pasować do dłuższych nazw lub numerów. Lokal, skrzynkę i budynek dopisujesz po wyborze. Sama ulica wymaga numeru i czasem kodu; Flandria czyści wtedy kod. Sprawdź adres przed zapisem.
• HTTP 429 wstrzymuje tylko dany serwer według Retry-After lub na dziesięć sekund; oba języki Brukseli dzielą przerwę. Inne regiony mogą nadal zwrócić wyniki. Każde żądanie ma limit dziesięciu sekund z możliwym powtórzeniem Walonii. Ręczny wpis pozostaje; brak przejścia na inną zainstalowaną usługę.
• Własne formularze, motywy i inne trasy okna zamówienia wymagają testu. Checkout Revolution może korzystać ze wspólnego silnika.
• Brak mapy, geolokalizacji, zapisu współrzędnych, walidacji przy wysyłaniu, automatycznego wyboru kraju i gwarancji doręczenia. Dożywotnie aktualizacje bez obietnicy wsparcia w cenie.

• Brak belgijskich wyników: wybierz aktywną Belgię, sprawdź przełączniki i wpisz pełną ulicę z numerem i miastem.
• Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji.
• Sama ulica lub brak wyniku: dopisz numer, kod i miejscowość pocztową ręcznie oraz sprawdź adres przed zapisem.
• Usługa niedostępna: sprawdź sieć/CSP usług regionalnych, odczekaj po limicie i wpisuj ręcznie.
• Własny formularz lub układ: przetestuj natywny formularz, telefon/klawiaturę i trasę zamówienia; sprawdź ustawienia usługi dla tego sklepu.