Instrukcja aplikacji

Od reguły do bezpiecznej publikacji

GrowCheckout dla Shoper Storefront · aktualizacja: 11 sierpnia 2026

Najważniejsza zasada: pracujesz na szkicu. Zapis nie zmienia checkoutu. Dopiero przycisk Opublikuj podmienia wersję działającą w sklepie.

1. Pierwsze uruchomienie

Zsynchronizuj katalog

Kliknij Synchronizuj katalog. Aplikacja pobierze produkty, kategorie, producentów, gabaryty, dostawy i płatności z aktywnej instalacji Shopera.

Sprawdź metody

Otwórz selektor dostaw lub płatności. Nieaktywne pozycje pozostają opisane jako nieaktywne, aby istniejąca reguła nie stała się niezrozumiała po zmianie konfiguracji sklepu.

Dodaj pierwszą, wyłączoną regułę

Ułóż warunki i skutek, a następnie sprawdź wynik w symulatorze. Włącz regułę dopiero po weryfikacji co najmniej jednego koszyka pasującego i jednego niepasującego.

2. Jak czytać builder

Każda zasada ma trzy logiczne części: JEŻELI opisuje koszyk, WTEDY steruje dostępnymi metodami, a KLIENT ZOBACZY pozwala dodać krótkie wyjaśnienie.

Element	Znaczenie	Przykład
WSZYSTKIE (AND)	Każdy warunek w grupie musi być spełniony.	Gabaryt Paleta i wartość ponad 500 zł.
DOWOLNY (OR)	Wystarczy jeden warunek w grupie.	Marka A lub kategoria Chemia.
Grupa zagnieżdżona	Pozwala łączyć AND z OR bez powielania reguł.	Kraj PL i (marka A lub marka B).
Ukryj	Odejmuje wskazane metody od natywnej listy.	Ukryj pobranie.
Zostaw tylko	Przecina listę z metodami dozwolonymi.	Zostaw tylko kuriera paletowego.

Reguła może mieć do 20 warunków, zagnieżdżenie do 3 poziomów i do 4 działań. Cała konfiguracja może zawierać do 100 reguł. Gdy pasuje kilka zasad, ich skutki łączą się restrykcyjnie: ukrycia są sumowane, a listy „zostaw tylko” przecinane.

3. Dostępne warunki

wartość koszyka po rabatach oraz wartość regularna — liczona w groszach, bez błędów porównania liczb dziesiętnych;
liczba sztuk i łączna waga;
produkty, kategorie, producenci i gabaryty — wybierane z aktualnego katalogu sklepu;
kraj dostawy;
wybrana dostawa — wyłącznie jako warunek sterujący płatnością, aby nie tworzyć pętli dostawa–płatność.

Wskazanie kategorii nadrzędnej obejmuje produkty z jej podkategorii. Gdy aplikacja nie ma pełnych danych katalogowych potrzebnych do warunku, taki warunek nie ukrywa metody — zachowanie jest bezpiecznie otwarte.

4. Symulator

Symulator korzysta z tego samego dokumentu reguł i tego samego silnika serwerowego co checkout. Ustaw kwotę, ilość, wagę, zawartość koszyka, kraj i aktualnie wybrane metody. Wynik pokaże:

które dostawy i płatności pozostaną dostępne;
czy aktualny wybór wymaga zmiany na pierwszą dozwoloną alternatywę;
które aktywne reguły pasują;
czy konfiguracja wywołała konflikt.

Konflikt nie blokuje sprzedaży. Jeśli kombinacja zasad usunęłaby wszystkie dostawy albo płatności, GrowCheckout pozostawia natywną listę Shopera. Popraw regułę przed publikacją.

5. Zapis i publikacja

Kliknij Zapisz szkic. Otwórz regułę ponownie i upewnij się, że wybrane ID nadal mają właściwe nazwy.
Przetestuj koszyk poniżej, dokładnie na i powyżej każdej granicy kwotowej.
Sprawdź produkt prosty i wielowariantowy, kategorie potomne oraz metodę, która ma zostać automatycznie zastąpiona.
Kliknij Opublikuj. Panel pokaże numer opublikowanej rewizji.
W sklepie wykonaj test desktop i mobile na kroku wyboru dostawy i płatności.

Stara karta panelu nie może nadpisać nowszego szkicu. Jeśli ktoś opublikował zmianę równolegle, panel poprosi o odświeżenie zamiast zgadywać, która wersja ma wygrać.

6. Zachowanie w checkout

Adapter działa wyłącznie na kroku wyboru dostawy i płatności. Po zmianie koszyka, kraju lub metody wysyła do oceny ograniczony zestaw faktów bez e-maila, adresu i nazw produktów. Niedozwolona metoda znika również z układu strony, a jej natywna kontrolka jest wyłączana. Jeśli klient miał ją wybraną, GrowCheckout przekazuje do oficjalnego API Shopera pełny obiekt pierwszej dozwolonej alternatywy.

Timeout, błąd sieci, niepełny katalog lub uszkodzona konfiguracja przywracają natywne opcje. Aplikacja nie przechwytuje przycisku złożenia zamówienia i nie dokłada blokującego overlayu.

7. Ważna granica techniczna

GrowCheckout jest guardem UX opartym o oficjalne API Storefront. Nie zmienia kosztu dostawy ani płatności i nie jest serwerową regułą autoryzacyjną. Shoper nie udostępnia aplikacji zewnętrznej hooka blokującego zamówienie przed jego utworzeniem, dlatego celowe obejście kodu w przeglądarce nie może być opisane jako niemożliwe.

8. Wyłączenie i odinstalowanie

W sytuacji awaryjnej wyłącz moduł GrowCheckout w edytorze wyglądu Shopera. Checkout natychmiast wróci do natywnego zachowania. Odinstalowanie aplikacji unieważnia dostęp OAuth i publiczne mapowanie hosta; sam loader pozostawiony w szablonie nie dostanie aktywnej konfiguracji i działa fail-open.

9. Wsparcie

Skorzystaj z formularza GrowCheckout. Formularz automatycznie przypisze temat do tej aplikacji w CRM. W wiadomości podaj oczekiwane „jeżeli → wtedy”, nazwę szablonu oraz — jeśli to bezpieczne — identyfikatory testowych metod.