InPost Pay - Woocommerce
- Michał Machowski
- Joanna Wołosz
- Paweł Milewski
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 karcie produktu,
Dodanie przycisku “Kup z InPost Pay” na stronie koszyka,
Dodanie przycisku “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: 03.03.2025r - 1.5.6.2
Changelog:
Na tej stronie
- 1 Wymagania
- 2 Instalacja / Aktualizacja
- 3 Konfiguracja Testowa
- 4 Konfiguracja Produkcyjna
- 5 Produkty sugerowane
- 6 Wtyczka logistyczna
- 7 Pełna konfiguracja
- 7.1 Ustawienia API
- 7.2 Środowisko
- 7.3 Pokazuj widget
- 7.4 Client ID
- 7.5 Client Secret
- 7.6 POS ID
- 7.7 Włącz płatności zgodne z podpisaną umową z Aion
- 7.8 Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost
- 7.9 Wybierz dostępne metody płatności w aplikacji
- 7.10 Status zamówienia dla zamówienia opłaconego przez InPost Pay
- 7.11 Status zamówień
- 7.12 Maksymalna liczba produktów sugerowanych
- 7.13 Szybkość odpowiedzi SSE
- 7.14 Ustawienia przekazywanych opisów
- 8 Zgody
- 8.1 Adres zgody
- 8.2 Identyfikator linku
- 8.3 Tekst linku
- 8.4 Opisy widoczne w aplikacji
- 8.5 Czy wymagane
- 9 Koszt transportu
- 10 Wygląd przycisków
- 10.1 Tło
- 10.2 Wariant
- 10.3 Zaokrąglenie
- 10.4 Wyświetlaj
- 10.5 Umiejscowienie
- 10.6 Położenie
- 10.7 Margines
- 11 Marketing
- 12 Wyświetlanie w niestandardowym miejscu
- 13 Programowalne akcje
- 14 Dezinstalacja
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:
Pobierz spakowaną wtyczkę Woocommerce ze strony InPost i nie rozpakowuj jej
Zaloguj się do sekcji administracyjnej swojego sklepu
Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”
Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1
Kliknij “Zainstaluj”
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ą:
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
Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
a. Client
b. Client Secret
Pole POS ID wypełnij zgodnie z wartością otrzymaną od InPost
Włącz możliwość płatności
Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay.
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.
Wpisz ile produktów sugerowanych chcesz prezentować w aplikacji InPost. Szczegółowy opis działania tego mechanizmu opisany jest w rozdziale Produkty sugerowane.
Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale Pełna Konfiguracja.
Określ, które wysyłkowe metody bazowe, wspiera proces zakupowy Twojego sklepu.
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.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Kurier. Pełny opis znajdziesz w rozdziale Pełna Konfiguracja.
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.
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.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona czy dostępność metod wysyłki ma być dodatkowo sprawdzana dla produktów w koszyku na podstawie szczegółowych ustawień wtyczki logistycznej InPost. Pozostaw tę opcję wyłączoną, jeżeli nie korzystasz z oficjalnej wtyczki logistycznej InPost.
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”.
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ą:
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.
Pole POS ID ustaw zgodnie z umową z InPost
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.
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: InPost PL
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.
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.
Dane dostępowe do środowiska sandbox uzyskasz pisząc maila na skrzynkę integracjapay@inpost.pl lub wypełniając formularz kontaktowy w opcji Dla Biznesu i zakładce Sandbox.
Dane produkcyjne otrzymasz po podpisaniu umowy o usługę InPost Pay i wygenerujesz poprzez panel Merchanta zgodnie z instrukcją.
Opis dostępnych opcji:
Środowisko
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy sklep wysyła dane do | Kiedy testujesz integrację ustaw środowisko Sandbox. |
Pokazuj widget
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 | Kiedy konfigurujesz integrację wybierz |
|
|
Client ID
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
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
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
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
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. |
Wybierz dostępne metody płatności w aplikacji
Uwaga:
Opcja ta pojawi się dopiero po wprowadzeniu danych dostępowych do API i zapisaniu ustawień.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, jakie metody płatności będą widoczne dla klienta w aplikacji InPost. | Wybierz z listy dostępne metody płatności. |
Status zamówienia dla zamówienia opłaconego przez InPost Pay
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ń
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
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. |
Szybkość odpowiedzi SSE
Do czego służy: | Jak ustawić: |
|---|---|
Określa co ile sekund będą pobierane i zwracane dane dla koszyka InPost od strony sklepu. A więc jak szybko nastąpi aktualizacji np. ilości produktów na przycisku, czy stan sparowania koszyka. | Wpisz liczbę w zakresie od 0,1 do 3,0 W przypadku szybkich serwerów zaleca się ustawienie mniejszego czasu, w przypadku wolniejszych wyższego czasu. |
Ustawienia przekazywanych opisów
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy ma być pobierany pełny opis czy opis skrócony | Wybierz “Pełny opis” lub “Krótki Opis” |
Zgody
Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.
Dodawanie:
Zgody można dodać za pomocą przycisku “+Dodaj zgodę”. Maksymalnie możesz dodać 10 zgód.
Usuwanie:
W celu usunięcia zgody naciśnij przycisk “Usuń” umieszczony przy danej zgodzie.
Dodawanie dodatkowych linków do zgód:
W celu dodania dodatkowego linku do zgody należy nacisnąć przycisk “+Dodaj dodatkowy link”. Maksymalnie w jednej zgodzie mogą być dodane 3 linki. Minimum jeden link jest wymagany.
Opis dostępnych opcji:
Adres zgody
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. |
Identyfikator linku
Do czego służy: | Jak ustawić: |
Jest to unikalny identyfikator Twojego odnośnika, który możesz użyć w opisie zgody . | Wprowadź unikalny identyfikator. |
Tekst linku
Do czego służy: | Jak ustawić: |
Określa wyświetlany tekst dla linku. | Wprowadź tekst np. Regulamin, Polityka Prywatności. |
Opisy widoczne w aplikacji
Do czego służy: | Jak ustawić: |
|---|---|
Określa opis wyświetlany w aplikacji | Wpisz opis, jaki ma zostać wyświetlony. Możesz podać tutaj swoje identyfikatory linków poprzedzone znakiem #, dzięki czemu twoje linki zostaną osadzone w treści zgody. |
Czy wymagane
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy zgoda jest wymagana | Wpisz wymagalność zgody z listy. |
Wskazówka:
Jeśli chcesz utworzyć jeden checkbox w aplikacji służący do akceptacji więcej niż jednego dokumentu stwórz stronę, na której umieścisz odnośniki do wszystkich wymaganych zgód.
Koszt transportu
Sekcja odpowiedzialna za mapowanie form transportu oraz określenie dostępności i cen opcji dodatkowych transportu.
W celu zapewnienia transparentności i spójności doświadczenia klienta, koszty dostawy muszą być identyczne w interfejsie sklepu internetowego oraz w aplikacji. Należy skonfigurować oba systemy w taki sposób, aby prezentowały użytkownikom te same wartości opłat za dostawę dla odpowiednich metod.
Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Wybierz metody dostawy
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, które z metod dostawy są obsługiwane przez sklep. | Włącz lub wyłącz metody za pomocą przełączników |
Mapuj z metodą wysyłki
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla przedpłaconych metod wysyłki. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki. | Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej. |
Włącz lub wyłącz opcje dostawy
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, które z dodatkowych opcji dostawy są obsługiwane przez sklep. | Włącz obsługiwane opcje wysyłki za pomocą pola checkbox |
Sposób obliczania ceny dla dodatkowej opcji dostawy
Do czego służy: | Jak ustawić: |
|---|---|
Określa, jak będzie obliczana cena dodatkowych opcji dostawy. | Ustaw przycisk opcji obok pola „Mapuj z metodą wysyłki” jeżeli koszt wysyłki z opcją powinna obliczyć metoda wysyłki Woocommerce. Ustaw przycisk opcji obok pola „Dodatkowa prowizja” jeżeli chcesz wprowadzić wartość prowizji kwotowej dla opcji dostawy. |
Mapuj z metodą wysyłki (dla opcji dostawy)
Do czego służy: | Jak ustawić: |
|---|---|
Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla opcji dostawy. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki. | Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej. |
Pamiętaj!
Jeżeli kupujący wybierze w aplikacji więcej niż 1 opcję (np. Pobranie + Paczka w weekend) wtedy w zamówieniu Woocommerce będzie widoczna metoda bazowa.
Dodatkowa prowizja
Do czego służy: | Jak ustawić: |
|---|---|
Pole dodatkowej prowizji kwotowej dla opcji dostawy doliczanej do kosztu wysyłki metody bazowej. | Wprowadź kwotę netto. Podatek będzie doliczony w zależności od ustawień zmapowanej metody bazowej. |
Dostępne od
Do czego służy: | Jak ustawić: |
|---|---|
Określa od którego dnia tygodnia, i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna. | Wybierz dzień i godzinę, od których opcja będzie dostępna dla Twoich klientów. |
Dostępne do
Do czego służy: | Jak ustawić: |
|---|---|
Określa do którego dnia tygodnia i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna. | Wybierz dzień i godzinę, do których opcja będzie dostępna dla Twoich klientów. |
Ograniczenie dostawy Paczkomatem dla paczek powyżej 25kg
Integracja z wtyczką logistyczną InPost
Do czego służy: | Jak ustawić: |
|---|---|
Ogranicza możliwość wyboru opcji dostawy "Paczkomat", jeżeli paczka waży powyżej 25kg | W panelu wtyczki logistycznej InPost zakładka "Ustawienia". |
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.
Pamiętaj!
Ustawienia wyświetlania oraz układ przycisków należy skonfigurować zgodnie ze Standardami Implementacji InPost Pay.
Opis dostępnych opcji:
Tło
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy widget znajduje się na jasnym czy ciemnym tle. Ustawienie ma wpływ na kolor czcionki. | Wybierz z listy rozwijalnej. |
Wariant
Do czego służy: | Jak ustawić: |
|---|---|
Widget dostępny jest w 2 wariantach kolorystycznych. Wybierz ten bardziej odpowiadający Twojemu sklepowi. | Wybierz wariant z listy rozwijalnej. |
Zaokrąglenie
Do czego służy: | Jak ustawić: |
|---|---|
Parametr, który określa styl ramek widgetu. Domyślnie widget jest prostokątny. | Wybierz zaokrąglenie z listy rozwijalnej. |
Wyświetlaj
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy widget ma wyświetlać się na danej podstronie . | Zaznacz jeśli widget ma się wyświetlać. |
Umiejscowienie
Do czego służy: | Jak ustawić: |
|---|---|
Określa w jakiej części podstrony ma zostać wyświetlony widget. Poprawne działanie każdej z dostępnych opcji uwarunkowana jest poprawną implementacją przez szablon używany przez Twój sklep. | Wybierz część podstrony z listy rozwijalnej. |
Położenie
Do czego służy: | Jak ustawić: |
|---|---|
Określa orientację widgetu w dostępnej dla niego przestrzeni. Jeśli Twój szablon przeznacza wąską przestrzeń na widget ustawienie nie będzie miało wpływu na wygląd. | Wybierz orientację z listy rozwijalnej. |
Margines
Do czego służy: | Jak ustawić: |
|---|---|
Określa marginesy widgetu na stronie koszyka. | W razie niepoprawnego wyświetlania widgetu na stronie koszyka dostosuj wyświetlanie dodając margines. |
Marketing
W tej sekcji ustawisz możliwość zapisywania atrybucji do zamówienia.
Opis dostępnych opcji:
Włączenie gromadzenia i zapisywania atrybucji
Do czego służy: | Jak ustawić: |
|---|---|
Włącza lub wyłącza gromadzenie atrybucji w zamówieniu | Włącz lub wyłącz. |
Nadpisywanie atrybucji
Do czego służy: | Jak ustawić: |
|---|---|
Nadpisuje oryginalną atrybucję na atrybucję InPost Pay | Włącz lub wyłącz |
Wyświetlanie w niestandardowym miejscu
W celu wyświetlenia widgetu w niestandardowym miejscu użyj poniższego kodu w swoim szablonie:
Dla strony produktu
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayProductPlaceholder( $id = null, $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
id | Id produktu, który zostanie dodany do koszyka przed parowaniem | int, null - id powinno pobrać się automatycznie |
style | Obecnie nie zaimplementowane | string |
Dla strony koszyka
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayCartPlaceholder( $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
style | Obecnie nie zaimplementowane | string |
Dla strony checkout
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayCheckoutPlaceholder( $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
style | Obecnie nie zaimplementowane | string |
Dla strony logowania
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayLoginPagePlaceholder( $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
style | Obecnie nie zaimplementowane | string |
Dla mini koszyka
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayMinicartPlaceholder( $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
style | Obecnie nie zaimplementowane | string |
Dla strony zamawiania
<?php \Ilabs\Inpost_Pay\Lib\view\DisplayPlaceHolder::displayOrderPlaceholder( $styles = '' ); ?>
Opis parametrów:
Parametr | Opis | Wartości |
style | Obecnie nie zaimplementowane | string |
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->add_cookies( ['nazwa_ciasteczka_1','nazwa_ciasteczka_2'] );
}Akcja:
inpostpay_delivery_point_details
Pozwala nadpisać pole z numerem paczkomatu według własnego uznania, np. wpisać je dodatkowo pod inną nazwą.
UWAGA: Ta opcja może nie zadziałać na każdym serwerze.
Przykładowe użycie:
add_action('inpostpay_delivery_point_details', 'save_custom_inpay_delivery_point', 10, 2);
function save_custom_inpay_delivery_point($order, $delivery_point) {
if ( ! empty( $delivery_point ) ) {
$order->update_meta_data( 'deliveryPointId', $delivery_point );
}
}
Dezinstalacja
Dezinstalacja wtyczki usuwa pliki wtyczki. Baza danych i dane nie zostają zmienione.