Page Comparison

Dokumentacja techniczna wtyczki InPost Pay dla Woocommerce. Wtyczka dodaje do sklepu
Woocommerce funkcjonalność dokonywania zamówień przez aplikację InPost przez:

• Dodanie tabeli w bazie danych,

• Dodanie przycisku “Utwórz koszyk z InPost Pay” na listingu produktów,Dodanie przycisku “Utwórz koszyk z InPost Pay” na karcie produktu,

• Dodanie przycisku “Utwórz koszyk “Kup z InPost Pay” na stronie koszyka,

• Dodanie przycisku “Utwórz koszyk “Kup z InPost Pay” na stronie zamówienia,

• Akcji wykonywanych na standardowe hook’i,

• Dodaniu pola na stronie zamówienia,

• Dodaniu sekcji administracyjnej,

• Udostępnienia REST API,

• Dołączenia do strony pliku JS serwowanego z webserwera oraz pliku serwowanego z zasobu zewnętrznego.

Wtyczka: (2330.08.2023r) wersja 1.3.4109.2024r - 1.5.4.1

*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:

Wymagania

Do poprawnego działania wtyczka wymaga:

• Woocommerce w wersji 7.0 i wyższej

• Wordpress w wersji 6.2 i wyższej

Instalacja

Podczas instalacji wtyczka dodaje do bazy danych tabelę opisaną w https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/132382721/InPost+Pay+-+Woocommerce#Baza-danych.

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

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

2. Zaloguj się do sekcji administracyjnej swojego sklepu

3. Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”

   Image Removed

4. Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1

   Image Removed

5. Kliknij “Zainstaluj”

6. W następnym oknie kliknij “Włącz wtyczkę”

Konfiguracja Testowa

W tym rozdziale opisujemy skrócony proces konfiguracji potrzebny do przeprowadzenia testów działania integracji z InPost Pay. W celu wstępnej konfiguracji przejdź dosekcji administracyjnej sklepu i kliknij “InPost Pay” w menu po lewej stronie. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki. Wypełnij pola zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Sandbox” - w ten sposób pieniądze nie będą pobierane z konta podczas testów.
   b. Pokazuj widget ustawa na “Testerom” - w ten sposób widget będzie widoczny tylko dla osób, które mają go zobaczyć. Ustawienie innej opcji wyświetli widget działający bądź nie wszystkim osobom odwiedzającym Twój sklep
   W celu wyświetlenia widgetu w przeglądarce internetowej wpisz adres
   Twojego sklepu z dopiskiem ?showIzi=true
   Przykład: https://mojsklep.pl?showIzi=true

Image Removed

2. Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
   a. Client
   b. Client Secret

Image Removed

3. Pole POS ID wypełnij losowym ciągiem znaków (123abc)

Image Removed

4. Włącz możliwość płatności

Image Removed

5. Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale 6 Pełna konfiguracja

Image Removed

6. Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay

Image Removed

7. Połącz wysyłkę Kurierem z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Kurierem w aplikacji InPost

Image Removed

8. Połącz wysyłkę przez Paczkomat z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Paczkomat w aplikacji InPost

Image Removed

10. Określ gdzie widget powinien być dostępny na Twojej stronie
    Możesz wyświetlać go na karcie produktu oraz w koszyku
    Dla każdego miejsca wyświetlania możesz określić, do której strony przycisk InPost Pay będzie wyrównany
    Dla każdego miejsca możesz osobno wybrać, czy tło na stronie jest jasne czy ciemne co zapewnia poprawne wyświetlanie tekstów. Dla każdego miejsca możesz oddzielnie wybrać wariant wyświetlania. Przycisk może być amarantowy bądź żółty

Image Removed

Konfiguracja Produkcyjna

Po poprawnej konfiguracji testowej i upewnieniu się, że integracja w środowisku Sandbox działa należy udostępnić InPost Pay wszystkim użytkownikom. W celu 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.

Zmień konfigurację zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Produkcyjne” - w ten sposób pieniądze będą pobierane
   z konta podczas testów
   b. Pokazuj widget ustawa na “Wszystkim”

Image Removed

2. Pole POS ID ustaw zgodnie z umową z InPost

Image Removed

Produkty sugerowane

Aplikacja InPost podczas dokonywania zakupów z InPost Pay sugeruje produkty do dodania do koszyka zgodnie z wbudowanym w WooCommerce systemem Produktów Powiązanych.

Jak wyświetlić produkty sugerowane w aplikacji?

W celu pokazania produktów sugerowanych należy uzupełnić sekcję Produktów Powiązanych w konfiguracji produktu WooCommerce.

W tym celu:

1. Przejdź do edycji produktu w Twoim sklepie.

2. W panelu Dane Produktu wybierz sekcję “Powiązane produkty”.

3. Wypełnij sekcje “pu-sell” bądź “cross-sell” - produkty z obu sekcji będą widoczne w aplikacji.

Image Removed

Na stronie widzę produkty sugerowane a w aplikacji nie

Możliwe, że Twój sklep prezentuje produkty powiązane w niestandardowy sposób. Dzieje się tak na przykład przez to jak działa Twój szablon bądź jedna z zainstalowanych wtyczek. Jeśli Twój sklep prezentuje produkty sugerowane a nie widzisz ich w Aplikacji InPost upewnij się, że Produkty Powiązane są skonfigurowane zgodnie z instrukcją zawartą w akapicie powyżej.

Wtyczka logistyczna

InPost dostarcza dedykowaną wtyczkę do integracji z InPost dla Klientów WooCommerce. Wtyczka ta pozwala na w pełni zautomatyzowany przebieg procesu zakupowego łącznie z nadaniem numeru przesyłki i wysłaniem go do Twoich klientów przez aplikację InPost w procesie zakupowym InPost Pay.

Pobierz wtyczkę z: https://wordpress.org/plugins/inpost-for-woocommerce/

Dokumentacja: [PL] WooCommerce

Jak nadać paczkę jeśli mam wtyczkę logistyczną InPost?

Sposób wysyłki, adres oraz identyfikator paczkomatu automatycznie zostaną przekazane do wtyczki logistycznej. Ty nie musisz znać danych klienta. Musisz nadać paczkę zgodnie z instrukcją wtyczki.

Jak nadać paczkę jeśli nie mam wtyczki logistycznej InPost?

Na stronie zamówienia dokonanego przez InPost Pay dostępne są informacje mówiące o sposobie wysyłki oraz numerze paczkomatu w formie okienka. Skopiuj je i postępuj zgodnie z Twoim standardowym procesem nadawania paczek.

Image Removed

Konfiguracja Pełna

Konfiguracja została podzielona na sekcje umożliwiające dostosowanie działania wtyczki do potrzeb sklepu

Po instalacji wtyczki w menu po lewej stronie sekcji administracyjnej zobaczysz nowe menu “InPost Pay”

Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki

Ustawienia API

W tej sekcji ustawia się dane dostępowe do systemu, rodzaje obsługiwanych metod płatności oraz informacja wymieniane mędzy InPost Pay a sklepem

Dane produkcyjne otrzymasz po podpisaniu umowy o usługę InPost Pay

Opis dostępnych opcji:

Środowisko

Image Removed

Do czego służy:

Jak ustawić:

Określa czy sklep wysyła dane do
środowiska testowego czy produkcyjnego

Kiedy testujesz integrację ustaw środowisko Testowe.
Jeśli testy przebiegły pomyślnie i chcesz włączyć możliwość kupna przez InPost Pay ustaw środowisko Produkcyjne

Pokazuj widget

Image Removed

Do czego służy:

Jak ustawić:

Podczas testów nie chcemy, żeby widget InPost Pay wyświetlał się wszystkim klientom. Niezależnie od tego jakie środowisko zostało ustawione możesz tymczasowo ukryć widget i pokazywać go tylko wybranym osobom. W celu wyświetlenia widgetu w trybie tylko dla testerów wejdź na stronę główną sklepu i dodaj na końcu adresu url ?showIzi=true
Na przykład
https://outofthebox.pl?showIzi=true

Kiedy konfigurujesz integrację wybierz
Testerom
W celu pokazania widgetu wszystkim już po
wykonaniu testów konfiguracji ustaw
Wszystkim

Client ID

Image Removed

Do czego służy:

Jak ustawić:

Dana dostępowa do API umożliwiająca działanie wtyczki.

Zgodnie z danymi otrzymanymi od InPost

Client Secret

Image Removed

Do czego służy:

Jak ustawić:

Dana dostępowa do API umożliwiająca działanie wtyczki.

Zgodnie z danymi otrzymanymi od InPost

POS ID

Image Removed

Do czego służy:

Jak ustawić:

Dana dostępowa do API

Zgodnie z danymi otrzymanymi od InPost

Włącz płatności zgodne z podpisaną umową z Aion

Image Removed

Do czego służy:

Jak ustawić:

Określa, czy Twoi klienci będą mogli dokonywać płatności przez bramki
płatnicze, które są zawarte w Twojej umowie z Aion takie jak Blik, Apple Pay, płatność kartą

Zaznacz Tak jeśli metody mają być dostępne

Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost

Image Removed

Do czego służy:

Jak ustawić:

Określa, czy Twoi klienci będą mogli dokonywać płatności przy odbiorze zgodnie z umową z InPost

Zaznacz Tak jeśli metoda ma być dostępna

Status zamówienia dla zamówienia opłaconego przez InPost Pay

Image Removed

Do czego służy:

Jak ustawić:

Określa jaki status mają mieć zamówienia, które zostaną opłacone przez InPost Pay

Wybierz z listy status jakie mają mieć zamówienia opłacone

Status zamówień

Image Removed

Do czego służy:

Jak ustawić:

Określa jakie nazwy statusów mają pojawić się w aplikacji InPost Pay (kolumna po prawej) dla zamówień w Twoim sklepie (kolumna po prawej)

Zweryfikuj czy poniższe statusy odpowiadają statusom, które Twój klient otrzymuje w komunikacji dotyczącej zamówienia

Maksymalna liczba produktów sugerowanych

Image Removed

Do czego służy:

Jak ustawić:

Określa maksymalną liczbę produktów, jakie zostaną zasugerowane Twojemu klientowi w aplikacji Inpost do produktów jakie już ma w koszyku. Produkty sugerowane pobierane są ze standardowego mechanizmu WooCommerce

Wpisz maksymalną liczbę produktów

Zgody

Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.

Dodawanie:
Po każdym zapisie formularze będziesz mógł dodać kolejną zgodę.

Usuwanie:
W celu usunięcia zgody pozostaw jej opis pusty i zapisz formularz.

Opis dostępnych opcji:

Adres zgody

Image Removed

Do czego służy:

Jak ustawić:

Określa stronę, na którą zostanie przekierowany Twój klient w celu
przeczytania zgody. Strony widoczne na liście to standardowe
Strony dostępne w Wordpress

Wybierz jedną ze stron Twojego sklepu z listy rozwijalnej

Opis wyświetlany w aplikacji

Image Removed

Do czego służy:

Jak ustawić:

Określa opis wyświetlany w aplikacji

Wpisz opis, jaki ma zostać wyświetlony

Czy wymagane

Image Removed

Do czego służy:

Jak ustawić:

Określa czy zgoda jest wymagana

Wpisz wymagalność zgody z listy

Cena transportu netto

Sekcja odpowiedzialna za mapowanie form transportu oraz określenie dostępności i cen opcji dodatkowych transportu

Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji
Poniżej generyczny opis gdzie jako typ wysyłki zostało użyte typ oraz opcja dla opcji wysyłki:

Dolicz VAT do ceny transportu

Image Removed

Wymagania

Do poprawnego działania wtyczka wymaga:

• Woocommerce w wersji nie niższej niż 7.0.0

• PHP w wersji nie niższej niż 7.4

Instalacja / Aktualizacja

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

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

2. Zaloguj się do sekcji administracyjnej swojego sklepu

3. Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”

   Image Added

4. Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1

   Image Added

5. Kliknij “Zainstaluj”

6. W następnym oknie kliknij “Włącz wtyczkę”

W celu aktualizacji wtyczki postępuj zgodnie z powyższymi krokami. Przy aktualizacji wtyczki ustawienia nie kasują się.

Konfiguracja Testowa

W tym rozdziale opisujemy skrócony proces konfiguracji potrzebny do przeprowadzenia testów działania integracji z InPost Pay. W celu wstępnej konfiguracji przejdź do sekcji administracyjnej sklepu i kliknij “InPost Pay” w menu po lewej stronie. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki. Wypełnij pola zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Sandbox” - w ten sposób przetestujesz proces zakupowy na środowisku testowym.
   b. Pokazuj widget ustaw na “Testerom” - w ten sposób widget będzie widoczny tylko dla osób, które mają go zobaczyć. Ustawienie innej opcji wyświetli widget działający bądź nie wszystkim osobom odwiedzającym Twój sklep.
   W celu wyświetlenia widgetu w przeglądarce internetowej wpisz adres Twojego sklepu z dopiskiem ?showIzi=true
   Przykład: https://mojsklep.pl?showIzi=true

Image Added

2. Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
   a. Client
   b. Client Secret

Image Added

3. Pole POS ID wypełnij zgodnie z wartością otrzymaną od InPost

Image Added

4. Włącz możliwość płatności

Image Added

5. Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay.

Image Added

6. Sprawdź czy słownik statusów zamówień jest zgodny z tym, co rzeczywiście prezentujesz w komunikacji klientom. Sekcja ta wykorzystywana jest w sklepach, które mają nietypowy proces zakupowy. Sekcja ta będzie różna w różnych sklepach bo przedstawia statusy w Twoim sklepie.

Image Added

7. Wpisz ile produktów sugerowanych chcesz prezentować w aplikacji InPost. Szczegółowy opis działania tego mechanizmu opisany jest w rozdziale Produkty sugerowane.

Image Added

8. Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale Pełna Konfiguracja.

Image Added

9. Ustawienia doliczania VAT dotyczą sklepów, w których istnieje nietypowy system naliczania cen wysyłki. Wróć do tego ustawienia jeśli ceny w aplikacji nie będą pokrywać się z cenami w sklepie. Konfiguracja znajduje się w zakładce “Koszty transportu”.

Image Added

10. Połącz wysyłkę Kurierem z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Kurierem w aplikacji InPost.

Image Added

11. Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Kurier - Paczka w Weekend oraz płatności przy odbiorze oraz dni i godziny między którymi te opcje będą dostępne dla Twoich klientów. Pełny opis znajdziesz w rozdziale Pełna Konfiguracja.

Image Added

12. Połącz wysyłkę przez Paczkomat z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Paczkomat w aplikacji InPost.

Image Added

13. Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Paczkomat - Paczka w Weekend oraz płatności przy odbiorze oraz dni i godziny między którymi te opcje będą dostępne dla Twoich klientów. Pełny opis znajdziesz w rozdziale Pełna konfiguracja.

Image Added

14. Określ gdzie widget powinien być dostępny na Twojej stronie. Możesz wyświetlać go na karcie produktu oraz w koszyku. Dla każdego miejsca wyświetlania możesz określić, do której strony przycisk InPost Pay będzie wyrównany. Dla każdego miejsca możesz osobno wybrać, czy tło na stronie jest jasne czy ciemne co zapewnia poprawne wyświetlanie tekstów. Dla każdego miejsca możesz oddzielnie wybrać wariant wyświetlania. Przycisk może być czarny bądź żółty. Całość konfiguruje się w zakładce “Wygląd przycisków”.

Image Added

Konfiguracja Produkcyjna

Po poprawnej konfiguracji testowej i upewnieniu się, że integracja w środowisku Sandbox działa należy udostępnić InPost Pay wszystkim użytkownikom.

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

Zmień konfigurację zgodnie z poniższą listą:

1. Wybierz środowisko i opcje wyświetlania
   a. Środowisko ustaw na “Produkcyjne” - w ten sposób podczas składania zamówień będą wykonywane produkcyjne płatności
   b. Pokazuj widget ustaw na “Każdemu” - w ten sposób widget będzie widoczny dla wszystkich klientów sklepu.

Image Added

2. Pole POS ID ustaw zgodnie z umową z InPost

Image Added

Produkty sugerowane

Aplikacja InPost podczas dokonywania zakupów z InPost Pay sugeruje produkty do dodania do koszyka zgodnie z wbudowanym w WooCommerce systemem Produktów Powiązanych.

Jak wyświetlić produkty sugerowane w aplikacji?

W celu pokazania produktów sugerowanych należy uzupełnić sekcję Produktów Powiązanych w konfiguracji produktu WooCommerce.

W tym celu:

1. Przejdź do edycji produktu w Twoim sklepie.

2. W panelu Dane Produktu wybierz sekcję “Powiązane produkty”.

3. Wypełnij sekcje “pu-sell” bądź “cross-sell” - produkty z obu sekcji będą widoczne w aplikacji.

Image Added

Dlaczego na stronie widzę produkty sugerowane a w aplikacji nie?

Możliwe, że Twój sklep prezentuje produkty powiązane w niestandardowy sposób. Dzieje się tak na przykład przez to jak działa Twój szablon bądź jedna z zainstalowanych wtyczek. Jeśli Twój sklep prezentuje produkty sugerowane a nie widzisz ich w Aplikacji InPost upewnij się, że Produkty Powiązane są skonfigurowane zgodnie z instrukcją zawartą w akapicie powyżej.

Wtyczka logistyczna

InPost dostarcza dedykowaną wtyczkę do integracji z InPost dla Klientów WooCommerce. Wtyczka ta pozwala na w pełni zautomatyzowany przebieg procesu zakupowego łącznie z nadaniem numeru przesyłki i wysłaniem go do Twoich klientów przez aplikację InPost w procesie zakupowym InPost Pay.

Pobierz wtyczkę z: https://wordpress.org/plugins/inpost-for-woocommerce/

Dokumentacja: [PL] WooCommerce

Jak nadać paczkę jeśli mam wtyczkę logistyczną InPost?

Sposób wysyłki, adres oraz identyfikator paczkomatu automatycznie zostaną przekazane do wtyczki logistycznej. Ty nie musisz znać danych klienta. Musisz nadać paczkę zgodnie z instrukcją wtyczki.

Jak nadać paczkę jeśli nie mam wtyczki logistycznej InPost?

Na stronie zamówienia dokonanego przez InPost Pay dostępne są informacje mówiące o sposobie wysyłki oraz numerze paczkomatu w formie okienka. Skopiuj je i postępuj zgodnie z Twoim standardowym procesem nadawania paczek.

Image Added

Pełna konfiguracja

Konfiguracja została podzielona na sekcje umożliwiające dostosowanie działania wtyczki do potrzeb sklepu.

Po instalacji wtyczki w menu po lewej stronie sekcji administracyjnej zobaczysz nowe menu “InPost Pay”. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.

Ustawienia API

W tej sekcji ustawia się dane dostępowe do systemu, rodzaje obsługiwanych metod płatności oraz informacja wymieniane między InPost Pay a sklepem.

Opis dostępnych opcji:

Środowisko

Image Added

Pokazuj widget

Image Added

Ceny i dostępności wysyłki typ mapuj z

Image Removed

Client ID

Image Added

Opcje dla PWW oaz COD

Cena

Image Removed

Client Secret

Image Added

POS ID

Image Added

Dostępne od

Image Removed

Włącz płatności zgodne z podpisaną umową z Aion

Image Added

Dostępne do

Image Removed

Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost

Image Added

Ustawienia GUI

Tu ustawisz czy i gdzie wyświetlać widget InPost Pay. Sekcja została podzielona na podsekcje odpowiadające różnym podstronom Twojego sklepu.

Opis dostępnych opcji:

Wyświetlaj

Image Removed

Wybierz dostępne metody płatności w aplikacji

Image Added

Uwaga:

Opcja ta pojawi się dopiero po wprowadzeniu danych dostępowych do API i zapisaniu ustawień.

Status zamówienia dla zamówienia opłaconego przez InPost Pay

Image Added

Umiejscowienie

Image Removed

Do czego służy:

Jak ustawić:

Dla podstron koszyka oraz zamówienia Woocommerce umożliwia dodawanie widgetów w różnych częściach podstrony. Poprawne działanie każdej z dostępnych opcji uwarunkowana jest poprawną
implemenrtacją przez szablon używany przez Twój sklep

Wybierz część podstrony z listy rozwijalnej

Wyrównanie

Image Removed

Status zamówień

Image Added

Tło

Image Removed

Maksymalna liczba produktów sugerowanych

Image Added

Wariant

Image Removed

Szybkość odpowiedzi SSE

Image Added

Image Removed

Image Removed

Image Removed

Margines

Ustawienia przekazywanych opisów

Image Added

Widok w koszyku

Po konfiguracji wtyczki w koszyku przy produktach pojawi się przycisk Utwórz koszyk z InPost Pay:

Image Removed

Wyświetlanie w niestandardowym miejscu

W celu wyświetlenia widgetu w niestandardowym miejscu użyj poniższego kodu w swoim szablonie:

\izi\InPostIzi::render(
  $productId = null,
  $name = '',
  $maskedPhoneNumber = '',
  $inpost_basket_id = '',
  $echo = true,
  $addBasketId = false,
  $variationId = '',
  $count = 0,
  $dark = false,
  $yellow = false,
  $cart = false,
  $float = 'left',
  $bindingPlace = 'BASKET_POPUP'
);

Opis parametrów:

Parametr

Opis

Wartości

productId

Id produktu, który zostanie dodany do koszyka przed parowaniem

int

name

Imię klienta, które otrzymujesz z API

string

maskedPhoneNumber

Zamaskowany numer telefonu, który otrzymujesz z API

string

inpost_basket_id

ID koszyka, który otrzymujesz z API

string

echo

Czy wyświetlać?

bool

addBasketId

Czy wyświetlać id koszyka w HTML?

bool

variationId

ID wariantu

int

count

Liczba produktów w koszyku

int

dark

Czy wyświetlić w ciemnym trybie?

bool

yellow

Czy wyświetlić wariant żółty?
Amarantowy zostanie wyświetlony domyślnie

bool

cart

Czy znajdujemy się na stronie koszyka?

bool

float

CSS float

left | right | center

bindingPlace

Miejsce parowania

PRODUCT_CARD |
BASKET_POPUP |
BASKET_SUMMARY

Zgody

Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.

Dodawanie:
Po każdym zapisie formularze będziesz mógł dodać kolejną zgodę.

Usuwanie:
W celu usunięcia zgody pozostaw jej opis pusty i zapisz formularz.

Opis dostępnych opcji:

Adres zgody

Image Added

Opis wyświetlany w aplikacji

Image Added

Czy wymagane

Image Added

Cena transportu netto

Sekcja odpowiedzialna za mapowanie form transportu oraz określenie dostępności i cen opcji dodatkowych transportu

Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji
Poniżej generyczny opis gdzie jako typ wysyłki zostało użyte typ oraz opcja dla opcji wysyłki:

Dolicz VAT do ceny transportu

Image Added

Ceny i dostępności wysyłki typ mapuj z

Image Added

Opcje dla PWW oraz COD

Cena

Image Added

Dostępne od

Image Added

Dostępne do

Image Added

Wygląd przycisków

Tu ustawisz czy i gdzie wyświetlać widget InPost Pay. Sekcja została podzielona na podsekcje odpowiadające różnym podstronom Twojego sklepu.

Opis dostępnych opcji:

Tło

Image Added

Wariant

Image Added

Image Added

Image Added

Zaokrąglenie

Image Added

Wyświetlaj

Image Added

Umiejscowienie

Image Added

Położenie

Image Added

Margines

Image Added

Marketing

W tej sekcji ustawisz możliwość zapisywania atrybucji do zamówienia.

Opis dostępnych opcji:

Włączenie gromadzenia i zapisywania atrybucji

Image Added

Nadpisywanie atrybucji

Image Added

Wyświetlanie w niestandardowym miejscu

W celu wyświetlenia widgetu w niestandardowym miejscu użyj poniższego kodu w swoim szablonie:

1. Dla strony produktu

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayProductPlaceholder( $id = null, $styles = '' ); ?>

Opis parametrów:

2. Dla strony koszyka

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayCartPlaceholder( $styles = '' ); ?>

Opis parametrów:

3. Dla strony checkout

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayCheckoutPlaceholder( $styles = '' ); ?>

Opis parametrów:

4. Dla strony logowania

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayLoginPagePlaceholder( $styles = '' ); ?>

Opis parametrów:

5. Dla mini koszyka

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayMinicartPlaceholder( $styles = '' ); ?>

Opis parametrów:

6. Dla strony zamawiania

   Code Block
   <?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayOrderPlaceholder( $styles = '' ); ?>

Opis parametrów:

Programowalne akcje

• Akcja: inpostpay_invoice_details

Przypisanie danych bilingowych do własnego meta w procesie zamówienia. Dzięki tej funkcji możesz zapisać dane bilingowe do własnych danych meta lub danych meta wymaganych przez firmy trzecie. Dane jakie można pobrać za pomocą funkcji:
country_code, tax_id_prefix, tax_id, company_name,  name, surname, city, street, building, flat, postal_code, mail, registration_data_edited, additional_information
Przykładowe użycie:

add_action('inpostpay_invoice_details', 'inpostpay_invoice_details', 10, 2);

	function inpostpay_invoice_details($order, $invoice_details) {
    	if ( isset( $invoice_details->tax_id ) ) {
        	$order->update_meta_data( 'moje_pole_meta_vat', $invoice_details->tax_id_prefix ?? '' . $invoice_details->tax_id );
    	}
	}

• Akcja: inpost_pay_store_custom_cookies

Pozwala zapisać i odtworzyć dodatkowe ciasteczka podczas procesu zamówienia. Niektóre wtyczki afiliacyjne mogą wymagać dodatkowych ciasteczek w celu poprawnego rozliczania kampanii. Domyślnie InPost Pay gromadzi ciasteczka tylko i wyłączenie wymagane do poprawnego działania.
UWAGA: Ta opcja może nie zadziałać na każdym serwerze.

Przykładowe użycie:

add_action(‘inpost_pay_store_custom_cookies’, 'inpost_pay_my_cookies_to_store', 10, 2);

	function inpost_pay_my_cookies_to_store($cookies) {
    	$cookies = [‘nazwa_ciasteczka_1’,’nazwa_ciasteczka_2’]
    	}
	}

Dezinstalacja

Dezinstalacja wtyczki usuwa pliki wtyczki. Baza danych i dane nie zostają zmienione.