Jak sprawdzić zgodność rozszerzenia z blokami koszyka i zamówienia?

Aby sprawdzić zgodność rozszerzenia z blokami koszyka i zamówienia, najpierw rozpoznaj typ używanego checkoutu, następnie sprawdź dokumentację producenta, a na końcu przetestuj sklep na stagingu lub w trybie testowym płatności. Sam brak ostrzeżenia w WooCommerce nie wystarcza - zgodność trzeba potwierdzić z używanym motywem, bramką płatniczą, dostawą i pozostałymi rozszerzeniami.

Najpierw rozpoznaj, jaki koszyk i checkout działa w sklepie

W panelu WordPressa przejdź do WooCommerce > Ustawienia > Zaawansowane > Ustawienia strony. Sprawdź, które strony przypisano jako Koszyk i Zamówienie, a następnie otwórz je w edytorze WordPressa.

• Blokowy koszyk rozpoznasz po bloku Cart.
• Blokowe zamówienie rozpoznasz po bloku Checkout oraz jego częściach, między innymi Checkout Fields i Checkout Totals.
• Klasyczny wariant używa bloku Shortcode z treścią [woocommerce_cart] albo [woocommerce_checkout].

Cart i Checkout blocks są domyślnym rozwiązaniem dla nowych instalacji WooCommerce od wersji 8.3, ale klasyczne shortcode’y nadal są dostępne. Ma to znaczenie, ponieważ część rozszerzeń korzysta z mechanizmów działających w klasycznym checkoutcie, lecz nieobsługiwanych w jego blokowej wersji.

Co widzisz na stronie	Jaki wariant działa	Co to zmienia przy ocenie rozszerzenia
Blok Cart lub Checkout	Blokowy koszyk albo checkout	Rozszerzenie musi mieć integrację z Cart and Checkout blocks, a nie tylko obsługę klasycznych hooków.
Blok Shortcode z [woocommerce_cart] lub [woocommerce_checkout]	Klasyczny koszyk albo checkout	Rozszerzenie może działać według starszego mechanizmu, ale nie oznacza to zgodności z blokami.
Brak oczekiwanego bloku lub shortcode’u	Nieprawidłowo przypisana albo zmieniona strona	Najpierw popraw przypisanie stron, a dopiero potem oceniaj działanie rozszerzenia.

Sprawdź dokumentację producenta, nie tylko oznaczenie zgodności

Przed instalacją przejrzyj opis rozszerzenia, dokumentację i changelog. Szukaj jednoznacznej informacji o obsłudze Cart and Checkout blocks oraz wskazania, których funkcji dotyczy zgodność. Ogólne hasło o kompatybilności z WooCommerce nie potwierdza działania dodatku w blokowym koszyku i checkoutcie.

Sprawdź także minimalne wymagania dotyczące WordPressa, WooCommerce i PHP, zakres wersji przetestowanych przez producenta oraz ograniczenia związane z bramką płatniczą, metodami dostawy, motywem i innymi rozszerzeniami. Jeśli dokumentacja nie rozstrzyga sprawy, poproś producenta o potwierdzenie obsługi używanej funkcji, a nie o ogólną deklarację zgodności.

WooCommerce może pokazać ostrzeżenie dla rozszerzenia, które zadeklarowało niezgodność z funkcją cart_checkout_blocks. Sprawdza tę deklarację dla wtyczek zawierających w głównym pliku nagłówek WC tested up to. Sam nagłówek nie potwierdza zgodności z blokami - producent deklaruje ją osobno, na przykład za pomocą FeaturesUtil::declare_compatibility. Brak ostrzeżenia nie potwierdza pełnej zgodności, dlatego nadal potrzebujesz testu sklepu.

Jeśli dopiero przygotowujesz środowisko do uruchomienia sklepu, możesz przejść do uruchomienia sklepu WooCommerce po ustaleniu, czy wybrane rozszerzenia obsługują używany wariant checkoutu.

Wykonaj test koszyka i zamówienia w bezpiecznym środowisku

Skopiuj sklep na staging albo użyj trybu testowego bramki płatniczej. Alternatywą jest rozszerzenie Test Orders, które pozwala składać zamówienia bez pobierania prawdziwych płatności i wymaga WooCommerce 5.0.0 lub nowszego.

1. Dodaj produkt do koszyka i sprawdź, czy pojawiają się prawidłowa nazwa, ilość, cena oraz ewentualny rabat.
2. Przejdź do checkoutu i wprowadź kompletne dane kontaktowe oraz adresowe.
3. Zmień dane wpływające na dostawę, a następnie sprawdź dostępne metody i końcową sumę.
4. Sprawdź walidację wymaganych pól, na przykład wysyłając formularz bez kodu pocztowego lub danych wymaganych przez rozszerzenie.
5. Wybierz dostawę i płatność, uwzględnij ewentualne opłaty, a następnie utwórz testowe zamówienie.
6. Otwórz zamówienie w panelu WooCommerce i porównaj zapisane produkty, ceny, rabaty, opłaty, dane klienta, dostawę, płatność oraz status.

Porównaj rzeczywiste działanie z konfiguracją sklepu na każdym etapie. Jeśli rozszerzenie dodaje pole, opłatę albo metodę dostawy, sprawdź nie tylko widoczność elementu, lecz także jego walidację i zapis w zamówieniu.

Oddziel zgodność rozszerzenia od zgodności jego integracji

Rozszerzenie może być zgodne z blokami, a mimo to nie działać poprawnie z konkretną bramką płatniczą, metodą dostawy, motywem lub innym dodatkiem. Oceniaj te elementy osobno. Dostępne metody płatności zależą od aktywnych bramek oraz ich obsługi Checkout block. Niekompatybilna bramka może w ogóle nie pojawić się klientowi.

Element testu	Co sprawdzić	Jak interpretować wynik
Rozszerzenie	Czy jego funkcja pojawia się w koszyku lub checkoutcie i zapisuje dane zamówienia	Brak elementu albo błędny zapis wskazuje na problem integracji rozszerzenia z blokiem.
Bramka płatnicza	Czy metoda jest widoczna i przechodzi przez testową transakcję	Brak metody może oznaczać brak obsługi Checkout block przez bramkę, niezależnie od zgodności rozszerzenia.
Dostawa	Czy zmiana kraju lub adresu odświeża stawki i dostępne opcje	Nieaktualna suma albo pozostawiona niedostępna metoda wskazuje na problem z przeliczaniem checkoutu.
Motyw i dodatki	Czy błąd występuje także przy natywnym edytorze, blokach i ograniczonej liczbie rozszerzeń	Jeżeli problem znika po izolacji, przyczyną może być konflikt, a nie sama deklarowana zgodność dodatku.

Podczas diagnostyki zacznij od natywnych bloków WooCommerce i możliwie prostego środowiska. Jeśli rozszerzenie działa po wyłączeniu motywu lub innego dodatku, włączaj elementy pojedynczo. Dzięki temu ustalisz, który składnik zmienia wynik testu.

Sprawdź scenariusz brzegowy ze zmianą adresu

Dodaj produkt do koszyka, a następnie w checkoutcie zmień kraj albo adres dostawy i wybierz inną dostępną metodę płatności. Oczekiwany rezultat to ponowne przeliczenie dostawy i sumy oraz pozostawienie wyłącznie metod dostępnych dla nowej lokalizacji.

Przykład: załóżmy, że dla pierwszego kraju widoczna jest dostawa kurierska, a po zmianie kraju powinna pozostać tylko dostawa do punktu odbioru. Jeśli checkout nadal pokazuje kuriera albo nie zmienia końcowej kwoty, zapisz ten wynik jako błąd do dalszej diagnozy. Nie zakładaj od razu, że odpowiada za niego rozszerzenie - przyczyną może być integracja dostawy, bramka, motyw albo konflikt z innym dodatkiem.

Po zmianie adresu sprawdź także walidację pól, ponowne wyświetlenie płatności oraz dane zapisane w zamówieniu. Samo odświeżenie widoku bez poprawnej aktualizacji zamówienia nie oznacza zgodności.

Dodaj test nieudanej płatności

W trybie testowym wywołaj odrzuconą płatność i sprawdź, czy klient otrzymuje zrozumiałą informację, a zamówienie otrzymuje status Failed. Status ten oznacza, że płatność została odrzucona albo się nie powiodła. Szczegółów szukaj w notatkach zamówienia oraz w WooCommerce > Status > Logs, korzystając z logu właściwego dla bramki.

Jeśli płatność się zawiesi albo jej wynik będzie niepewny, nie ponawiaj od razu zamówienia. Najpierw porównaj status zamówienia, notatki WooCommerce i transakcję w panelu operatora, aby uniknąć podwójnego obciążenia przy ponowieniu realnej płatności.

Co zrobić, gdy rozszerzenie nie działa z blokami?

Jeśli producent nie deklaruje obsługi bloków albo test ujawnia błąd, zapisz wynik wraz z używanymi wersjami, motywem, bramką, metodą dostawy i aktywnymi dodatkami. Następnie skontaktuj się z producentem i opisz konkretną funkcję, która nie działa. Zgłoszenie typu „checkout jest niekompatybilny” utrudnia znalezienie przyczyny.

Jeśli sklep musi działać przed rozwiązaniem problemu, możesz tymczasowo wrócić do klasycznego checkoutu. W edytorze strony Cart użyj transformacji Transform > Classic Shortcode, a następnie wykonaj tę samą zmianę na stronie Checkout. Zapisz obie strony, ponieważ Cart i Checkout blocks działają razem. Po przełączeniu ponownie sprawdź koszyk, zamówienie, płatność, dostawę i zapis danych.

Jeśli w ustawieniach Checkout block nie ma żadnej kompatybilnej metody płatności, skorzystaj z przejścia do konfiguracji metod płatności albo wróć do klasycznego checkoutu. Gdy problem dotyczy wyłącznie bramki, sprawdź jej osobną dokumentację - brak metody nie dowodzi niezgodności całego rozszerzenia.