Polish Address Autocomplete: konfiguracja i pomoc

• Podpowiedzi polskich adresów. Oficjalne dane GUGiK PRG w standardowych formularzach konta i zamówienia, także dla gości.
• Uzupełnienie pól za jednym wyborem. Ulica z numerem budynku, kod NN-NNN i miejscowość.
• Zasięg: Polska. Także wsie bez ulic; same ulice i numery mieszkań uzupełniasz ręcznie.
• Pomoc na zapleczu. Te same podpowiedzi dla pracowników w Klienci > Adresy.
• Wygodne wpisywanie. Dotyk, klawiatura i komunikaty czytników ekranu; zawsze można wpisać adres ręcznie.
• Bez konta usługi. Darmowy moduł i dane krajowe, cztery przełączniki, bez klucza.

• Podpowiadaj adresy podczas wpisywania przez klienta: główny przełącznik, pierwszy w formularzu.
• W formularzu adresu na koncie klienta: standardowe 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 standardowe nowe zamówienia.

Otwórz Konfiguruj w Menedżerze modułów lub pozycję Polish Address w menu zaplecza. Strona ustawień zawiera kolejno sekcje Konfiguracja, Integralność, Licencja, Aktualizacja i Wsparcie. Cztery przełączniki są w podanej wyżej kolejności, a za nimi przycisk Zapisz. Domyślnie wszystkie są włączone. Nie ma pola klucza, konta ani wyboru krajów. W trybie wielu sklepów wybierz jeden sklep, którym możesz zarządzać; ustawienia zapisują się dla niego. Za formularzem są uwagi o zasięgu i darmowej usłudze, ręcznym wpisywaniu, prywatności, CSP oraz pokrewnych modułach. Teksty ustawień są dostępne po angielsku, niemiecku, francusku, polsku, włosku i hiszpańsku. To języki interfejsu, a nie obietnica tłumaczonych danych adresowych.

Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste pole oznacza wszystkie kraje dostępne w formularzu; wybrana lista ogranicza daną usługę. Ten moduł korzysta z GUGiK tylko dla Polski. 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 i włączyć Polish Address dla Polski. Błąd nie uruchamia automatycznie innej usługi.

Dopuść GUGiK w polityce bezpieczeństwa treści

Dopuść https://capap.gugik.gov.pl w connect-src. Z tym adresem GUGiK łączy się moduł; występuje też w dostarczonych próbach usługi. Skrypty i style pochodzą ze sklepu. Dopisz ten przykład do obecnej polityki, zachowując reguły motywu, style osadzone/jednorazowe znaczniki bezpieczeństwa i wymagania innych modułów. Jeśli używasz French Address Autocomplete, dopuść też https://data.geopf.fr w connect-src. Sprawdź rzeczywiste połączenia przeglądarki w sklepie. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji.

script-src 'self';
style-src 'self';
connect-src 'self' https://capap.gugik.gov.pl;

Zachowaj mieszkanie i szczegóły dostawy

Kraj, drugi wiersz adresu, imię, firma i telefon pozostają bez zmian. W PRG nie ma numerów mieszkań: dopisz numer po wybraniu podpowiedzi lub zostaw go w drugim wierszu razem z piętrem czy wejściem. Wybór zastępuje pole ulicy adresem z rejestru, więc nie zachowuje numeru mieszkania wpisanego wcześniej w tym polu. Przed zapisem sprawdź numer budynku, kod i miejscowość. Wybór samej ulicy czyści kod pocztowy; numer i kod trzeba dopisać 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. Polska musi być dostępna; aktywuj ją, jeśli tam dostarczasz.
• Sprawdź, czy Polska jest aktywna i dostępna w używanych standardowych formularzach adresu.

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

Sprawdź formularze i motyw używane w swoim sklepie. Zachowaj zapis żądań przeglądarki razem z wynikami sprawdzenia wdrożenia. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji.

Podpowiedzi uruchamiają się po trzech znakach i 300 ms przerwy w pisaniu. Przeglądarka wysyła bezpośrednie żądanie GET do GUGiK CAPAP ref/qn: uporządkowany tekst w q, f=json, offs=0, cnt=10, stały obszar Polski, bboxm=soft, top=and i useExtSvc=true. Tekst z cyfrą korzysta z indeksu punktów idx=pkt, a bez cyfr z indeksu ulic idx=ulc. Gdy to możliwe, ref/ac dostaje ostatnie słowo w b, puste a, cnt=5 i idx=pkt,ulc; potem mogą ruszyć najwyżej dwa wyszukiwania z rozwiniętym słowem. Pierwszy niepusty poprawny wynik kończy pozostałe żądania. Lista pokazuje do pięciu różnych podpowiedzi w dwóch wierszach: ulica lub miejscowość z numerem, niżej kod i miejscowość.

Gdy wyszukiwarka czeka na odpowiedź, po 600 ms pojawia się zwykły komunikat „Wyszukiwanie adresów…”. Każde pojedyncze żądanie ma limit dziesięciu sekund; cały ciąg wyszukiwań z rozwijaniem słów może potrwać dłużej. Przy większym obciążeniu usługa bywa wolniejsza; uwaga o zasięgu wspomina też o krótkiej przerwie nocnej. Klient zawsze może wpisać lub poprawić adres ręcznie.

Pola wybranego adresu

Wybrany punkt uzupełnia ulicę i zwrócony numer budynku, np. Marszałkowska 100/102, kod 00-026 oraz miejscowość Warszawa. Ukośnik w tym przykładzie jest częścią numeru budynku, a nie wynikiem wyszukiwania mieszkania. Moduł zachowuje rodzaj drogi, np. pl. Zamkowy, i nie powtarza słowa Aleje w Aleje Jerozolimskie. We wsiach bez ulic wpisuje nazwę miejscowości i numer. Miejscowość z PRG może różnić się od miejscowości pocztowej. Punkt adresowy musi mieć miejscowość, niepusty numer budynku, kod NN-NNN oraz, jeśli podano status, oznaczenie istniejącego punktu. Niepoprawne wpisy są pomijane. Wyszukiwanie bez cyfr korzysta z ulic: wybór uzupełnia ulicę i miejscowość, a kod czyści. Moduł używa już otrzymanego adresu bez kolejnego pobrania. Nie wyszukuje osobno miejscowości pocztowej, dzielnicy ani województwa.

Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste pole oznacza wszystkie kraje dostępne w formularzu; wybrana lista ogranicza daną usługę. Ten moduł korzysta z GUGiK tylko dla Polski. 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 i włączyć Polish Address dla Polski. Błąd nie uruchamia automatycznie innej usługi.

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

Moduł obejmuje też standardowe okna adresu nowego zamówienia obsługiwane przez stronę adresów klientów. Własne formularze i okna pod innymi adresami wymagają sprawdzenia. Dołączony mechanizm obsługuje oznaczone formularze adresowe zamówienia i współdzieli ustawienia usług dla danego sklepu z Checkout Revolution.

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 GUGiK (PRG). 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 wpisany tekst adresu, stałe opcje wyszukiwania i ewentualne rozwinięcia ostatniego słowa bezpośrednio do GUGiK pod https://capap.gugik.gov.pl. Nie dodaje parametrów klucza, wybranego kraju, języka, imienia, adresu e-mail, telefonu, firmy ani drugiego wiersza. Wszystko wpisane w polu wyszukiwania jest przesyłane. Żądania nie wysyłają danych uwierzytelniających. Bezpośrednie połączenie ujawnia IP i informacje przeglądarki; informacja o pochodzeniu i stronie odsyłającej zależy od jej zasad. Moduł nie prowadzi historii wyszukiwań ani nie przekazuje zapytań przez sklep. Diagnostyka pomija treść zapytań i otrzymane adresy. Zwykły zapis wybranego adresu obsługuje PrestaShop. Opisz to połączenie w polityce prywatności. Pod listą widnieje źródło: GUGiK (PRG).

• Zasięg i dostępność zależą od GUGiK. Moduł nie obiecuje znalezienia każdego adresu ani nieprzerwanego działania usługi. Nie jest pełnym spisem kodów pocztowych i nie gwarantuje nielimitowanych zapytań.
• PRG nie zawiera mieszkań. Dopisz je po wyborze lub w drugim wierszu. Miejscowość może różnić się od pocztowej. Punkty wymagają poprawnego kodu NN-NNN; po wyborze samej ulicy dopisz numer i kod.
• Odpowiedź 429 wstrzymuje żądania na czas Retry-After albo dziesięć sekund. Każde żądanie ma limit dziesięciu sekund; cały ciąg może trwać dłużej. Ręczne wpisywanie pozostaje dostępne, bez automatycznego przejścia do innej usługi.
• Własne formularze, motywy i okna nowego zamówienia pod inną trasą wymagają sprawdzenia. Własne formularze zamówienia wymagają integracji ze wspólnym mechanizmem.
• Bez mapy, geolokalizacji, zapisu współrzędnych, sprawdzania przy wysyłaniu, automatycznego wyboru kraju i gwarancji dostawy. Darmowy moduł z dożywotnimi aktualizacjami, bez obietnicy wsparcia w cenie.

• Brak polskich wyników: wybierz Polskę i sprawdź, czy jest aktywna, 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 GUGiK, odczekaj po limicie i wpisuj ręcznie.
• Własny formularz lub układ: przetestuj standardowy formularz, telefon/klawiaturę i trasę zamówienia; sprawdź wspólne ustawienia usług dla wybranego sklepu.