{"id":382,"date":"2026-11-11T16:34:14","date_gmt":"2026-11-11T15:34:14","guid":{"rendered":"https:\/\/projektwordpress.pl\/index.php\/2026\/11\/11\/jak-sprawdzic-zgodnosc-rozszerzenia-z-blokami-koszyka-i-zamowienia\/"},"modified":"2026-11-11T16:34:15","modified_gmt":"2026-11-11T15:34:15","slug":"jak-sprawdzic-zgodnosc-rozszerzenia-z-blokami-koszyka-i-zamowienia","status":"publish","type":"post","link":"https:\/\/projektwordpress.pl\/index.php\/2026\/11\/11\/jak-sprawdzic-zgodnosc-rozszerzenia-z-blokami-koszyka-i-zamowienia\/","title":{"rendered":"Jak sprawdzi\u0107 zgodno\u015b\u0107 rozszerzenia z blokami koszyka i zam\u00f3wienia?"},"content":{"rendered":"<p>Aby sprawdzi\u0107 zgodno\u015b\u0107 rozszerzenia z blokami koszyka i zam\u00f3wienia, najpierw rozpoznaj typ u\u017cywanego checkoutu, nast\u0119pnie sprawd\u017a dokumentacj\u0119 producenta, a na ko\u0144cu przetestuj sklep na stagingu lub w trybie testowym p\u0142atno\u015bci. Sam brak ostrze\u017cenia w WooCommerce nie wystarcza - zgodno\u015b\u0107 trzeba potwierdzi\u0107 z u\u017cywanym motywem, bramk\u0105 p\u0142atnicz\u0105, dostaw\u0105 i pozosta\u0142ymi rozszerzeniami.<\/p>\n\n<h2>Najpierw rozpoznaj, jaki koszyk i checkout dzia\u0142a w sklepie<\/h2>\n\n<p>W panelu WordPressa przejd\u017a do <strong>WooCommerce &gt; Ustawienia &gt; Zaawansowane &gt; Ustawienia strony<\/strong>. Sprawd\u017a, kt\u00f3re strony przypisano jako Koszyk i Zam\u00f3wienie, a nast\u0119pnie otw\u00f3rz je w edytorze WordPressa.<\/p>\n\n<ul>\n<li>Blokowy koszyk rozpoznasz po bloku <code>Cart<\/code>.<\/li>\n<li>Blokowe zam\u00f3wienie rozpoznasz po bloku <code>Checkout<\/code> oraz jego cz\u0119\u015bciach, mi\u0119dzy innymi <code>Checkout Fields<\/code> i <code>Checkout Totals<\/code>.<\/li>\n<li>Klasyczny wariant u\u017cywa bloku Shortcode z tre\u015bci\u0105 <code>[woocommerce_cart]<\/code> albo <code>[woocommerce_checkout]<\/code>.<\/li>\n<\/ul>\n\n<p>Cart i Checkout blocks s\u0105 domy\u015blnym rozwi\u0105zaniem dla nowych instalacji WooCommerce od wersji 8.3, ale klasyczne shortcode\u2019y nadal s\u0105 dost\u0119pne. Ma to znaczenie, poniewa\u017c cz\u0119\u015b\u0107 rozszerze\u0144 korzysta z mechanizm\u00f3w dzia\u0142aj\u0105cych w klasycznym checkoutcie, lecz nieobs\u0142ugiwanych w jego blokowej wersji.<\/p>\n\n<figure class=\"wp-block-image size-large dgcp-auto-image dgcp-image-inline_1\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/projektwordpress.pl\/wp-content\/uploads\/dgcp-featured-v3\/ffb21c56066e17a010c879cff48a93929081729b546014c36706987183be3db4\/83ffea92793e378b02b0acc2ce686d48f676613c75e1aec01cea53a477263b17.jpg\" alt=\"Por\u00f3wnanie blok\u00f3w Cart i Checkout, w tym Checkout Fields i Checkout Totals, z klasycznymi shortcode\u2019ami [woocommerce_cart] i [woocommerce_checkout].\" class=\"wp-image-376\" width=\"1536\" height=\"1024\" srcset=\"https:\/\/projektwordpress.pl\/wp-content\/uploads\/dgcp-featured-v3\/ffb21c56066e17a010c879cff48a93929081729b546014c36706987183be3db4\/83ffea92793e378b02b0acc2ce686d48f676613c75e1aec01cea53a477263b17.jpg 1536w, https:\/\/projektwordpress.pl\/wp-content\/uploads\/dgcp-featured-v3\/ffb21c56066e17a010c879cff48a93929081729b546014c36706987183be3db4\/83ffea92793e378b02b0acc2ce686d48f676613c75e1aec01cea53a477263b17-300x200.jpg 300w, https:\/\/projektwordpress.pl\/wp-content\/uploads\/dgcp-featured-v3\/ffb21c56066e17a010c879cff48a93929081729b546014c36706987183be3db4\/83ffea92793e378b02b0acc2ce686d48f676613c75e1aec01cea53a477263b17-1024x683.jpg 1024w, https:\/\/projektwordpress.pl\/wp-content\/uploads\/dgcp-featured-v3\/ffb21c56066e17a010c879cff48a93929081729b546014c36706987183be3db4\/83ffea92793e378b02b0acc2ce686d48f676613c75e1aec01cea53a477263b17-768x512.jpg 768w\" sizes=\"auto, (max-width: 1536px) 100vw, 1536px\" \/><figcaption class=\"wp-element-caption\">Najpierw sprawd\u017a, czy strona u\u017cywa blok\u00f3w Cart i Checkout, czy klasycznych shortcode\u2019\u00f3w.<\/figcaption><\/figure>\n\n\n\n<table>\n<thead>\n<tr>\n<th>Co widzisz na stronie<\/th>\n<th>Jaki wariant dzia\u0142a<\/th>\n<th>Co to zmienia przy ocenie rozszerzenia<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Blok <code>Cart<\/code> lub <code>Checkout<\/code><\/td>\n<td>Blokowy koszyk albo checkout<\/td>\n<td>Rozszerzenie musi mie\u0107 integracj\u0119 z Cart and Checkout blocks, a nie tylko obs\u0142ug\u0119 klasycznych hook\u00f3w.<\/td>\n<\/tr>\n<tr>\n<td>Blok Shortcode z <code>[woocommerce_cart]<\/code> lub <code>[woocommerce_checkout]<\/code><\/td>\n<td>Klasyczny koszyk albo checkout<\/td>\n<td>Rozszerzenie mo\u017ce dzia\u0142a\u0107 wed\u0142ug starszego mechanizmu, ale nie oznacza to zgodno\u015bci z blokami.<\/td>\n<\/tr>\n<tr>\n<td>Brak oczekiwanego bloku lub shortcode\u2019u<\/td>\n<td>Nieprawid\u0142owo przypisana albo zmieniona strona<\/td>\n<td>Najpierw popraw przypisanie stron, a dopiero potem oceniaj dzia\u0142anie rozszerzenia.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<h2>Sprawd\u017a dokumentacj\u0119 producenta, nie tylko oznaczenie zgodno\u015bci<\/h2>\n\n<p>Przed instalacj\u0105 przejrzyj opis rozszerzenia, dokumentacj\u0119 i changelog. Szukaj jednoznacznej informacji o obs\u0142udze <em>Cart and Checkout blocks<\/em> oraz wskazania, kt\u00f3rych funkcji dotyczy zgodno\u015b\u0107. Og\u00f3lne has\u0142o o kompatybilno\u015bci z WooCommerce nie potwierdza dzia\u0142ania dodatku w blokowym koszyku i checkoutcie.<\/p>\n\n<p>Sprawd\u017a tak\u017ce minimalne wymagania dotycz\u0105ce WordPressa, WooCommerce i PHP, zakres wersji przetestowanych przez producenta oraz ograniczenia zwi\u0105zane z bramk\u0105 p\u0142atnicz\u0105, metodami dostawy, motywem i innymi rozszerzeniami. Je\u015bli dokumentacja nie rozstrzyga sprawy, popro\u015b producenta o potwierdzenie obs\u0142ugi u\u017cywanej funkcji, a nie o og\u00f3ln\u0105 deklaracj\u0119 zgodno\u015bci.<\/p>\n\n<p>WooCommerce mo\u017ce pokaza\u0107 ostrze\u017cenie dla rozszerzenia, kt\u00f3re zadeklarowa\u0142o niezgodno\u015b\u0107 z funkcj\u0105 <code>cart_checkout_blocks<\/code>. Sprawdza t\u0119 deklaracj\u0119 dla wtyczek zawieraj\u0105cych w g\u0142\u00f3wnym pliku nag\u0142\u00f3wek <code>WC tested up to<\/code>. Sam nag\u0142\u00f3wek nie potwierdza zgodno\u015bci z blokami - producent deklaruje j\u0105 osobno, na przyk\u0142ad za pomoc\u0105 <code>FeaturesUtil::declare_compatibility<\/code>. <strong>Brak ostrze\u017cenia nie potwierdza pe\u0142nej zgodno\u015bci<\/strong>, dlatego nadal potrzebujesz testu sklepu.<\/p>\n\n<p>Je\u015bli dopiero przygotowujesz \u015brodowisko do uruchomienia sklepu, mo\u017cesz przej\u015b\u0107 do <a href=\"https:\/\/projektwordpress.pl\/index.php\/uruchom-sklep-woocommerce\/\">uruchomienia sklepu WooCommerce<\/a> po ustaleniu, czy wybrane rozszerzenia obs\u0142uguj\u0105 u\u017cywany wariant checkoutu.<\/p>\n\n<h2>Wykonaj test koszyka i zam\u00f3wienia w bezpiecznym \u015brodowisku<\/h2>\n\n<p>Skopiuj sklep na staging albo u\u017cyj trybu testowego bramki p\u0142atniczej. Alternatyw\u0105 jest rozszerzenie Test Orders, kt\u00f3re pozwala sk\u0142ada\u0107 zam\u00f3wienia bez pobierania prawdziwych p\u0142atno\u015bci i wymaga WooCommerce 5.0.0 lub nowszego.<\/p>\n\n<ol>\n<li>Dodaj produkt do koszyka i sprawd\u017a, czy pojawiaj\u0105 si\u0119 prawid\u0142owa nazwa, ilo\u015b\u0107, cena oraz ewentualny rabat.<\/li>\n<li>Przejd\u017a do checkoutu i wprowad\u017a kompletne dane kontaktowe oraz adresowe.<\/li>\n<li>Zmie\u0144 dane wp\u0142ywaj\u0105ce na dostaw\u0119, a nast\u0119pnie sprawd\u017a dost\u0119pne metody i ko\u0144cow\u0105 sum\u0119.<\/li>\n<li>Sprawd\u017a walidacj\u0119 wymaganych p\u00f3l, na przyk\u0142ad wysy\u0142aj\u0105c formularz bez kodu pocztowego lub danych wymaganych przez rozszerzenie.<\/li>\n<li>Wybierz dostaw\u0119 i p\u0142atno\u015b\u0107, uwzgl\u0119dnij ewentualne op\u0142aty, a nast\u0119pnie utw\u00f3rz testowe zam\u00f3wienie.<\/li>\n<li>Otw\u00f3rz zam\u00f3wienie w panelu WooCommerce i por\u00f3wnaj zapisane produkty, ceny, rabaty, op\u0142aty, dane klienta, dostaw\u0119, p\u0142atno\u015b\u0107 oraz status.<\/li>\n<\/ol>\n\n<p>Por\u00f3wnaj rzeczywiste dzia\u0142anie z konfiguracj\u0105 sklepu na ka\u017cdym etapie. Je\u015bli rozszerzenie dodaje pole, op\u0142at\u0119 albo metod\u0119 dostawy, sprawd\u017a nie tylko widoczno\u015b\u0107 elementu, lecz tak\u017ce jego walidacj\u0119 i zapis w zam\u00f3wieniu.<\/p>\n\n<h2>Oddziel zgodno\u015b\u0107 rozszerzenia od zgodno\u015bci jego integracji<\/h2>\n\n<p>Rozszerzenie mo\u017ce by\u0107 zgodne z blokami, a mimo to nie dzia\u0142a\u0107 poprawnie z konkretn\u0105 bramk\u0105 p\u0142atnicz\u0105, metod\u0105 dostawy, motywem lub innym dodatkiem. Oceniaj te elementy osobno. Dost\u0119pne metody p\u0142atno\u015bci zale\u017c\u0105 od aktywnych bramek oraz ich obs\u0142ugi Checkout block. Niekompatybilna bramka mo\u017ce w og\u00f3le nie pojawi\u0107 si\u0119 klientowi.<\/p>\n\n<table>\n<thead>\n<tr>\n<th>Element testu<\/th>\n<th>Co sprawdzi\u0107<\/th>\n<th>Jak interpretowa\u0107 wynik<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Rozszerzenie<\/td>\n<td>Czy jego funkcja pojawia si\u0119 w koszyku lub checkoutcie i zapisuje dane zam\u00f3wienia<\/td>\n<td>Brak elementu albo b\u0142\u0119dny zapis wskazuje na problem integracji rozszerzenia z blokiem.<\/td>\n<\/tr>\n<tr>\n<td>Bramka p\u0142atnicza<\/td>\n<td>Czy metoda jest widoczna i przechodzi przez testow\u0105 transakcj\u0119<\/td>\n<td>Brak metody mo\u017ce oznacza\u0107 brak obs\u0142ugi Checkout block przez bramk\u0119, niezale\u017cnie od zgodno\u015bci rozszerzenia.<\/td>\n<\/tr>\n<tr>\n<td>Dostawa<\/td>\n<td>Czy zmiana kraju lub adresu od\u015bwie\u017ca stawki i dost\u0119pne opcje<\/td>\n<td>Nieaktualna suma albo pozostawiona niedost\u0119pna metoda wskazuje na problem z przeliczaniem checkoutu.<\/td>\n<\/tr>\n<tr>\n<td>Motyw i dodatki<\/td>\n<td>Czy b\u0142\u0105d wyst\u0119puje tak\u017ce przy natywnym edytorze, blokach i ograniczonej liczbie rozszerze\u0144<\/td>\n<td>Je\u017celi problem znika po izolacji, przyczyn\u0105 mo\u017ce by\u0107 konflikt, a nie sama deklarowana zgodno\u015b\u0107 dodatku.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<p>Podczas diagnostyki zacznij od natywnych blok\u00f3w WooCommerce i mo\u017cliwie prostego \u015brodowiska. Je\u015bli rozszerzenie dzia\u0142a po wy\u0142\u0105czeniu motywu lub innego dodatku, w\u0142\u0105czaj elementy pojedynczo. Dzi\u0119ki temu ustalisz, kt\u00f3ry sk\u0142adnik zmienia wynik testu.<\/p>\n\n<h2>Sprawd\u017a scenariusz brzegowy ze zmian\u0105 adresu<\/h2>\n\n<p>Dodaj produkt do koszyka, a nast\u0119pnie w checkoutcie zmie\u0144 kraj albo adres dostawy i wybierz inn\u0105 dost\u0119pn\u0105 metod\u0119 p\u0142atno\u015bci. <strong>Oczekiwany rezultat to ponowne przeliczenie<\/strong> dostawy i sumy oraz pozostawienie wy\u0142\u0105cznie metod dost\u0119pnych dla nowej lokalizacji.<\/p>\n\n<p>Przyk\u0142ad: za\u0142\u00f3\u017cmy, \u017ce dla pierwszego kraju widoczna jest dostawa kurierska, a po zmianie kraju powinna pozosta\u0107 tylko dostawa do punktu odbioru. Je\u015bli checkout nadal pokazuje kuriera albo nie zmienia ko\u0144cowej kwoty, zapisz ten wynik jako b\u0142\u0105d do dalszej diagnozy. Nie zak\u0142adaj od razu, \u017ce odpowiada za niego rozszerzenie - przyczyn\u0105 mo\u017ce by\u0107 integracja dostawy, bramka, motyw albo konflikt z innym dodatkiem.<\/p>\n\n<p>Po zmianie adresu sprawd\u017a tak\u017ce walidacj\u0119 p\u00f3l, ponowne wy\u015bwietlenie p\u0142atno\u015bci oraz dane zapisane w zam\u00f3wieniu. Samo od\u015bwie\u017cenie widoku bez poprawnej aktualizacji zam\u00f3wienia nie oznacza zgodno\u015bci.<\/p>\n\n<h2>Dodaj test nieudanej p\u0142atno\u015bci<\/h2>\n\n<p>W trybie testowym wywo\u0142aj odrzucon\u0105 p\u0142atno\u015b\u0107 i sprawd\u017a, czy klient otrzymuje zrozumia\u0142\u0105 informacj\u0119, a zam\u00f3wienie otrzymuje status <code>Failed<\/code>. Status ten oznacza, \u017ce p\u0142atno\u015b\u0107 zosta\u0142a odrzucona albo si\u0119 nie powiod\u0142a. Szczeg\u00f3\u0142\u00f3w szukaj w notatkach zam\u00f3wienia oraz w <strong>WooCommerce &gt; Status &gt; Logs<\/strong>, korzystaj\u0105c z logu w\u0142a\u015bciwego dla bramki.<\/p>\n\n<p>Je\u015bli p\u0142atno\u015b\u0107 si\u0119 zawiesi albo jej wynik b\u0119dzie niepewny, nie ponawiaj od razu zam\u00f3wienia. Najpierw por\u00f3wnaj status zam\u00f3wienia, notatki WooCommerce i transakcj\u0119 w panelu operatora, aby unikn\u0105\u0107 podw\u00f3jnego obci\u0105\u017cenia przy ponowieniu realnej p\u0142atno\u015bci.<\/p>\n\n<h2>Co zrobi\u0107, gdy rozszerzenie nie dzia\u0142a z blokami?<\/h2>\n\n<p>Je\u015bli producent nie deklaruje obs\u0142ugi blok\u00f3w albo test ujawnia b\u0142\u0105d, zapisz wynik wraz z u\u017cywanymi wersjami, motywem, bramk\u0105, metod\u0105 dostawy i aktywnymi dodatkami. Nast\u0119pnie skontaktuj si\u0119 z producentem i opisz konkretn\u0105 funkcj\u0119, kt\u00f3ra nie dzia\u0142a. Zg\u0142oszenie typu \u201echeckout jest niekompatybilny\u201d utrudnia znalezienie przyczyny.<\/p>\n\n<p>Je\u015bli sklep musi dzia\u0142a\u0107 przed rozwi\u0105zaniem problemu, mo\u017cesz tymczasowo wr\u00f3ci\u0107 do klasycznego checkoutu. W edytorze strony Cart u\u017cyj transformacji <code>Transform &gt; Classic Shortcode<\/code>, a nast\u0119pnie wykonaj t\u0119 sam\u0105 zmian\u0119 na stronie Checkout. Zapisz obie strony, poniewa\u017c Cart i Checkout blocks dzia\u0142aj\u0105 razem. Po prze\u0142\u0105czeniu ponownie sprawd\u017a koszyk, zam\u00f3wienie, p\u0142atno\u015b\u0107, dostaw\u0119 i zapis danych.<\/p>\n\n<p>Je\u015bli w ustawieniach Checkout block nie ma \u017cadnej kompatybilnej metody p\u0142atno\u015bci, skorzystaj z przej\u015bcia do konfiguracji metod p\u0142atno\u015bci albo wr\u00f3\u0107 do klasycznego checkoutu. Gdy problem dotyczy wy\u0142\u0105cznie bramki, sprawd\u017a jej osobn\u0105 dokumentacj\u0119 - brak metody nie dowodzi niezgodno\u015bci ca\u0142ego rozszerzenia.<\/p>","protected":false},"excerpt":{"rendered":"<p>Aby sprawdzi\u0107 zgodno\u015b\u0107 rozszerzenia z blokami koszyka i zam\u00f3wienia, najpierw rozpoznaj typ u\u017cywanego checkoutu, nast\u0119pnie sprawd\u017a dokumentacj\u0119 producenta, a na ko\u0144cu przetestuj sklep na&hellip;<\/p>\n","protected":false},"author":3,"featured_media":375,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[23,21,24,20,22],"class_list":["post-382","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wtyczki-woocommerce","tag-bramki-platnicze","tag-checkout-blocks","tag-testowanie-sklepu","tag-woocommerce","tag-wtyczki-woocommerce"],"_links":{"self":[{"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/posts\/382","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/comments?post=382"}],"version-history":[{"count":1,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/posts\/382\/revisions"}],"predecessor-version":[{"id":383,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/posts\/382\/revisions\/383"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/media\/375"}],"wp:attachment":[{"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/media?parent=382"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/categories?post=382"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/projektwordpress.pl\/index.php\/wp-json\/wp\/v2\/tags?post=382"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}