Slovak Address Autocomplete: konfiguracja i pomoc

Szybki start

  1. Zainstaluj ZIP modułu w PrestaShop. Bez konta MV SR, klucza czy przygotowania płatności.
  2. Otwórz Konfiguruj lub pozycję Slovak Address w menu zaplecza; w trybie wielu sklepów wybierz jeden sklep, którym możesz zarządzać.
  3. Sprawdź, czy Słowacja jest aktywna i dostępna w używanych natywnych formularzach adresu.
  4. Wybierz kolejno przełącznik główny, konta, zamówienia i zaplecza, następnie zapisz. Bez wyboru krajów tutaj.
  5. Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji.
  6. Dodaj MV SR do istniejącej CSP i opisz połączenie przeglądarki w polityce prywatności.
  7. Wybierz Słowację i wpisz Obchod 12 Bratis. Jeśli usługa zwróci Obchodná 512/12, wybierz ten adres i sprawdź 811 06 oraz Bratislava. Sprawdź też wieś bez ulic, uzupełnienie brakującego kodu, wpisywanie ręczne, gości, faktury, pracowników/nowe zamówienia, Francję z French Address Autocomplete i widok telefonu.

Instrukcja konfiguracji

Slovak Address Autocomplete to darmowy moduł PrestaShop do wpisywania adresów na Słowacji. Wybrany adres uzupełnia ulicę i zwrócone numery domu, kod NNN NN, jeśli jest dostępny, oraz miejscowość. Moduł korzysta z otwartych danych Register adries słowackiego Ministerstwa Spraw Wewnętrznych, bez konta, klucza i kosztu pojedynczego wyszukiwania.

Funkcje

  • Podpowiedzi adresów dla Słowacji. Oficjalne dane Register adries w natywnym koncie i zamówieniu, także dla gości.
  • Uzupełniane razem. Ulica i zwrócone numery domu, dostępny kod NNN NN i miejscowość.
  • Stały zakres: Słowacja. Adresy rejestru krajowego, także wsie bez ulic; brakujące kody uzupełnisz 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 krajowe, cztery przełączniki, bez klucza.

Opcje konfiguracji

  • 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ę Slovak Address w menu zaplecza. Jedna strona zawiera sekcje Konfiguracja, Integralność, Licencja, Aktualizacja i Wsparcie. 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 trybie wielu sklepów 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 słowacku; 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ł. MV SR pozostaje przy SK. 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ć Slovak Address dla Słowacji. Błąd nie uruchamia automatycznie innej usługi.

Slovak Address: cztery przełączniki, zakres, ręczne wpisywanie, prywatność i CSP; bez pola klucza

Przykłady dostosowania

Dopuść MV SR w polityce bezpieczeństwa treści

Dopuść https://rageo.minv.sk w connect-src, zgodnie z adresem używanym przez adapter i zapisane wywołania usługi. Skrypty i style pochodzą ze sklepu. Połącz przykład z obecną polityką, zachowując reguły motywu, style osadzone/jednorazowe znaczniki i inne moduły. Z French Address Autocomplete dopuść też https://data.geopf.fr w connect-src. Sprawdź żądania i politykę w swoim sklepie. Identyfikator źródłowy data.gov.sk nie jest pobierany jako osobny adres. Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste oznacza wszystkie kraje formularza, lista ogranicza dany moduł. MV SR pozostaje przy SK. 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ć Slovak Address dla Słowacji. Błąd nie uruchamia automatycznie innej usługi.

script-src 'self';
style-src 'self';
connect-src 'self' https://rageo.minv.sk;

Zachowaj mieszkanie i szczegóły dostawy

Wybrany kraj, drugi wiersz adresu, imię i nazwisko, firma oraz telefon pozostają bez zmian. Mieszkanie, piętro i wejście wpisz w drugim wierszu. Wybór zastępuje wiersz ulicy adresem z rejestru, więc dodatkowe szczegóły dopisz później. Przed zapisem sprawdź numery domu, kod i miejscowość. Moduł nie wyszukuje mieszkań ani nazw domów. Klient zawsze może poprawić wynik lub wpisać adres ręcznie.

Instalacja

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. Słowacja musi być dostępna; aktywuj ją, jeśli tam dostarczasz.
  • Sprawdź, czy Słowacja 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. Slovak 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.

Wyszukiwanie Obchodná 12 81106 w Bratysławie z podpowiedziami Register adries w PrestaShop

Sposób działania

Podpowiedzi zaczynają się po trzech znakach i przerwie 300 ms. Przeglądarka wysyła bezpośrednie żądanie JSON POST do https://rageo.minv.sk/geocoder/api/v1/search z ujednoliconym text, categories:["adresa"] i size:50. Pomija opcjonalne przedrostki ulic i ujednolica námestie. Początek nazwy jednego z 25 większych miast może wywołać równoległe wyszukiwanie z pełną nazwą. Rozpoznany kod pocztowy wraz z numerem domu dodaje żądanie WFS GET do /geoserver/ows, z filtrami kodu, numeru oraz słów ulicy/miejscowości. Połączone wyniki są porządkowane według numeru, wpisanej miejscowości i kolejności większych miast. Widać najwyżej pięć podpowiedzi.

Podczas wyszukiwania lub pobierania wybranego adresu po 600 ms pojawia się zwykły komunikat „Wyszukiwanie adresów…”. Każde żądanie HTTP kończy oczekiwanie po dziesięciu sekundach. Wyszukiwanie i wybór to osobne operacje, więc nie jest to łączny limit całej czynności. Limit zapytań powoduje przerwę według Retry-After albo na dziesięć sekund. Klient zawsze może kontynuować ręczne wpisywanie lub poprawianie adresu.

Pola wybranego adresu

Wybór wpisuje ulicę i numery tak, jak zapisano je w rejestrze: súpisné/orientačné, np. Obchodná 512/12. Zachowuje też pojedynczy dostępny numer i litery. Kod przyjmuje postać 811 06, a miejscowość to Bratislava. Nazwy dzielnic Bratysławy i Koszyc są skracane do Bratislava i Košice, bez dopisywania numeru urzędu pocztowego. Gdy nie ma ulicy, używana jest nazwa części miejscowości lub wsi, np. Horša 12 z Levice albo Čičmany 123. Brakujący kod pozostaje pusty i trzeba go uzupełnić ręcznie. Zwykłe podpowiedzi geokodera mają dwa wiersze: ulica/część miejscowości i numer, a niżej zwrócona miejscowość. Nie zawierają kodu pocztowego. Zwykły wybór pobiera jeden uporządkowany rekord WFS według identyfikatora źródłowego. Wyniki wyszukiwania po kodzie mają już pola, pokazują kod i miejscowość w drugim wierszu i nie wymagają ponownego pobierania. Poprawne dane muszą zawierać miejscowość i co najmniej jeden numer domu; błędne rekordy są odrzucane. Moduł nie uzupełnia samej ulicy. Brak kodu czyści pole; województwo nie jest zwracane.

Wybrany słowacki adres Obchodná 512/12, 811 06 Bratislava; drugi wiersz bez zmian

Używaj dla tych krajów istnieje tylko w modułach globalnych. Puste oznacza wszystkie kraje formularza, lista ogranicza dany moduł. MV SR pozostaje przy SK. 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ć Slovak Address dla Słowacji. Błąd nie uruchamia automatycznie innej usługi.

Francja w tym samym formularzu: odpowiada French Address Autocomplete zamiast Register adries

W Klienci > Adresy pracownik może wybrać słowacką 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. Dołączony mechanizm obsługuje oznaczone formularze adresowe zamówienia i współdzieli ustawienia usług dla danego sklepu z Checkout Revolution.

Słowackie podpowiedzi Register adries w natywnym zapleczu Klienci › Adresy

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 © Ministerstvo vnútra SR. 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.

Słowackie podpowiedzi Register adries w natywnym formularzu na ekranie telefonu

Prywatność i źródło danych

Przeglądarka wysyła ujednolicony tekst i stałe opcje wyszukiwania bezpośrednio do usługi ministerstwa na https://rageo.minv.sk. Rozwinięcie nazwy większego miasta może dodać wyszukiwanie. Wyszukiwanie po kodzie wysyła kod, numer domu oraz słowa ulicy/miejscowości w filtrach WFS. Zwykły wybór wysyła identyfikator źródłowy, aby pobrać adres. Moduł nie dodaje parametrów klucza, wybranego kraju, języka strony, imienia i nazwiska, adresu e-mail, telefonu, firmy ani drugiego wiersza. Tekst wpisany w polu wyszukiwania może zostać wysłany po ujednoliceniu. Żądania nie wysyłają danych uwierzytelniających. Połączenie ujawnia adres IP i informacje o przeglądarce; informacje o pochodzeniu i stronie odsyłającej zależą od jej zasad. Nie ma pośrednika w sklepie ani historii wyszukiwania; diagnostyka pomija zapytania i zwrócone adresy. Opisz ten przepływ w polityce prywatności. Widoczny podpis: © Ministerstvo vnútra SR.

Ograniczenia

  • Zakres i dostępność zależą od Register adries. Nie ma gwarancji wszystkich adresów ani ciągłości działania. Moduł nie jest pełnym spisem kodów i nie obiecuje nieograniczonego użycia.
  • Zwykła lista nie zawiera kodu. Rozmiar wyników i rozwijanie nazw miast są ograniczone; pobranie szczegółów może się nie udać mimo udanego wyszukiwania. Brakujące kody uzupełnij ręcznie.
  • Numery pozostają takie jak w odpowiedzi. Nie ma wyszukiwania mieszkań ani nazw domów, uzupełniania samej ulicy czy dopisywania numeru urzędu pocztowego. Sprawdź wybrany adres.
  • Każde żądanie kończy oczekiwanie po dziesięciu sekundach; wyszukiwanie i wybór są osobne. Limity zapytań wprowadzają przerwę. Ręczne wpisywanie działa nadal, bez automatycznej zmiany usługi.
  • Własne formularze/motywy i okna nowych zamówień pod inną trasą wymagają sprawdzenia. Własne formularze zamówienia wymagają integracji ze wspólnym mechanizmem. Bez mapy, geolokalizacji, sprawdzania przy zapisie, automatycznego wyboru kraju i gwarancji dostawy. Darmowy moduł z dożywotnimi aktualizacjami, bez zobowiązania do wsparcia.

Gdy nie ma podpowiedzi

  • Brak słowackich wyników: wybierz Słowację, sprawdź jej aktywność i przełączniki główny/formularza, potem wpisz pełną ulicę + numer + miejscowość.
  • Spróbuj innej pisowni lub pełnej nazwy miejscowości, gdy wyników jest za dużo. Aktualizuj wszystkie moduły adresowe.
  • Brak szczegółów lub kodu: wpisz lub uzupełnij ulicę, numer, kod i miejscowość ręcznie, a przed zapisem sprawdź adres.
  • Podpowiedzi niedostępne: sprawdź żądania przeglądarki i CSP dla rageo.minv.sk, odczekaj po limicie zapytań i kontynuuj ręcznie.
  • Własny układ: sprawdź natywny formularz, telefon, klawiaturę i trasę nowego zamówienia. Sprawdź wspólne ustawienia usług dla wybranego sklepu.

Pytania

7

Czy Slovak Address Autocomplete jest darmowy?

Tak. Moduł jest darmowy z dożywotnimi aktualizacjami, bez zobowiązania do wsparcia. Wyszukiwanie nie wymaga konta ani klucza i nie wiąże się z opłatą za zapytanie.

Czy potrzebujesz klucza lub konta?

Nie. Nie potrzebujesz konta usługi ani klucza API.

Jakie kraje i pola obejmuje moduł?

Dla Słowacji uzupełnia ulicę i zwrócone numery domu, kod NNN NN, jeśli jest dostępny, oraz miejscowość. Obsługuje wsie bez ulic. Brakujący kod i szczegóły mieszkania dopisz ręcznie; wybrany kraj i pozostałe pola nie zmieniają się.

Czy działa dla gości, adresów do faktury i pracowników?

Tak, w standardowych formularzach konta i zamówienia, także dla gości i osobnych adresów do faktury, oraz w Klienci > Adresy. Okna adresowe nowych zamówień są obsługiwane, jeśli korzystają z tej strony; własne formularze wymagają sprawdzenia.

Czy możesz uruchomić kilka modułów adresowych?

Działa obok French Address Autocomplete, Google Address Autocomplete i Fetchify Address Autocomplete; aktualizuj je wszystkie do najnowszej wersji. SK i kierunki BAN są oddzielne. Brak automatycznej zmiany usługi przy błędzie.

Co przeglądarka wysyła do Register adries?

Ujednolicony tekst wyszukiwania, filtry kodu pocztowego i identyfikator wybranego adresu trafiają bezpośrednio do rageo.minv.sk. Usługa widzi też IP i informacje o przeglądarce odwiedzającego; inne pola formularza nie są dodawane.

Czy klient musi wybrać podpowiedź przed zapisem?

Nie. Klienci mogą ręcznie wpisywać, poprawiać i zapisywać adresy, również gdy podpowiedzi są niedostępne.

Znane problemy

Brak znanych problemów

Obecnie nie ma zarejestrowanych otwartych ani rozwiązanych problemów dla tego modułu.

Zgłoszenia funkcji

Brak propozycji funkcji dla tego modułu

Czegoś brakuje? Zaproponuj to i śledź postępy tutaj.

Dziennik zmian

v1.0.12026-11-10

  • First release: suggests Slovak addresses from the official national address register while the customer types on the checkout, account and back office address forms, and fills in the street, house number, postcode and town.
  • Free: no account, no key and no cost per lookup.
  • Works beside the other mypresta.rocks address modules and inside Checkout Revolution.
Ładowanie...
Do góry