Wtyczka WooCommerce Conditional Shipping and Payments WooCommerce Extension - 3.1.2

WooCommerce Conditional Shipping and Payments to oficjalne rozszerzenie Woo, które warunkowo ukrywa istniejące metody wysyłki, bramki płatności i kraje dostawy według reguł z kilkudziesięciu warunków. Porządkuje checkout bez snippetów w functions.php. Nie tworzy nowych stawek – odsłania i ukrywa to, co sklep już ma.

Restrykcje bramek płatności, metod wysyłki i krajów dostawy

WooCommerce Conditional Shipping and Payments działa na trzech typach restrykcji: bramek płatności, metod wysyłki oraz krajów i regionów dostawy. Każda z nich warunkowo ukrywa lub blokuje opcje już obecne w sklepie – w tym stawki live z API kurierów przez Exclude Rate IDs – a nowej metody nie dodaje. Reguły konfiguruje się globalnie w ustawieniach WooCommerce albo na karcie pojedynczego produktu.

Mechanizm jest w każdym z trzech przypadków taki sam. Reguła wskazuje opcje do wykluczenia oraz zestaw warunków, po których spełnieniu wykluczenie się włącza. Logika dostawy i płatności trzyma się dzięki temu w jednym miejscu, zamiast rozpraszać się po fragmentach kodu motywu.

Restrykcje bramek płatności (ukrywanie lub komunikat blokujący)

Restrykcja bramki płatności ukrywa wybrane bramki albo pokazuje je z komunikatem blokującym, gdy nie pasują do kontekstu zamówienia. Decydują o tym trzy opcje: Exclude Gateways wskazuje bramki do wykluczenia, Show Excluded ustala, czy ukryta bramka ma zostać widoczna z notką, a Custom Notice nadaje własną treść komunikatu. Ten typ restrykcji działa od pierwszej wersji rozszerzenia i najczęściej rozdziela przedpłatę od płatności za pobraniem.

Restrykcje metod wysyłki i stawek live kurierów

Restrykcja metody wysyłki ukrywa istniejące metody i stawki dostawy, łącznie z tymi pobieranymi na żywo z API kurierów. Stawkę dynamiczną wyklucza się przez Exclude Rate IDs, podając jej identyfikator – na przykład fedex:priority_air. Takie identyfikatory nie zawsze widnieją wprost na liście, więc w części przypadków odszukuje się je ręcznie w kodzie strony koszyka.

Restrykcje krajów i regionów dostawy

Restrykcja miejsc dostawy blokuje wysyłkę do wskazanych krajów, stanów i regionów. Odpowiadają za to opcje Exclude Countries oraz Exclude States/Regions, a do nich dochodzi własny komunikat dla klienta. To narzędzie pod zgodność z warunkami przewoźnika i przepisami celnymi – wtedy, gdy sklep nie wysyła danej kategorii towaru za granicę albo do konkretnego regionu.

Reguły globalne kontra reguły na poziomie produktu

Reguły globalne są zawsze ewaluowane na checkoutcie, a zarządza się nimi w sekcji WooCommerce > Settings > Restrictions, z osobnymi kartami dla bramek, metod wysyłki i miejsc dostawy. Reguła na poziomie produktu siedzi w zakładce Product Data > Restrictions tego produktu i włącza się dopiero wtedy, gdy trafi on do koszyka. Reguły produktowe dostają jeszcze jeden warunek – Item Quantity, czyli liczbę sztuk danej pozycji.

Komunikaty walidacyjne i statyczne przy zablokowanej opcji

Rozszerzenie obsługuje dwa typy komunikatów. Walidacyjne pojawiają się w chwili, gdy klient próbuje skorzystać z zablokowanej opcji. Statyczne wiszą przy niej na stałe.

Treść notek personalizuje się dowolnie, a w środku działają znaczniki {excluded_gateway} oraz {excluded_method} – podstawiają nazwę wykluczonej bramki lub metody. Komunikaty statyczne wiążą się przy tym wyłącznie z klasycznym checkoutem opartym na shortcode.

Biblioteka warunków i logika reguł CSP

Biblioteka warunków WooCommerce Conditional Shipping and Payments obejmuje kilkadziesiąt kryteriów: zawartość koszyka, wartość i wagę paczki, kraj oraz kod pocztowy, rolę i e-mail klienta, kupon, datę czy wybraną metodę wysyłki. Reguła aktywuje się dopiero wtedy, gdy spełnione są wszystkie jej warunki naraz – to logika AND. Efekt OR powstaje inaczej: przez dodanie kolejnych reguł, które wykluczają tę samą opcję.

Warunki koszyka: kategoria, marka, klasa wysyłkowa, liczba sztuk

Pierwsza grupa warunków patrzy na zawartość koszyka i paczki. Na jej podstawie powstają reguły zależne od tego, co klient faktycznie kupuje.

• Category, Tag, Brand, Product Attribute – reguły zależne od kategorii, tagu, marki produktu lub wybranego atrybutu, na przykład osobne traktowanie jednej marki w koszyku.
• Shipping Class – warunek na klasie wysyłkowej, przydatny dla towarów wymagających osobnej obsługi dostawy.
• Backorder i Product On Sale – rozpoznanie produktów na zamówieniu wstecznym oraz pozycji objętych promocją.
• Item, Package i Cart Item Count – warunki na liczbie sztuk w pozycji, w paczce lub w całym koszyku.

Warunki wartości, wagi i lokalizacji (suma, waga paczki, kraj, kod pocztowy)

Druga grupa obejmuje wartości pieniężne, wagę i miejsce dostawy. Warunki kwotowe rozróżniają Order Total, Cart Total (po rabatach, z podatkiem), Cart Subtotal (przed rabatami) oraz Package Total. Package Weight reaguje natomiast na wagę pojedynczej paczki.

Warunki lokalizacji to Billing i Shipping Country/State – z obsługą zarówno pojedynczych krajów, jak i całych kontynentów – oraz Billing i Shipping Postcode, w których kod pocztowy podaje się jako pojedynczą wartość albo zakres.

Warunki klienta, kuponów, czasu i wybranej metody wysyłki

Trzecia grupa łączy profil klienta z kontekstem zamówienia. Warunek Customer dopasowuje adres e-mail (z obsługą znaków wieloznacznych i całych domen) i rozpoznaje, czy klient składał już wcześniej zamówienia, podczas gdy Customer Role sięga po rolę użytkownika. Coupon Code reaguje na użyty lub nieużyty kupon – również taki, który włącza darmową wysyłkę.

Warunek Shipping Method patrzy na wybraną metodę dostawy i właśnie on pozwala wykluczać bramki płatności zależnie od wysyłki. Date/Time obejmuje rok, miesiąc, dzień miesiąca, dzień tygodnia oraz godzinę – przydatne choćby przy ustalaniu progu czasowego dla dostawy tego samego dnia. Grupę domyka Order Status, czyli warunek na statusie zamówienia.

Logika AND wewnątrz reguły, OR między regułami

Wewnątrz jednej reguły wszystkie warunki łączy logika AND – restrykcja zadziała dopiero wtedy, gdy każdy z nich jest spełniony naraz. Alternatywę OR osiąga się inaczej: powstaje kilka osobnych reguł wykluczających tę samą opcję, a każda działa niezależnie od pozostałych. Taki model pokrywa większość scenariuszy bez zagnieżdżania warunków.

Tryb diagnostyczny i własne warunki dla deweloperów

Tryb diagnostyczny (Debug mode) pokazuje na checkoutcie, która reguła wyklucza daną bramkę, metodę lub kierunek dostawy – razem z odnośnikiem do tej reguły. Osobne przełączniki tymczasowo wyłączają wszystkie restrykcje globalne albo produktowe, co skraca diagnozę konfliktów. Deweloperzy dokładają własne klasy warunków przez filtr woocommerce_csp_conditions, a producent deklaruje ponad 2000 testów automatycznych pokrywających działanie rozszerzenia.

Dla jakich sklepów CSP się sprawdza

WooCommerce Conditional Shipping and Payments sprawdza się w sklepach łączących pobranie z szybkimi płatnościami online, w sklepach B2B z rolami klientów oraz w sprzedaży towarów wrażliwych i wielkogabarytowych, gdzie część metod lub kierunków dostawy wymaga zablokowania. Porządkuje też checkout tam, gdzie produkty fizyczne sąsiadują z cyfrowymi, i zastępuje rozproszone snippety z functions.php jednym, audytowalnym narzędziem.

Dla kogo CSP się sprawdza:

• Sklepy łączące dostawę za pobraniem z szybkimi płatnościami online.
• Sklepy B2B i hurtowe z rolami klientów oraz członkostwami.
• Sprzedawcy towarów wrażliwych, regulowanych i wielkogabarytowych.
• Sklepy mieszające produkty fizyczne i cyfrowe na jednym checkoutcie.
• Sklepy zastępujące rozproszone snippety jednym, audytowalnym narzędziem.

Pobranie kontra szybkie płatności online

Najczęstszy przypadek to sklep z przedpłatą online obok dostawy za pobraniem. Domyślnie WooCommerce potrafi pokazać szybką płatność również przy wyborze pobrania, co dezorientuje klientów. Reguła restrykcji bramki płatności z warunkiem Shipping Method ustawionym na pobranie ukrywa wtedy płatności online – albo odwrotnie, blokuje pobranie dla zamówień opłaconych z góry.

Sklepy B2B i hurtowe z rolami klientów

W sprzedaży hurtowej różne grupy klientów dostają różne opcje. Warunki Customer Role, Customer (e-mail lub domena) oraz integracja z WooCommerce Memberships udostępniają przelew, fakturę czy dostawę paletową wyłącznie klientom hurtowym, a detalicznym zostawiają standardowe metody. Reguły opierają się na istniejących rolach i planach członkowskich, więc obywają się bez osobnego systemu cenników.

Towary wrażliwe, wielkogabarytowe i regulowane

Sklepy z bateriami, świeżą żywnością czy towarem wielkogabarytowym blokują wybrane metody lub kraje dostawy zależnie od kategorii, klasy wysyłkowej albo wagi paczki. Regułą Order Total > 200 ukrywa się na przykład płatność za pobraniem przy droższych zamówieniach, co ogranicza ryzyko nieodebranych przesyłek. Warunki wagowe z kolei automatycznie pokazują stawkę Standard albo Heavy, zależnie od wagi danej paczki.

Dla kogo CSP nie jest najlepszym wyborem

Rozszerzenie nie pasuje do każdego sklepu – w kilku sytuacjach lepiej sięgnąć po inne narzędzie albo w ogóle z niego zrezygnować.

• Sklepy, które chcą tworzyć nowe stawki lub metody wysyłki – do tego służy Table Rate Shipping.
• Sklepy oczekujące ukrycia metody wysyłki zależnie od wybranej bramki płatności – a to technicznie niemożliwe.
• Bardzo proste sklepy z jedną metodą wysyłki i jedną płatnością, bez konfliktów do rozwiązania.
• Sklepy szukające rozwiązania bez kosztu i bez własnej konfiguracji reguł.

Integracje z rozszerzeniami WooCommerce

WooCommerce Conditional Shipping and Payments integruje się z WooCommerce Subscriptions, Memberships, Gift Cards, WooPayments oraz wtyczkami wielowalutowymi (TIV i WooCommerce Multi-Currency). Każda z tych integracji odblokowuje nowe warunki – plan członkowski, walutę, subskrypcję czy kartę podarunkową – na których opierają się reguły zależne od danego rozszerzenia. Table Rate Shipping zostaje produktem komplementarnym, którego stawki CSP potrafi warunkowo ukrywać.

Subscriptions, Memberships i Gift Cards (dodatkowe warunki)

WooCommerce Subscriptions dokłada warunki Product on Subscription oraz Recurring Package – rozróżniają one subskrypcję o danym okresie rozliczeniowym i oddzielają pierwszy zakup od odnowień. Dzięki temu konkretną bramkę przypisuje się do subskrypcji, a darmową wysyłkę do płatności odnawialnej. WooCommerce Memberships udostępnia warunek Membership Plan dla reguł zależnych od aktywnego członkostwa. WooCommerce Gift Cards dodaje natomiast Gift Card Product oraz Gift Cards, reagujące na kartę podarunkową w koszyku lub zastosowaną do zamówienia.

WooPayments, waluty i metody express (Google Pay, Apple Pay)

WooPayments udostępnia warunek Currency oparty na aktywnej walucie, a sama integracja usuwa przyciski express checkout, gdy powiązana bramka zostaje zablokowana regułą. Nowsze wersje obejmują metody express Stripe – Google Pay, Apple Pay i Link – w kontekście restrykcji bramek. Warunek Currency dostarczają alternatywnie również WooCommerce Multi-Currency oraz TIV Multi-Currency, więc reguły walutowe działają niezależnie od dostawcy wielowalutowości.

Table Rate Shipping jako uzupełnienie CSP

Table Rate Shipping i CSP to para, nie konkurenci. Pierwsze tworzy nowe stawki wysyłki według lokalizacji, ceny, wagi, klasy lub ilości, a Conditional Shipping and Payments te stawki warunkowo ukrywa i odsłania. Producent wprost sugeruje łączenie obu rozszerzeń, gdy sklep potrzebuje i rozbudowanych cenników, i logiki ich pokazywania.

Czego CSP nie robi i czym różni się od Table Rate Shipping

WooCommerce Conditional Shipping and Payments nie tworzy nowych metod ani stawek wysyłki – wyłącznie ukrywa i odsłania te już istniejące, a do budowania stawek służy osobne Table Rate Shipping. Rozszerzenie nie ukryje też metody wysyłki zależnie od wybranej bramki płatności – działa jedynie kierunek odwrotny, czyli płatność zależna od wysyłki. Statyczne komunikaty obsługuje przy tym tylko klasyczny checkout oparty na shortcode.

CSP nie tworzy stawek — różnica wobec Table Rate Shipping

To najczęstsze nieporozumienie wśród kupujących, którzy mylą CSP z generatorem stawek. Conditional Shipping and Payments operuje na metodach i stawkach już skonfigurowanych w strefach wysyłki WooCommerce – potrafi je ukryć lub pokazać, lecz samodzielnie żadnej nie wygeneruje. Sklep, który potrzebuje tabeli cen według wagi i strefy, dokłada do CSP rozszerzenie Table Rate Shipping albo korzysta ze stawek Flat Rate w strefach.

Dlaczego nie ukryje wysyłki w zależności od wybranej płatności

Uwaga o ograniczeniu: CSP nie ukryje metody wysyłki na podstawie wybranej bramki płatności – działa tylko kierunek odwrotny, czyli filtrowanie płatności zależnie od wybranej dostawy. Ograniczenie wynika z rdzenia WooCommerce, który odświeża tabelę metod wysyłki po zmianie dostawy, ale już nie po zmianie płatności. To zachowanie samej platformy, którego rozszerzenie nie obejdzie bez dodatkowej customizacji.

Static notices tylko w klasycznym checkoutcie

Statyczne komunikaty przy zablokowanych opcjach działają w klasycznym checkoutcie opartym na shortcode. Nowy blok Checkout już ich nie obsługuje. Zostają w nim za to komunikaty walidacyjne, więc klient i tak dostanie informację, gdy spróbuje użyć wykluczonej opcji – a przy migracji sklepu na checkout blokowy to ograniczenie pozostaje istotne.

Osobne ograniczenie dotyczy restrykcji globalnych – nie da się ich eksportować ani importować. Reguły produktowe przenoszą się natomiast jako metadane przez standardowy eksporter produktów WooCommerce.

Pobranie i szybkie płatności w polskich sklepach

WooCommerce Conditional Shipping and Payments rozwiązuje klasyczny problem polskich sklepów: ukrycie szybkich płatności online przy dostawie za pobraniem i odwrotnie. Operuje na metodach oraz bramkach już zainstalowanych w sklepie, więc współgra z Przelewy24, PayU, BLIK czy InPost przez ich standardowe identyfikatory – a dokumentacja Woo wprost podaje przykład pokazywania PayU tylko klientom z Polski.

Ukrycie przedpłaty przy dostawie za pobraniem

Domyślny WooCommerce nie ma wbudowanego powiązania płatności z metodą wysyłki, więc szybka płatność potrafi pojawić się także przy pobraniu – polskie poradniki opisują to jako lukę wymagającą dodatkowej wtyczki. Reguła restrykcji bramki płatności z warunkiem Shipping Method ustawionym na pobranie ukrywa wtedy płatności online. Analogiczna reguła w drugą stronę chowa pobranie, gdy klient wybiera dostawę kurierską opłacaną z góry.

Bramki i kurierzy PL przez standardowe identyfikatory metod

CSP nie ma osobnej integracji szytej pod polskie bramki ani kurierów – filtruje je przez standardowe identyfikatory, które WooCommerce nadaje każdej zainstalowanej bramce i metodzie dostawy. W praktyce Przelewy24, PayU, Tpay i BLIK w ramach tych bramek, a także InPost Paczkomaty, DPD czy pobranie poddają się tym samym regułom, co dowolna inna metoda. Oficjalny przykład producenta – wyłączenie PayU, gdy kraj rozliczeniowy nie jest Polską – pokazuje ten mechanizm na polskim gruncie.

Wymagania i kompatybilność z blokami Cart & Checkout oraz HPOS

WooCommerce Conditional Shipping and Payments wymaga WordPressa 6.2 lub nowszego, WooCommerce 8.2 lub nowszego oraz PHP 7.4 lub nowszego. Rozszerzenie jest zgodne z nowymi blokami Cart & Checkout i z HPOS (High-Performance Order Storage). Statyczne komunikaty działają jednak tylko w klasycznym checkoutcie opartym na shortcode, a reguły ewaluowane są na bazie skonfigurowanych stref wysyłki WooCommerce.

Minimalne wersje WordPress, WooCommerce i PHP

Wymagania minimalne to wartości pewne, wprost z karty produktu. Wartości „testowano do” odzwierciedlają środowisko testowe producenta i wyznaczają górny pułap zgodności, a nie wymóg.

Bloki Cart & Checkout, HPOS i strefy wysyłki

Rozszerzenie deklaruje zgodność z nowymi blokami Cart & Checkout oraz z HPOS, więc działa i w klasycznym, i w blokowym checkoutcie – z jednym wyjątkiem: statyczne komunikaty pozostają przy wariancie shortcode. Reguły CSP nakładają się na strefy wysyłki WooCommerce, a każdy klient pasuje tylko do jednej strefy.

Dlatego błędna konfiguracja stref bywa najczęstszą przyczyną pozornych problemów z regułami. Zanim reguła zostanie uznana za niedziałającą, sprawdza się, czy adres klienta w ogóle trafia do właściwej strefy z oczekiwaną metodą.

Najczęściej zadawane pytania