Integracja what3words: konfiguracja i pomoc

Wymagania

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.

Potrzebujesz własnego klucza API what3words i dostępu do połączeń wychodzących HTTPS z serwera sklepu.

1. Prześlij ZIP modułu przez Moduły > "Module Manager" > "Upload a module" i zainstaluj go.
2. Znajdź what3words Integration w "Module Manager" i kliknij "Configure". Otworzy się Konfiguracja.
3. Użyj konta pracownika z uprawnieniami do edycji, aby zapisywać ustawienia lub wykonywać działania konfiguracyjne.

Opcjonalne menu "what3words" jest domyślnie ukryte. Jeśli go nie ma, użyj "Configure" w menedżerze modułów.

Podłączenie klucza

Utwórz konto w portalu deweloperskim what3words pod adresem developer.what3words.com. Skopiuj klucz do Klucz API what3words. Kliknij Przetestuj klucz API. Wysyła to jedno żądanie sugestii z użyciem wpisanego klucza lub zapisanego klucza, jeśli pole pozostawisz puste. Test nie zapisuje formularza. Następnie kliknij Zapisz.

Moduł wywołuje what3words przez Twój serwer. Nie ujawnia klientom pełnego zapisanego klucza ani nie zwraca go w formularzu konfiguracji. Zapisany klucz jest maskowany. Pozostaw pole puste, aby go zachować.

Konfiguracja opisuje sugestie i sprawdzanie jako dostępne w planie bezpłatnym, a Zapisuj współrzędne jako wymagające planu płatnego. Przed włączeniem współrzędnych sprawdź uprawnienia i limit własnego konta what3words.

Ustawienia pola

Kliknij Zapisz po zmianie ustawień. W multistore ustawienia są dziedziczone od poziomu globalnego przez grupę sklepów do sklepu. Na danym poziomie Użyj dziedziczonej wartości zachowuje wartość nadrzędną. Wyłącz dziedziczenie ustawienia, aby zapisać wartość lokalną, w tym pustą listę lub wyłączony przełącznik.

Początek z polem opcjonalnym

Pozostaw Ustaw pole jako wymagane wyłączone. Wybierz kilka krajów lub pozostaw Kraje puste. Zapisz, a następnie przetestuj adres konta i adres przy zakupie bez rejestracji w każdym włączonym kraju. Przetestuj też kraj spoza listy.

Jeśli Checkout Revolution jest włączony i ma ustawiony własny przełącznik what3words oraz klucz API, ten moduł ukrywa swoje pole zbierania danych, aby uniknąć duplikatu. Istniejące zapisane słowa pozostają dostępne przy wyświetlaniu zamówień.

Wprowadzanie i walidacja słów

Otwórz formularz adresu dostawy na koncie klienta lub podczas składania zamówienia. Wpisz adres what3words i wybierz sugestię. Sugestie pokazują pobliskie miejsce i kraj. Element pomocy jest zgodny z Położenie pomocy.

Pole dotyczy adresów dostawy. Oddzielne formularze adresu do faktury nie zbierają tego pola. Wybór kraju określa jego zastosowanie. Niepusta wartość musi przejść weryfikację serwerową przed zapisaniem. Nieprawidłowe słowa, nieudana weryfikacja i wyczerpany lokalny limit wyszukiwania mogą uniemożliwić zapis. Jeśli pole jest opcjonalne, możesz je wyczyścić i zapisać adres uliczny bez słów.

Ogranicz do kraju z adresu sprawdza, czy kwadrat leży w kraju z adresu. Nie potrafi stwierdzić, czy kwadrat to wejście, o które chodziło klientowi. Trzy słowa nie zastępują zwykłego adresu pocztowego.

Testowanie starszych motywów PrestaShop

W PrestaShop 1.6 moduł dodaje pole do standardowego formularza adresu oraz formularzy rejestracji i gościa, które zbierają adres. Nieprawidłowe słowa lub brak wymaganych słów uniemożliwiają zapis, również gdy JavaScript w przeglądarce jest niedostępny.

Przetestuj faktyczne formularze konta, rejestracji i zamówienia. Formularze niestandardowe i edytory adresów w procesie zamówienia mogą korzystać z innych tras lub pomijać pole. Zanim udostępnisz je klientom, potwierdź, że edycja zachowuje lub aktualizuje zapisane słowa zgodnie z oczekiwaniami. Moduł nie instaluje nadpisania rdzenia.

Sprawdzanie zapisanych adresów

Zapisz prawidłowy adres. Otwórz książkę adresową i wybór adresu podczas zamówienia. Moduł dodaje słowa do obsługiwanych kart adresowych i łączy je z mapą what3words. Położenie zależy od natywnych znaczników i hooków motywu.

Złożenie zamówienia testowego

Złóż zamówienie z przetestowanym adresem dostawy. Sprawdź:

• Zamówienie w panelu administracyjnym z linkiem do mapy.
• Szczegóły zamówienia klienta.
• Wygenerowaną fakturę i dokument dostawy.
• Wiadomość potwierdzającą zamówienie klienta.
• Powiadomienie sprzedawcy o nowym zamówieniu, jeśli sklep je wysyła.

Moduł rozszerza bloki dostawy order_conf i new_order. Twoje szablony wiadomości i moduł powiadomień muszą używać oczekiwanych zmiennych dostawy. Położenie na dokumentach i stronach zależy też od standardowych hooków PrestaShop.

Zrozumienie kopii w zamówieniach

Zamówienie przechowuje słowa swojego adresu dostawy, w tym pustą kopię, gdy słów nie podano. Późniejsza edycja adresu klienta nie przepisuje tej zapisanej kopii zamówienia. Jeśli pracownik zmieni adres dostawy zamówienia, aktualizacja zamówienia przechwytuje słowa dla nowego adresu. Zamówienia sprzed instalacji mogą otrzymać kopię z bieżącego adresu dostawy przy pierwszym wyświetleniu.

Sprawdź to, składając zamówienie, edytując adres klienta i ponownie otwierając wcześniejsze zamówienie. Następnie osobno przetestuj celową zmianę adresu dostawy w zamówieniu.

Włączenie zgodności z przewoźnikami

Włącz Zgodność z przewoźnikami, zapisz adres zawierający już notatkę i sprawdź Inne. Dodany wiersz ma następującą postać:

what3words ///word.word.word

Moduł zachowuje notatkę klienta i zarządza własnym wierszem po zmianie lub wyczyszczeniu słów. Nowy wiersz jest dodawany tylko przy włączonym ustawieniu. Jeśli łączny tekst przekracza limit natywnego pola, moduł nie dopisuje wiersza i zapisuje ostrzeżenie diagnostyczne. Zweryfikuj faktyczną etykietę lub eksport przewoźnika.

Wyjaśnienie zewnętrznych zapytań

Częściowe i kompletne słowa są wysyłane z Twojego serwera do what3words w celu uzyskania sugestii i weryfikacji. Współrzędne są dodatkowo zapisywane, gdy ich ustawienie jest włączone i wyszukiwanie się powiedzie. Zaktualizuj informacje o prywatności w związku z tym zastosowaniem.

Moduł przechowuje słowa dla każdego adresu i zamówienia. Implementuje oficjalne hooki eksportu i usuwania danych GDPR PrestaShop. Przetestuj je za pomocą narzędzia GDPR używanego w sklepie.

what3words jest znakiem towarowym what3words Limited. Ten moduł jest niezależny i nie jest powiązany z what3words ani przez nie rekomendowany.

Brakuje pola

Sprawdź Pokaż pole what3words, zapisany klucz i Kraje. Sprawdź, czy zbieraniem danych zajmuje się Checkout Revolution. Otwórz formularz dostawy zamiast oddzielnego formularza faktury. Użyj natywnego formularza z aktywnym motywem i sprawdź jego hooki, jeśli niestandardowy proces zamówienia pomija pole.

Test klucza kończy się niepowodzeniem

Skopiuj klucz ponownie. Klucz ograniczony do witryny musi zezwalać na żądania serwerowe. Sprawdź wychodzące HTTPS, limit konta i jego uprawnienia. Test rozróżnia odrzucone klucze, ograniczenia referrera, wyczerpanie limitu, tymczasowe ograniczenie żądań i błędy sieci.

Zbyt wiele wyszukiwań

Odczekaj przed ponowieniem. Limity lokalne to 60 żądań na sesję przeglądarki w 10 minut, 120 na adres sieciowy w 10 minut i 3000 na sklep w godzinę. Odwiedzający we wspólnej sieci mogą współdzielić limit sieciowy. Zablokowane żądanie nie dociera do what3words.

Zbieranie diagnostyki

Otwórz Konfiguracja > Diagnozowanie problemów. Włącz Rejestrowanie, ustaw Pozostaw włączone przez na 24 godziny, kliknij Zapisz i odtwórz problem. Rejestrowanie zatrzymuje się po wybranym czasie. Użyj Integralność do sprawdzania infrastruktury modułu, jeśli jest dostępne.

Tymczasowe zatrzymanie zbierania danych

Wyłącz Pokaż pole what3words i zapisz. Przed usunięciem modułu zachowaj kopię zapasową danych adresów i zamówień.

Odinstalowanie

Odinstaluj przez "Module Manager". Odinstalowanie usuwa konfigurację modułu i pozycje menu. Tabele słów adresów i zamówień modułu są jawnie zachowywane. Istniejący zarządzany tekst w natywnym polu Inne nie jest automatycznie czyszczony przy odinstalowaniu. Ponowna instalacja nie jest więc procedurą usuwania danych. Gdy wymagane jest usunięcie, użyj procesu GDPR sklepu lub świadomej procedury usuwania danych.