Lithuanian Address Autocomplete

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.

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.

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.

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.

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.

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.

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.

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.

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.