InPost Pay - PrestaShop

Owned by Paweł Milewski, created
Last updated: Nov 12, 2024 by Joanna Wołosz
15 min read

 

 

Wstęp

Niniejsza instrukcja przedstawia proces instalacji oraz konfiguracji wtyczki, umożliwiającej wprowadzenie InPost Pay w sklepie PrestaShop.

 

Wtyczka

Wersja 1.10.0 (28.10.2024):

*Wtyczka obecnie jest jeszcze rozwijana, będą pojawiały się nowe wersje wtyczki, śledź changelog i instaluj nowe wersje, jak tylko będą dostępne.

Changelog

 

Wersja 1.10.0 (28.10.2024):

  • dodano przekazywanie do aplikacji mobilnej informacji o anulowaniu zamówienia po ustawieniu odpowiedniego statusu zamówienia w PrestaShop

  • dodano przekazywanie do aplikacji mobilnej informacji o zmianie adresu dostawy dla zamówienia po aktualizacji adresu w PrestaShop

  • dodano przekazywanie do aplikacji mobilnej informacji o dostępności metod dostawy dla poszczególnych produktów w koszyku oraz sugerowanych a także informacji, czy dodanie sugerowanego produktu do koszyka spowoduje przekroczenie progu darmowej dostawy

  • poprawiono błąd mogący uniemożliwiać przekierowanie użytkownika do strony potwierdzenia zamówienia/bramki płatności po utworzeniu zamówienia za pomocą innej metody płatności niż InPost Pay, jeżeli koszyk był wcześniej wiązany z aplikacją mobilną

  • poprawiono błąd przy zapisie konfiguracji ograniczeń wyświetlania na karcie produktu widgetu wiązania koszyka występujący w kontekście wielu sklepów na wersjach PS poniżej 1.7.6

  • poprawiono przypadki, gdzie instalacja lub aktualizacja modułu mogła nie powodzić się z uwagi na problem z utworzeniem kluczy obcych w bazie danych

  • dodano opcję konfiguracji początkowego statusu dla zamówień składanych z wybraną metodą płatności za pobraniem

  • zniesiono ograniczenie możliwości instalacji modułu na PrestaShop 8.2

Wersja 1.9.2 (23.08.2024):

  • poprawiono problem z formatem ceny dla kwoty do darmowej dostawy

Wersja 1.9.1 (12.08.2024):

  • poprawiony błąd uniemożliwiający nową instalację modułu na wersjach PHP poniżej 8.0

  • poprawiony błąd uniemożliwiający przekazanie danych koszyka do aplikacji mobilnej w przypadku, gdy próg minimalnej wartości zamówienia dla darmowej dostawy miał więcej niż dwie pozycje dziesiętne

  • poprawiony błąd mogący uniemożliwiać aktualizację konfiguracji ograniczeń wyświetlania widgetu parowania koszyka na stronach produktów

Wersja 1.9.0 (07.08.2024):

  • dodane wyświetlanie komunikatu błędu zwróconego przez kontroler koszyka w przypadku nieudanej próby dodania do koszyka produktu po kliknięciu w przycisk wiązania koszyka z aplikacją mobilną

  • dodana możliwość konfiguracji minimalnej wysokości widgetu parowania koszyka z aplikacją mobilną

  • poprawiony błąd uniemożliwiający zapisanie ogólnej konfiguracji na wersjach PS poniżej 1.7.7

  • dodana możliwość skonfigurowania dodatkowych linków do wyświetlenia przy zgodach w aplikacji mobilnej

  • dodane przekazywanie do aplikacji mobilnej informacji o minimalnej wartości koszyka potrzebnej do osiągnięcia progu darmowej dostawy

  • dodana możliwość ograniczenia wyświetlania widgetu parowania koszyka na stronach produktów w zależności od typu, domyślnej kategorii, producenta lub atrybutów produktu

  • dodane przekazywanie numeru zamówienia jako identyfikatora do wyświetlenia użytkownikowi w aplikacji mobilnej

Wersja 1.8.0 (19.07.2024):

  • poprawiony błąd skutkujący brakiem ustawienia informacji o produktach w danych zamówienia przekazywanych do aplikacji mobilnej w przypadku, gdy na zamówienie składała się większa ilość produktów

  • poprawiony przypadek, gdzie istniejące już dla koszyka zamówienie na wersjach PS poniżej 1.7.8 skutkowało błędem przy próbie finalizacji koszyka w aplikacji mobilnej

  • poprawiony przypadek, gdzie wymagalność drugiej linii adresu w PrestaShop uniemożliwiała utworzenie zamówienia przez aplikację mobilną

  • poprawione kwoty wartości zamówienia oraz dostawy przekazywane do aplikacji mobilnej w przypadku, gdy zastosowany został kod rabatowy oferujący darmową wysyłkę

  • dodane ograniczenie do 10 liczby zgód możliwej do ustawienia w konfiguracji modułu

  • dodane przekazywanie aplikacji mobilnej w danych zamówienia sumarycznej wartości zastosowanych kodów rabatowych

  • dodane przekazywanie aplikacji mobilnej dodatkowych linków do zdjęć produktów oraz możliwość konfiguracji używanych typów miniatur

Wersja 1.7.1 (05.07.2024):

  • poprawiony komunikat przekazywany do aplikacji mobilnej o błędzie związanym z niedostateczną ilością produktu na stanie

  • uzupełnione brakujące tłumaczenia

  • poprawiony błąd uniemożliwiający wyświetlenie widgetu parowania koszyka na karcie niedostępnego produktu, jeżeli w konfiguracji włączona jest opcja obsługi full page cache

  • poprawione przypadki, gdzie przechowywane w ciastku klienta dane związane ze sfinalizowanym zamówieniem mogły powodować błąd przy próbie aktualizacji danych koszyka w aplikacji mobilnej

  • poprawiona przekazywana do aplikacji mobilnej data utworzenia zamówienia

Wersja 1.7.0 (17.06.2024):

  • poprawione błędy uniemożliwiające przekazanie danych koszyka do aplikacji mobilnej

  • poprawiona kompatybilność niestandardowego hooka "displayIziThankYou" z wersjami PS poniżej 1.7.5

  • poprawione przypadki, gdzie włączona funkcjonalność geolokalizacji mogła skutkować brakiem możliwości utworzenia zamówienia lub błędnymi wartościami cen brutto przekazywanych do aplikacji mobilnej

  • poprawione przypadki błędnie przekazywanych do aplikacji mobilnej kosztów dodatkowych usług w sytuacji, gdy przy powiązanych przewoźnikach wyłączona jest opcja doliczania kosztów obsługi

  • poprawione zwracane przez API modułu dane zamówienia - dodana brakująca informacja o numerach przesyłek

  • poprawiony błąd uniemożliwiający na PS 1.7.0 zainicjowanie procesu wiązania koszyka z aplikacją mobilną

  • poprawione przypadki błędnie budowanych na stronie konfiguracji modułu ścieżek do statycznych zasobów

  • poprawione przypadki, gdzie aktualizacja koszyka na PS 1.7.6 mogła skutkować błędem z uwagi na niedostępność używanych przez wtyczkę komponentów

  • dodany zapis identyfikatora transakcji przy obiekcie płatności
    dodane ukrywanie widgetu wiązania koszyka z aplikacją mobilną na stronie produktu w przypadku, gdy produkt nie jest dostępny a koszyk nie został już wcześniej powiązany

  • dodana opcja pozwalająca na odświeżenie stanu widgetu wiązania koszyka po załadowaniu strony produktu w przypadku wykorzystania narzędzi cache'ujących pełną zawartość HTML strony

  • dodana opcja umieszczenia dodatkowej zwartości w komentarzu do zamówienia w przypadku, gdy klient wybierze dostawę do Paczkomatu

Wersja 1.6.0 (29.04.2024):

  • poprawiony błąd uniemożliwiający w wersjach PS między 1.7.3 i 1.7.6 utworzenie zamówienia przez aplikację mobilną

  • zmieniony układ strony konfiguracji modułu w wersjach PS poniżej 1.7.6

  • poprawiony błąd w wersjach PS między 1.7.4 i 1.7.6 powodujący nieuwzględnienie kodów rabatowych w sumarycznej wartości koszyka prezentowanej w aplikacji mobilnej

  • dodana możliwość wyświetlenia widgetu parowania koszyka w dodatkowych miejscach (formularze logowania i rejestracji, checkout, podgląd koszyka)

  • dodana możliwość przełączenia z poziomu strony konfiguracji modułu alternatywnych hooków, które powinny zostać użyte do wyświetlenia widgetu na stronie produktu oraz w checkoucie

  • dodane przekazywanie do aplikacji mobilnej informacji o zmianie statusu zamówienia rozszerzona możliwość konfiguracji dostępnych metod płatności

  • dodane wyświetlanie szczegółów dostawy na stronie zamówienia w panelu administracyjnym w wersjach PS poniżej 1.7.7

  • poprawiony błąd powodujący w wersjach PS od 8.0 powstanie nieprawidłowego kodu JavaScript w przypadku, gdy włączona była funkcjonalność CCC

  • dodane wersjonowanie statycznych plików modułu (w przypadku front-office na PS 8 i późniejszych - zmieniony sposób wersjonowania assetów)

Wersja 1.5.7 (27.03.2024)

  • poprawiony błąd powodujący w wersjach PS wcześniejszych niż 1.7.5 natychmiastowe przerwanie nasłuchiwania na zdarzenie powiązania koszyka z aplikacją po kliknięciu w przycisk parowania koszyka na karcie produktu.

Wersja 1.5.6 (20.03.2024)

  • poprawiony błąd w formularzu konfiguracyjnym dla wersji PS wcześniejszych niż 1.7.6, gdzie mimo wyboru opcji wyświetlania widgetu jedynie testerom, widget był widoczny dla wszystkich użytkowników

Wersja 1.5.5 (20.03.2024):

  • zaktualizowane deep linki dla środowisk testowych

  • dodana możliwość ustawienia mapowania metod dostawy na różnych przewoźników w zależności od wybranych dodatkowych usług (płatność za pobraniem, Paczka w Weekend)

  • usunięta możliwość konfiguracji dostępności płatności za pobraniem w zależności od dnia tygodnia i czasu

  • usunięta możliwość konfiguracji dostępności Paczki w Weekend dla przesyłki kurierskiej

  • poprawione przypadki, gdzie aktualizacja koszyka mogła skutkować błędem 500 z uwagi na niedostępność używanych przez wtyczkę komponentów

  • usunięte prezentowanie InPost Pay na liście dostępnych metod płatności w widoku zamówienia

  • poprawiona obsługa przypadków, gdzie serwer sklepu nie pozwala na zapytania metodą DELETE

  • poprawiony błąd, gdzie wymagany numer telefonu komórkowego w danych adresowych skutkował brakiem możliwości złożenia zamówienia przez aplikację mobliną

Wersja 1.5.4 (22.02.2024):

  • poprawka błędu z wyłączoną opcją płatności pobraniowej

  • zniesienie ograniczenia instalacji na PrestaShop 8.x

  • zmiany w przekazywaniu opisów produktów

Wersja 1.5.3 (20.02.2024):

  • poprawki dotyczące API PrestaShop

Wersja 1.5.2 (20.02.2024):

  • poprawki konfiguracji zgód oraz opisów statusów zamówień

  • ograniczenie wymagalności tekstu opisu zgody jedynie do języka domyślnego dla sklepu

  • poprawione błędy skutkujące niedostępnością API PrestaShop

Wersja 1.5.1 (20.02.2024):

  • poprawka dotycząca zapisywania zmian w formularzach

Wersja 1.5.0 (16.02.2024):

  • poprawiona obsługa błędów i niezawodność działania wtyczki

  • dodane prezentowanie w aplikacji mobilnej atrybutów produktów posiadających warianty

  • dodana opcja konfiguracyjna pozwalająca wybrać miejsce wyświetlania widgetu "thank you" na stronie potwierdzenia zamówienia

  • poprawiony błąd przy aktualizacji ilości produktu w koszyku w aplikacji mobilnej, gdzie dostępny stan produktu był pomniejszany o ilość już znajdującą się w koszyku

  • poprawione produkty sugerowane prezentowane w aplikacji (nieuwzględnianie produktów niedostępnych)

  • poprawiona cena jednostkowa produktu prezentowana w danych zamówienia w aplikacji mobilnej (uwzględnienie zniżek nie wynikających z zastosowania kodów rabatowych)

  • poprawione przypadki, gdzie znaki specjalne w opisach produktów mogły powodować problem z synchronizacją danych koszyka między aplikacją mobilną a sklepem

  • zmieniony układ strony konfiguracji modułu na PrestaShop w wersji 1.7.6 i późniejszych

 

 

Na tej stronie

 

 

Wymagania

Do poprawnego działania wymagana jest instalacja PrestaShop w wersji nie niższej niż 1.7.1 oraz PHP w wersji nie niższej niż 7.1.

 

 

Instalacja

W celu instalacji wtyczki postępuj zgodnie z poniższymi krokami:

  1. Pobierz spakowaną wtyczkę PrestaShop ze strony InPost i nie rozpakowuj jej

  2. Zaloguj się do sekcji administracyjnej swojego sklepu

  3. Z menu po lewej stronie wybierz “Moduły” a następnie “Menedżer modułów”.

  4. Na górze strony kliknij “Załaduj moduł”.

    Image_220224_14_55.png

  5. Do otwartego okna przeciągnij uprzednio pobrany moduł.

    image-20240216-153609.png

 

 

 

Konfiguracja modułu

W celu wstępnej konfiguracji przejdź do listy modułów i kliknij “Konfiguruj” obok modułu InPost Pay. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.

 

konfiguracja.gif

 

Ustawienia podstawowe

Zakładka “Ustawienia” w konfiguracji modułu zawiera podstawowe ustawienia konfiguracyjne modułu.

image-20240603-154629.png

Ustawienia środowiska i klucze API


Konfiguracja środowiska zawiera wymagane pola, które trzeba uzupełnić jako pierwsze przy konfiguracji wtyczki.

Środowisko

image-20240216-154304.png

Konfiguracja środowiska zawiera trzy typy środowiska:

  • UAT - testowe środowisko przeznaczone dla developerów

  • Sandbox - testowe środowisko przeznaczone dla merchantów w celu testów wtyczki przed uruchomieniem produkcyjnym

  • Produkcja - środowisko produkcyjne, używaj tylko i wyłącznie jeśli przetestowałeś już wtyczkę na środowisku sandbox

Wyświetlanie widgetu

W konfiguracji modułu możesz ustawić widoczność widgetu.

image-20240216-154600.png

Dostępne są dwie opcje:

  • wszystkim - widget widoczny jest dla każdego kto dokonuje zakupy na sklepie, uruchamiaj tylko gdy wtyczka jest już skonfigurowana produkcyjnie i przetestowana

  • testerom - widget widoczny jest tylko po dodaniu parametru showIzi=true do url strony. Przykład https://mojsklep.pl?showIzi=true

Client ID

Wymagane pole konfiguracyjne.

image-20240216-154714.png

Client ID różni w zależności od wybranego środowiska. Aby uzyskać sandboxowe Client ID skontaktuj się z nami przez formularz kontaktowy. Aby uzyskać produkcyjne Client ID zaloguj się do InPost i uzupełnij dane sklepu.

Client secret

image-20240216-154856.png

Client Secret różni się w zależności od wybranego środowiska. Aby uzyskać sandboxowe Client Secret skontaktuj się z nami przez formularz kontaktowy. Aby uzyskać produkcyjne Client Secret zaloguj się do InPost i uzupełnij dane sklepu.

POS ID

Wymagane pole konfiguracyjne.

image-20240216-154959.png

W przypadku środowiska sandbox - otrzymasz tą wartość razem z Client Id i Client Secret po uzupełnieniu formularza. W przypadku środowiska produkcyjnego - zaloguj się do InPost i pobierz POS ID.

Konfiguracja metod płatności

Konfiguracja dotycząca metod płatności jakimi będzie można dokonać płatność aplikacji InPost.

Dostępne metody płatności

Metody płatności zostały określone na umowie o obsługę bramki płatniczej.

image-20240603-154844.png

Wybierz z listy rozwijanej metody płatności, które powinny być dostępne.

image-20240603-155247.png

Płatność przy odbiorze

Płatność przy odbiorze będzie dostępna tylko wtedy, kiedy posiadasz podpisaną umowę z InPost na świadczenie tej usługi w Twoim sklepie.

image-20240216-155321.png

 

Konfiguracja statusów zamówień

Gdy zamówienie zostanie utworzone z użyciem InPostPay możesz przypisać dla nich odpowiednie statusu zamówienia w swoim sklepie PrestaShop.

Początkowy status zamówienia utworzonego przez InPost Pay

Początkowy status dla zamówienia utworzonego poprzez aplikację InPost. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20240216-155351.png

Status zamówienia utworzonego przez InPost Pay (płatność za pobraniem)

Początkowy status dla zamówienia utworzonego poprzez aplikację InPost dla płatności za pobraniem. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20241028-154352.png

Status dla zamówienia opłaconego przez InPost Pay

Status dla zamówienia, które zostało opłacone poprawnie przez klienta w aplikacji InPost. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20240216-155445.png

Wyświetlanie widgetu na stronie potwierdzenia zamówienia

Widget na stronie potwierdzenia zamówienia możesz wyświetlać przez konfiguracje w trzech hookach. Wybierz ten, który najbardziej odpowiada twojemu szablonowi w sklepie. Widget musi być widoczny na górze strony od razu przy przekierowaniu na stronę potwierdzenia zamówienia.

Dostępne są trzy hooki:

  • displayPaymentReturn - domyślny hook w PrestaShop widoczny na stronie potwierdzenia zamówienia

  • displayOrderConfirmation - domyślny hook w PrestaShop widoczny na stronie potwierdzenia zamówienia

  • displayIziThankYou - hook modułu InPostPay, który umożliwia Ci użycie widgetu na stronie thank you page w dowolnym miejscu, jeśli hooki domyślne nie spełniają poprawnie swojej roli. Wymagana jest ręczna implementacja takiego hooka w pliku templates/checkout/order-confirmation.tpl dodajemy {hook h="displayIziThankYou" order=$order}.

Wyświetlanie widgetu na karcie produktu

Widget na karcie produktu możesz wyświetlać przez konfiguracje w dwóch hookach. Wybierz ten, który najbardziej odpowiada twojemu szablonowi w sklepie.

Dostępne są dwa hooki:

  • displayProductActions - domyślny hook w PrestaShop widoczny na stronie produktu

  • displayProductAdditionaInfo - domyślny hook w PrestaShop widoczny na stronie produktu

 

Wyświetlanie widgetu w checkoucie

Widget w checkoucie możesz wyświetlać przez konfiguracje w dwóch hookach.

Dostępne są dwa hooki:

  • displayCheckoutSummaryTop

  • displayIziCheckoutButton - wymagana jest ręczna implementacja w pliku szablonu {hook h="displayIziCheckoutButton" order=$order}.

 

Statusy zamówień

Nazwy statusów zamówień możesz zmieniać dla zamówień złożonych poprzez aplikację InPost.

Image_220224_14_57.png

Jeśli nie zostanie zmieniony jakiś status zamówienie to będzie wyświetlany nazwa w zależności od konfiguracji danego statusu w PrestaShop.

Komentarz zamówienia

Moduł pozwala na opcjonalne umieszczenie dodatkowych informacji w komentarzu do zamówienia w przypadku, gdy klient wybierze dostawę do Paczkomatu:

image-20240617-135109.png

W szablonie wiadomości dostępne do użycia są następujące parametry:

  • payment_type - kod wybranej przez klienta metody płatności

  • delivery_point - numer wybranego Paczkomatu

  • delivery_codes - lista kodów wybranych przez klienta usług dodatkowych

  • is_pww - czy klient wybrał usługę Paczka w Weekend (prawda/fałsz)

  • is_cod - czy klient wybrał usługę płatności pobraniowej (prawda/fałsz)

Fragmenty odpowiadające nazwie parametru umieszczonej w nawiasach klamrowych (“{ }”) zastępowane są wartością parametru - np. jeżeli klient wybrał dostawę do Paczkomatu “ABC123”, szablon:

Wybrany Paczkomat: {delivery_point}.
poskutkuje wiadomością treści:

Wybrany Paczkomat: ABC123.
Wartości logiczne wypisywane są jako “true” lub “false”, listy - ograniczone nawiasami kwadratowymi (“[ ]”).

Podwójne nawiasy klamrowe (“{{ }}“) pozwalają na wypisanie wyliczonej wartości wyrażenia - np. szablon:

Paczka w Weekend: {{ is_pww ? "tak" : "nie" }}.
poskutkuje wiadomością treści:

Paczka w Weekend: tak.
lub

Paczka w Weekend: nie.
w zależności od tego, czy klient wybrał odpowiednią opcjonalną usługę.

Szczegółowe informacje na temat składni wyrażeń można znaleźć w dokumentacji komponentu Expression Language w wersji odpowiedniej dla używanej wersji PrestaShop (2.x dla PS 1.7.0 - 1.7.3, 3.x dla pozostałych wersji 1.7, 4.x dla PS 8.x). Funkcja constant nie jest dostępna.

Sugerowane produkty

W konfiguracji modułu możesz ustawić maksymalną ilość produktów sugerowanych jakie mają być wyświetlane w aplikacji w podglądzie koszyka.

image-20240216-155726.png

 

Gdy wartość jest pusta ilość produktów będzie wyświetlana bez limitu. Produkty sugerowane są pobierane z produktów powiązanych, które aktualnie są dodane w do koszyka. Produkty powiązane możemy znaleźć na stronie konfiguracji danego produktu w zakładce “Ustawienia podstawowe”. Produkty powiązane są domyślną funkcją PrestaShop.

image-20240216-155803.png

 

produkty-powiazane.gif

 

Zgody

W zakładce “Zgody” możemy dodać zgody, jakie będą wyświetlane w aplikacji InPost na etapie składania zamówienia. Przy dodawaniu zgody jest możliwość aby wskazać dodatkowe linki do wyświetlenia przy niej w aplikacji mobilnej. Nowe zgody możemy dodawać poprzez wybranie przycisku “Dodaj kolejną zgodę”.

image-20240807-141558.png

 

Opis wyświetlany w aplikacji

W polu “Opis wyświetlany w aplikacji” - wpisujemy treść danej zgody jaka ma być wyświetlana w aplikacji InPost. Pole jest wielojęzyczne.

image-20240216-160007.png

Obligacja zgody

Zgoda może być obligatoryjna do złożenia zamówienia lub opcjonalna.

image-20240216-160034.png

Pole przyjmuje wartości:

  • Opcjonalny - zgoda nie jest wymagana na etapie składania zamówienia

  • Zawsze wymagany - zgoda jest wymagana za każdym razem na etapie składania zamówienia

  • Wymagany raz - zgoda jest wymagana tylko raz na etapie składania zamówienia.

Identyfikator

Unikalny identyfikator linku. W opisie zgody fragmenty powstałe przez dodanie do ID przedrostka “#” zostaną zastąpione odpowiadającymi linkami.

image-20240807-142626.png

Adres zgody

W polu “Adres zgody” wybieramy stronę CMS, do której ma linkować dana zgoda w celu przeczytania informacji na temat danej zgody.

image-20240216-155940.png

Tekst na przycisku

Tekst, który zostanie wyświetlony na przycisku linku zgody. W przypadku pozostawienia pola pustego zostanie wyświetlony tekst “link”.

image-20240807-143245.png

 

Cena transportu

Zakładka “Cena transportu” zawiera pola konfiguracje dotyczące mapowania metod dostawy, kosztów oraz dostępności dostawy. Konfiguracje ustawiamy osobno dla usługi “Kurier” oraz “Paczkomat”.

 

image-20240404-094037.png

 

Kurier

Konfiguracja usługi kuriera.

image-20240404-094141.png

Mapowanie metody dostawy - Kurier

Pole Mapowanie przewoźnika jest odpowiedzialne za zmapowanie metody dostawy z PrestaShop dla usługi Kuriera. W przypadku gdy dla usługi Kuriera i opcji płatności za pobraniem występuje osobna metoda dostawy wykonujemy mapowanie tej usługi w polu Mapowanie przewoźnika (Płatność za pobraniem).

image-20240404-094455.png

Kurier pobranie

Pole Płatność za pobraniem (Dodatkowy koszt) zawiera wartość netto kwoty do doliczenia w przypadku gdy usługa zostanie wybrana.

image-20240404-094554.png

Paczkomat

Konfiguracja usługi Paczkomat.

 

image-20240404-094927.png

 

Mapowanie metody dostawy - Paczkomat

Pole Mapowanie przewoźnika jest odpowiedzialne za zmapowanie metod dostawy z PrestaShop dla usługi Paczkomat. W sytuacji gdy dla opcji dodatkowych dostawy do Paczkomatu Płatność za pobraniem i Paczka w weekend występują osobne metody dostawy w PrestaShop wykonujemy mapowanie w odpowiednich polach Mapowanie przewoźnika (Płatność za pobraniem), Mapowanie przewoźnika (Paczka w Weekend), Mapowanie przewoźnika (Płatność za pobraniem + Paczka w Weekend).

image-20240404-095354.png

 

Paczkomat pobranie

Pole Płatność za pobraniem (Dodatkowy koszt) zawiera wartość netto kwoty do doliczenia w przypadku gdy usługa zostanie wybrana.

image-20240404-095814.png

 

Koszt dla usługi Paczkomat paczka w weekend

Pole Paczka w Weekend (Dodatkowy koszt) jest odpowiedzialne za koszt netto usługi Paczkomat w weekend. Stawka VAT pobierana jest z konfiguracji przewoźnika zmapowanego w polu “Paczkomat”.

image-20240404-095851.png

Dostępność usługi Paczkomat paczka w weekend

Za dostępność usługi “Paczkomat paczka w weekend” odpowiadają pola dostępności. “Dostępny od” - “Dostępny do” określa okres czasu od jakiego ma być dostępna usługa paczki w weekend w aplikacji InPost.

image-20240404-100039.png

 

Ustawienia GUI

Zakładka “Ustawienia GUI” jest odpowiedzialna za konfiguracja wyświetlania widgetu przycisku na stronie produktu oraz koszyka. Przyciski poglądowe są odświeżane dynamicznie aby zaprezentować aktualny wygląd przycisku z danymi ustawieniami. Trzeba pamiętać o kliknięciu w przycisk “Zapisz” aby zapisać aktualne zmiany dokonane w konfiguracji.

Image_220224_15_02.png

 

Strona koszyka

Widget przycisku wyświetlany jest na stronie koszyka i umożliwia połączenie koszyka z aplikacją InPost oraz jego realizację z poziomu aplikacji.

Strona produktu

Widget przycisku wyświetlany jest na karcie produktu i umożliwia on połączenie koszyka z aplikacją InPost. Wybranie przycisku jednoczenie dodaje produkt do koszyka. Pozwala także na ograniczenie wyświetlania widgetu parowania koszyka na stronach produktów w zależności od typu, domyślnej kategorii, producenta lub atrybutów produktu.

Strona logowania

Widget przycisku wyświetlany jest na stronie logowania pod formularzem logowania.

Strona rejestracji

Widget wyświetlany jest na stronie rejestracji nad formularzem rejestracji.

Strona zamówienia

Widget przycisku wyświetlany jest na stronie realizacji zamówienia powyżej podsumowania zamówienia.

Podgląd koszyka

  • Widget przycisku wyświetlany jest na podglądzie koszyka. Wymaga użycia niestandardowego hooku – należy zaimplementować w szablonie
    {hook h="displayIziCartPreviewButton"}.

 

Konfiguracja widgetu

Pola dla konfiguracji widgetu na stronie koszyka oraz produktu są takie same. Jednak wygląd każdego przycisku może się różnić i moduł daje możliwość konfiguracji tych pól osobno dla każdego umiejscowienia.

Wyświetlanie widgetu

Moduł umożliwia wyłączenie wyświetlania takiego przycisku dla strony produktu oraz koszyka. Zalecane jest w celu zwiększenia konwersji by widget był widoczny na stronie koszyka, zarówno jak na karcie produktu.

image-20240216-161537.png

Wyrównanie widgetu

Określa orientację widżetu w dostępnej dla niego przestrzeni. Jeśli szablon przydziela wąską przestrzeń dla widżetu, ustawienie to nie wpłynie na jego wygląd.

image-20240216-161609.png

 

Dostępne opcje wyrównania:

  • Do lewej - powoduje przesunięcie widgetu do lewej strony

  • Wyśrodkowane - powoduje wyśrodkowanie widgetu

  • Do prawej - powoduje przesunięcie widgetu do prawej strony

Tło widgetu

Określa czy widget znajduje się na jasnym czy ciemnym tle w Twoim sklepie. Ustawienie ma wpływ na kolor czcionki, zadbaj o to, aby była widoczna.

image-20240216-161730.png

Tło widget zawiera dwie opcje:

  • Jasne - wybierz tą opcję jeśli przycisk jest wyświetlany na jasnym tle

  • Ciemne - wybierz tą opcję jeśli przycisk jest wyświetlany na ciemnym tle

Wariant widgetu

Widget dostępny jest w 2 wariantach kolorystycznych. Wybierz ten, bardziej odpowiadający kolorystyce Twojego sklepu.

image-20240216-161857.png

Wariant widgetu zawiera dwie opcje do wyboru:

  • Żółty - wybierz tą opcję jeśli chcesz by przycisk miał kolor żółty

  • Czarny - wybierz tą opcję jeśli chcesz by przycisk miał kolor czarny

Styl ramki widgetu

Pole konfiguracyjne określa w jakim stylu powinien być wyświetlony przycisk na stronie sklepu.

image-20240216-162014.png

Konfiguracja stylu ramki zawiera trzy warianty:

  • Kwadratowe - wybierz tą opcję jeśli chcesz by przycisk nie miał zaokrąglonych rogów

  • Zaokrąglone - wybierz tą opcję jeśli chcesz by rogi były nieznacznie zaokrąglone

  • Okrągłe - wybierz tą opcję jeśli chcesz by rogi były mocno zaokrąglone.

Szerokość widgetu

Moduł umożliwia nam ustawienia dla widgetu:

  • minimalnej wartości szerokości – wartość pomiędzy 220 a 1200

  • minimalnej wartości szerokości – wartość pomiędzy 220 a 1200

  • maksymalnej wartości wysokości – wartość pomiędzy 48 a 64

image-20240807-151218.png

 

W pole wpisujemy tylko wartości numeryczne bez przyrostka “px”.

Marginesy widgetu

Jeżeli przycisk jest źle ułożony lub “styka” się z innymi elementami UI na stronie sklepu, masz możliwość określenia marginesów dla widgetu.

Image_220224_15_03.png

 

Wszystkie pola marginesów przyjmują wartość numeryczną bez przyrostka “px”.

Ograniczenia produktów

Konfiguracja warunków przy których widget nie zostanie wyświetlony na stronach produktów.

image-20240807-144456.png

Typ produktu

Pole konfiguracyjne określa na produktach jakiego typu widget nie będzie wyświetlany.

image-20240807-145525.png

Konfiguracja typu produktu posiada sześć wariantów:

  • Zaznacz wszystkie pola – zaznacza wszystkie poniższe pola

  • Standardowe produkty - podstawowy rodzaj produktu, który nie ma opcji do wyboru ani wariantów

  • Produkty z kombinacjami - produkty, które mają różne warianty, takie jak rozmiary, kolory, czy inne cechy, które wpływają na cenę i dostępność

  • Dostosowywalne produkty - produkty, które można dostosować przez klienta, na przykład poprzez dodanie personalizacji, takiej jak grawerowanie lub druk

  • Zestawy produktów - grupa produktów sprzedawanych razem jako zestaw, często z niższą ceną niż zakup pojedynczych produktów osobno

  • Produkty wirtualne - produkty, które nie istnieją fizycznie, na przykład pliki do pobrania, subskrypcje lub usługi internetowe.

Marka produktu

Pole konfiguracyjne określa na produktach jakiej marki widget nie będzie wyświetlany.

image-20240807-145659.png

Ilość wyświetlanych wariantów jest zależna od indywidualnej ilości marek w danym sklepie.

Grupa atrybutów

Pole konfiguracyjne określa na produktach z jakim atrybutem widget nie będzie wyświetlany.

image-20240807-145923.png

Ilość wyświetlanych wariantów jest zależna od indywidualnej ilości atrybutów w danym sklepie.


Kategorie


Pole konfiguracyjne określa na produktach jakiej kategorii widget nie będzie wyświetlany.

image-20240807-150049.png

Ilość wyświetlanych wariantów jest zależna od indywidualnej ilości kategorii w danym sklepie.

Zakładka Support

Zakładka “Support” zawiera przydatne informacja min. status wtyczki, który informuje czy wtyczka została poprawnie skonfigurowana. Umożliwia nam włączyć tryb debugowania oraz pobrać logi wraz z przydatnymi informacjami, która mogą pomóc przy rozwiązać problem podczas kontaktu z supportem.

Image_220224_15_04.png

Status wtyczki

Status wtyczki informuje nas czy moduł jest poprawnie skonfigurowany. Jeśli moduł jest poprawnie skonfigurowany wyświetla on status “OK”.

image-20240216-162345.png

 

Jeśli występują jakieś problemy z konfiguracją wyświetlana jest status “BŁĄD” i moduł dostarcza informacji na temat błędu w konfiguracji.

image-20240216-162405.png

Pobieranie danych wtyczki oraz logów

Moduł umożliwia pobranie danych na temat wtyczki oraz logów modułu, które pomogą przy rozwiązaniu problemów związanych z wtyczką.

image-20240216-162455.png

Tryb debugowania

Włącznie trybu debugowania zwiększa ilość informacji jaka jest zawarta w logach modułów. Może być przydatne w ramach supportu wtyczki gdzie wszelkie informację zawarte w logach mogą pomóc w rozwiązaniu problemu.

image-20240216-162538.png