Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

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 z InPost Pay” na stronie koszyka,

  • Dodanie przycisku “Utwórz koszyk 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.07.2023r)

Changelog:

1.0.0:

Na tej stronie

Wymagania

Do poprawnego działania wtyczka wymaga:

  • PHP w wersji nie niższej niż 7.4

  • Woocommerce w wersji nie niższej niż 7.3.0

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ą”

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

  5. Kliknij “Zainstaluj”

  6. W następnym oknie kliknij “Aktywuj wtyczkę”

Konfiguracja

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. Wypełnij pola zgodnie z poniższą tabelą:

Środowisko

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

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

W celu pokazania widgetu wszystkim
odwiedzającym ustaw Wszystkim.
W celu pokazania widgetu testerom wybierz
Testerom

Client ID

Do czego służy:

Jak ustawić:

Dana dostępowa do API

Zgodnie z danymi otrzymanymi od InPost

Client Secret

Do czego służy:

Jak ustawić:

Dana dostępowa do API

Zgodnie z danymi otrzymanymi od InPost

Metody Płatności

Do czego służy:

Jak ustawić:

Określa jakie metody płatności będą dostępne dla klientów Twojego sklepu w aplikacji InPost

Zaznacz metody dostępne dla Twoich klientów

Status zamówienia dla zamówienia autoryzowanego

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

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

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

Do czego służy:

Jak ustawić:

Określa stronę, na którą zostanie przekierowany Twój klient w celu przeczytania zgody

Wybierz jedną ze stron Twojego sklepu z listy rozwijalnej

Opis wyświetlany w aplikacji

Do czego służy:

Jak ustawić:

Określa opis wyświetlany w aplikacji

Wpisz opis, jaki ma zostać wyświetlony

Czy wymagane

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:

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

Do czego służy:

Jak ustawić:

Określa, która z dostępnych w sklepie metod wysyłki określa ceny i zasady dla wysyłki typ

Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej

Cena

Do czego służy:

Jak ustawić:

Cena netto opcji wysyłki

Wpisz kwotę określającą cenę

Dostępne od

Do czego służy:

Jak ustawić:

Określa. od którego dnia tygodnia, i której godziny opcja 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 jest dostępna

Wybierz dzień i godzinę, do których opcja będzie dostępna dla Twoich klientów

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

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

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

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

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 orientację 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 orientację z listy rozwijalnej

Widok w koszyku

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

Dezinstalacja

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

  • No labels