Lithuanian Address Autocomplete: konfiguracja i pomoc

Szybki start

  1. Zainstaluj ZIP modułu w PrestaShop. Bez konta Registrų centras, klucza czy przygotowania płatności.
  2. Otwórz Konfiguruj lub pozycję Lithuanian Address w menu zaplecza; w trybie wielu sklepów wybierz jeden sklep, którym możesz zarządzać.
  3. Sprawdź, czy Litwa jest aktywna i dostępna w używanych standardowych 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 Registrų centras do istniejącej CSP i opisz połączenie przeglądarki w polityce prywatności.
  7. Wybierz Litwę i wpisz Gedim 12 Viln. Sprawdź Gedimino pr. 12, 01102 i Vilnius, jeśli taki wynik wróci. Przetestuj też ulicę otwierającą listę domów, miejscowość bez ulic, oznaczenia budynków, ręczne wpisywanie, gości, faktury, pracowników/nowe zamówienia, Francję z French Address Autocomplete i telefon.

Instrukcja konfiguracji

Lithuanian Address Autocomplete to darmowy moduł PrestaShop do wpisywania adresów na Litwie. Wybór pełnego adresu uzupełnia ulicę, numer domu, kod pocztowy i miejscowość z krajowego rejestru prowadzonego przez Registrų centras. Usługa publiczna nie wymaga konta ani klucza i nie pobiera opłat za wyszukanie. Numer mieszkania klient dodaje sam.

Funkcje

  • Litewskie podpowiedzi. Dane krajowego rejestru w natywnych formularzach konta i zamówienia, także dla gości.
  • Wspólne uzupełnianie. Ulica, numer domu, pięciocyfrowy kod i miejscowość; lista pokazuje LT-NNNNN.
  • Stały obszar Litwy. Miejscowości bez ulic, litery i oznaczenia budynków; ulice otwierają listy domów.
  • Pomoc na zapleczu. Te same podpowiedzi dla pracowników w sekcji 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.

Opcje konfiguracji

  • 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ę Lithuanian 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, hiszpańsku i litewsku. 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 Registrų centras tylko dla Litwy. 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ć Lithuanian Address dla Litwy. Błąd nie uruchamia automatycznie innej usługi.

Lithuanian Address: cztery przełączniki, zasięg, ręczne wpisywanie, prywatność i CSP

Przykłady dostosowania

Dopuść Registrų centras w polityce bezpieczeństwa treści

Dopuść https://boundaries.biip.lt w connect-src. Z tym adresem Registrų centras łą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://boundaries.biip.lt;

Zachowaj mieszkanie i szczegóły dostawy

Kraj, druga linia adresu, imię i nazwisko, firma oraz telefon pozostają bez zmian. Moduł nie wyszukuje mieszkań: dodaj numer po wyborze albo umieść go w drugiej linii wraz z piętrem i wejściem. Pełny wybór zastępuje linię ulicy, więc wpisany tam numer mieszkania nie zostaje zachowany. Wybór ulicy lub miejscowości otwiera listę domów bez uzupełniania formularza. Wybierz pełny adres albo wpisz go ręcznie. Wynik może nie zawierać kodu: sprawdź go i uzupełnij przed zapisaniem.

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

Wilno: wyszukiwanie Gedim 12 Viln i litewskie podpowiedzi rejestru adresów w PrestaShop

Sposób działania

Podpowiedzi zaczynają się po trzech znakach i krótkiej przerwie. Przeglądarka wysyła żądania JSON POST do wyszukiwania ulic i miejscowości pod https://boundaries.biip.lt/v1/, ze wzorcami utworzonymi z wpisanych słów. Przy numerze domu następuje wyszukanie adresów według otrzymanych kodów ulic lub miejscowości. Pełny kod pocztowy z numerem domu pozwala wyszukać adres bezpośrednio. Widać do pięciu wyników. Pełny adres ma dwie linie: ulica lub miejscowość i numer, potem kod LT-NNNNN i miejscowość. Podpowiedzi ulic i miejscowości nie mają jeszcze numeru domu. Wybór ulicy lub miejscowości pobiera listę domów; „Daugiau adresų” otwiera jej następną stronę. Pełny adres jest uzupełniany z otrzymanych danych bez kolejnego pobrania.

Przy wolniejszej odpowiedzi pojawia się zwykły wiersz „Wyszukiwanie adresów…”. Każde żądanie kończy oczekiwanie po dziesięciu sekundach; ciąg żądań może potrwać dłużej. Klient zawsze może wpisać lub poprawić adres ręcznie.

Pola wybranego adresu

Wybór pełnego adresu uzupełnia np. Gedimino pr. 12, kod 01102 i miejscowość Vilnius. Podpowiedź wyświetla LT-01102. Litery przy numerze i oznaczenia budynków pozostają, np. Vismaliukų g. 32 K27. Bez ulicy pierwszą linię tworzą nazwa miejscowości z rejestru i numer. Dla znanych miast stosowane są jawne przypisania nazw; wsie i nierozpoznane formy zachowują zapis rejestru, z gminą w razie potrzeby. Moduł nie wymyśla nazwy domu ani drugiego numeru. Kraj, druga linia adresu, imię i nazwisko, firma oraz telefon pozostają bez zmian. Moduł nie wyszukuje mieszkań: dodaj numer po wyborze albo umieść go w drugiej linii wraz z piętrem i wejściem. Pełny wybór zastępuje linię ulicy, więc wpisany tam numer mieszkania nie zostaje zachowany. Wybór ulicy lub miejscowości otwiera listę domów bez uzupełniania formularza. Wybierz pełny adres albo wpisz go ręcznie. Wynik może nie zawierać kodu: sprawdź go i uzupełnij przed zapisaniem.

Wybrany adres Gedimino pr. 12, kod 01102, Vilnius; druga linia bez zmian

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 Registrų centras tylko dla Litwy. 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ć Lithuanian Address dla Litwy. Błąd nie uruchamia automatycznie innej usługi.

Francja w tym samym formularzu; French Address Autocomplete odpowiada przez BAN

W sekcji Klienci > Adresy pracownik może wybrać litewską 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.

Litewskie podpowiedzi w natywnym formularzu zaplecza 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 © Registrų centras, CC BY 4.0. 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.

Litewskie podpowiedzi na telefonie z oznaczeniem źródła Registrų centras

Prywatność i źródło danych

Przeglądarka wysyła bezpośrednio do boundaries.biip.lt wzorce z pola wyszukiwania, numer domu, opcjonalnie oznaczenie budynku lub kod pocztowy, stałe opcje oraz otrzymane kody ulic lub miejscowości. Kolejna strona listy domów używa też znacznika kontynuacji. Nie dodaje parametrów klucza usługi, wybranego kraju, języka strony, imienia i nazwiska, adresu e-mail, telefonu, firmy ani drugiej linii. Wpisany tekst służy do tworzenia tych zapytań. Żądania nie wysyłają danych uwierzytelniających. Połączenie ujawnia IP i informacje przeglądarki; źródło żądania i strona odsyłająca zależą od jej zasad. Nie ma historii wyszukiwania ani pośrednika w sklepie; diagnostyka pomija zapytania i otrzymane adresy. PrestaShop zapisuje wybrane adresy zwykłą drogą. Opisz przekazywanie danych w polityce prywatności. Widoczne źródło: © Registrų centras, CC BY 4.0.

Ograniczenia

  • Zasięg i dostępność zależą od Registrų centras. 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ń.
  • Bez wyszukiwania mieszkań i dowolnych nazw domów, numerów z ukośnikiem lub łącznikiem oraz ogólnego przekształcania litewskich form gramatycznych. Numer mieszkania dodaj po wyborze lub w drugiej linii. Ulice i miejscowości otwierają listy domów; brakujący kod uzupełnij ręcznie.
  • 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.

Gdy nie ma podpowiedzi

  • Brak litewskich wyników: wybierz Litwę 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.
  • Bez wyszukiwania mieszkań i dowolnych nazw domów, numerów z ukośnikiem lub łącznikiem oraz ogólnego przekształcania litewskich form gramatycznych. Numer mieszkania dodaj po wyborze lub w drugiej linii. Ulice i miejscowości otwierają listy domów; brakujący kod uzupełnij ręcznie.
  • Usługa niedostępna: sprawdź sieć/CSP Registrų centras, 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.

Pytania

7

Czy Lithuanian 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 Litwy pełny wynik uzupełnia ulicę lub miejscowość, numer domu, ewentualne oznaczenie budynku, pięciocyfrowy kod, jeśli jest dostępny, oraz miejscowość. Wybór ulicy lub miejscowości otwiera listę domów. Numer mieszkania i brakujący kod dopisz ręcznie; 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. Litwa i obszary obsługiwane przez BAN mają osobne usługi. Brak automatycznej zmiany usługi przy błędzie.

Co przeglądarka wysyła do boundaries.biip.lt?

Wzorce wyszukiwania, numer domu, opcjonalne oznaczenie budynku lub kod pocztowy, kody ulic lub miejscowości i znaczniki kolejnych stron trafiają bezpośrednio do boundaries.biip.lt. 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 Lithuanian 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