Moje miejsce w społeczności WordPress
- Konto na wordpress.org mam od 2006 roku.
- Współtworzyłem rdzeń WordPressa w wersjach 7.0 i 7.1.
- Utrzymuję 30 wtyczek na wordpress.org.
- Organizuję WordCampy i występuję na nich jako prelegent.
- Byłem na każdym WordCamp Europe od 2017 do 2026 roku.
- Lokalne spotkania WordPressa: WordPress Gdynia Meetup
Sklep WooCommerce zwykle przestaje działać po cichu. Nikt nie widzi błędu, tylko zamówień jest mniej, mail z potwierdzeniem nie wychodzi albo stan magazynowy nie zgadza się z półką. Dlatego ta strona jest o naprawach: skąd biorą się najczęstsze usterki sklepu na WooCommerce i jak je rozpoznaję, zanim cokolwiek zmienię.
Jestem Mariusz Szatkowski, z WordPressem pracuję od 2006 roku, mieszkam i pracuję w Gdyni. Obsługuję sklepy z Gdyni, Gdańska i Sopotu, ale cała współpraca jest zdalna i pisemna. Nie umawiam spotkań ani rozmów, także lokalnie: opis usterki, pytania, zakres i odbiór idą mailem i w dokumentach, więc po miesiącu wiadomo, co ustalono i co zmieniono.

Zdjęcie archiwalne: Leonard Durczykiewicz, Public domain, Wikimedia Commons.
Co psuje sklep WooCommerce najczęściej?
Poniższe cztery przypadki opisuje oficjalna dokumentacja WooCommerce. Wszystkie dają objaw, który właściciel sklepu widzi dopiero w wynikach sprzedaży.
Przestarzałe nadpisane szablony. Motyw może mieć własne kopie plików WooCommerce, na przykład koszyka albo maila z zamówieniem. Po aktualizacji wtyczki kopia zostaje w starej wersji. Według instrukcji naprawy przestarzałych szablonów ostrzeżenie widać na dole strony WooCommerce > Status > System Status. Naprawa polega na zrobieniu kopii starego pliku, wstawieniu aktualnego szablonu z wtyczki do motywu i przeniesieniu własnych zmian. Dokumentacja radzi też, żeby tam, gdzie się da, używać haków zamiast nadpisywania szablonów (struktura szablonów).
Webhook, który sam się wyłączył. Webhook ma trzy statusy: aktywny, wstrzymany i wyłączony. Wyłączony oznacza, że WooCommerce zatrzymał wysyłkę po powtarzających się błędach. Domyślnie dzieje się to po pięciu nieudanych próbach, gdy adres odbiorcy zwraca na przykład błąd 404 albo 5xx. Limit podnosi filtr woocommerce_max_webhook_delivery_failures, a próby i odpowiedzi serwera widać w WooCommerce > Status > Logs (webhooks w WooCommerce). Skutek w praktyce: zamówienia przestają trafiać do magazynu albo do programu fakturującego, a sklep wygląda na zdrowy.
Zwolniony stan magazynowy po nieudanej płatności. Od WooCommerce 11.0 zamówienie, które przechodzi do statusu failed, przywraca zmniejszony wcześniej stan magazynowy. Wcześniej robiły to statusy cancelled i pending, ale nie failed. Autorzy ostrzegają wtyczki, które używają failed do czegoś innego niż płatność, i radzą przetestować własne ścieżki statusów (komunikat dla deweloperów). Jeśli sklep ma własne statusy zamówień, sprawdzam je po każdej większej aktualizacji.
Link do koszyka z kampanii. Adres /checkout-link/ wypełnia koszyk produktami i od razu prowadzi do kasy. Parametr products przyjmuje listę w formacie id-lub-sku:ilość, a coupon stosuje kod rabatowy. Po przekierowaniu adres dostaje parametr session, więc koszyk można udostępnić (adresy do kasy). Gdy kampania prowadzi do pustego koszyka, zaczynam od sprawdzenia, czy identyfikator albo SKU z linku nadal istnieje.
Jak rozpoznaję przyczynę, zanim coś zmienię?
| Objaw | Gdzie patrzę najpierw |
|---|---|
| Po aktualizacji wygląd koszyka albo maila się rozjechał | Lista nadpisanych szablonów w System Status |
| Zamówienia nie dochodzą do magazynu lub programu fakturującego | Status webhooka i dziennik w WooCommerce > Status > Logs |
| Stan magazynowy rośnie albo maleje bez sprzedaży | Przepływ statusów zamówień, w tym failed i on-hold |
| Link z kampanii nie napełnia koszyka | Identyfikatory i SKU w parametrze products |
| Płatność przechodzi, a zamówienie zostaje bez statusu | Dziennik bramki i odpowiedź jej serwera |
Pracę zaczynam od kopii sklepu. Błąd odtwarzam na stagingu, opisuję przyczynę na piśmie i dopiero po twojej zgodzie poprawiam produkcję, z planem cofnięcia zmian. Jeśli naprawa wymaga czegoś spoza zgłoszonego zakresu, opisuję to osobno i czekam na twoje potwierdzenie.
Gdynia, Gdańsk i Sopot: jak z nich pracuję
Według serwisu InvestGdynia miasto prowadzi przetargi na nieruchomości i ma wyszukiwarkę lokalizacji, a także certyfikat ISO 37120 dla miast inteligentnych (investgdynia.pl). Sklep z Gdyni sprzedaje zwykle w całej Polsce, więc to, że wykonawca mieszka w tym samym mieście, niczego w nim nie zmienia. Ustalenia zapisuję w dokumentach, a nie w rozmowach.
Z drugiej strony Trójmiasta działa InnoBaltica, która według opisu na portalu ScanBalt koordynuje dwa pomorskie klastry, BioEkoChem i KlimaPomerania (ScanBalt). Sklepy takich firm bywają katalogami dla kontrahentów, nie sklepami dla konsumenta, ale usterki w nich są te same: webhooki, szablony i statusy zamówień. Jeśli potrzebujesz też strony firmowej, zobacz programistę WordPress w Gdyni.
Jeśli szukasz stałej opieki nad stroną, na przykład po zapytaniu o opiekę nad WordPressem w Gdańsku, zakres opisałem na stronie opieka techniczna WordPress w Gdyni. Praca zdalna działa tak samo dla Gdańska, więc osobnej oferty dla niego nie ma.
Które przepisy dotyczą naprawianego sklepu?
Poniżej tylko to, co sprawdzam przy naprawie koszyka i kasy. To nie porada prawna, więc wiążące kwestie rozstrzygnie prawnik.
- Przycisk zamówienia. Według art. 17 ustawy o prawach konsumenta (Dz.U. 2026 poz. 1244) przycisk składający zamówienie musi być oznaczony słowami „zamówienie z obowiązkiem zapłaty” albo równoważnym jednoznacznym sformułowaniem. Gdy tego nie spełnia, umowa nie zostaje zawarta (ust. 3 i 4). Po zmianie motywu albo tłumaczeń sprawdzam, czy etykieta nie wróciła do ogólnego „Złóż zamówienie”.
- Informacja o odstąpieniu. Konsument ma 14 dni na odstąpienie od umowy zawartej na odległość (art. 27). Jeśli sklep go o tym prawie nie poinformował, prawo wygasa dopiero po 12 miesiącach od upływu tego terminu (art. 29 ust. 1). Dlatego wiadomość z potwierdzeniem zamówienia i strona z regulaminem muszą działać po każdej aktualizacji.
- Reklamacje. Przedsiębiorca odpowiada na reklamację konsumenta w ciągu 14 dni, a brak odpowiedzi oznacza uznanie reklamacji. Odpowiedź przekazuje na papierze lub innym trwałym nośniku (art. 7a). Skrzynka, do której sklep wysyła maile, musi więc rzeczywiście je dostarczać.
- Cookies. Art. 399 Prawa komunikacji elektronicznej (Dz.U. 2024 poz. 1221) wymaga uprzedniej informacji o celu i zgody użytkownika na zapis lub odczyt informacji na jego urządzeniu. Skrypty analityczne i reklamowe ładuję po zgodzie.
- Dostępność. Ustawa o zapewnianiu spełniania wymagań dostępności (Dz.U. 2024 poz. 731) weszła w życie 28 czerwca 2025 roku (art. 88), a według jej art. 4 pkt 1 nie stosuje się jej do usług mikroprzedsiębiorców. Czy nim jesteś, sprawdzasz według definicji z ustawy.
- KSeF. Według oficjalnej strony KSeF system w wersji 2.0 działa od 1 lutego 2026 roku dla dużych firm i odbiorców faktur, od 1 kwietnia 2026 jest obowiązkowy dla pozostałych, a od 1 stycznia 2027 także dla firm ze sprzedażą do 10 tysięcy złotych miesięcznie. Fakturę zwykle wystawia program księgowy. Sklep ma przekazać mu poprawne dane, więc po naprawie sprawdzam, czy NIP z zamówienia dociera do niego w całości. Jak to wygląda technicznie, opisałem we wpisie KSeF w WooCommerce.
Czy wtyczka Polski for WooCommerce przyda się w takim sklepie?
To moja darmowa wtyczka, więc mówię o niej tylko to, co stoi na jej stronie w katalogu WordPressa. Jest modułowa, więc włączasz tylko to, czego sklep potrzebuje. W wersji darmowej ma między innymi numerowane faktury VAT, historię najniższej ceny z 30 dni, pola GPSR, pola zgód z dziennikiem, formularz odstąpienia od umowy, obsługę NIP i VIES oraz flagę KSeF z hakami dla integracji. Obsługuje koszyk klasyczny i blokowy oraz HPOS. Wymaga WordPressa 6.9 lub nowszego i PHP 8.1 lub nowszego. Wysyłka do KSeF 2.0 jest w osobnej wersji PRO. Strona wtyczki zaznacza, że nie jest to porada prawna ani gwarancja zgodności z przepisami.
Przy naprawie sprawdzam najpierw, czy sklep nie ma już wtyczki, która robi to samo. Dwie wtyczki z tą samą funkcją często dają duplikaty pól w kasie.
Jak wygląda naprawa ze mną?
- Zgłoszenie na piśmie. Wysyłasz adres sklepu, opis objawu, datę, od której go widać, i ostatnią zmianę w sklepie, jeśli ją pamiętasz.
- Pytania i diagnoza. Odpowiadam pytaniami, potem opisuję znalezioną przyczynę i proponowany zakres poprawki.
- Zakres i założenia. Pierwsza wycena jest bezpłatna. Prace ruszają po zaksięgowaniu zaliczki.
- Staging i odbiór. Poprawkę robię na kopii, ty sprawdzasz zamówienie testowe, płatność próbną, zwrot i mail do klienta.
- Wdrożenie i opis. Wdrażam po twojej akceptacji i zostawiam pisemny opis tego, co zmieniłem i dlaczego.
Układ widoków, makiety i projekt graficzny dostarczasz ty, ja wdrażam je w sklepie.
Co przygotuj przed zgłoszeniem:
- dostęp do panelu WordPressa i hostingu,
- opis objawu, najlepiej ze zrzutem ekranu i godziną zdarzenia,
- listę wtyczek, które ostatnio aktualizowano,
- dostęp do panelu bramki płatniczej, jeśli problem dotyczy płatności,
- informację, który system księgowy lub magazynowy dostaje dane ze sklepu.
Pytania, które zadają właściciele sklepów z Trójmiasta
Ile czasu zajmuje naprawa sklepu WooCommerce? To zależy od przyczyny. Przy zgłoszeniu opisuję, od czego zacznę, a po diagnozie podaję zakres na piśmie. Nie obiecuję terminu przed zobaczeniem sklepu.
Czy naprawiasz sklep, którego nie budowałem ja ani ty? Tak. Zaczynam od przeglądu motywu, wtyczek i nadpisanych szablonów, bo tam najczęściej leży przyczyna.
Czy po aktualizacji WooCommerce mogę się spodziewać problemów? Zdarza się, że zmiana w rdzeniu wpływa na własny kod. Przykładem jest zmiana z WooCommerce 11.0 dotycząca stanu magazynowego przy zamówieniach failed. Dlatego aktualizacje testuję na kopii.
Czy jako programista WooCommerce spotkasz się ze mną w Gdyni? Nie. Mieszkam w Gdyni, ale pracuję wyłącznie zdalnie i na piśmie.
Co z opieką po naprawie? Możesz przejąć sklep samodzielnie albo skorzystać z opieki nad aktualizacjami, kopiami i bezpieczeństwem. Zakres opisuje strona o opiece technicznej WordPress w Gdyni.
Czy muszę mieć wtyczkę Polski for WooCommerce? Nie. Jest opcjonalna i darmowa. Wiele sklepów obsługuje te same funkcje innymi wtyczkami albo własnym kodem.
Napisz do mnie
Wyślij adres sklepu, opis usterki albo planowanej zmiany, termin i obecny stos: motyw, bramki płatnicze i system księgowy lub magazynowy. Odpiszę pytaniami albo pierwszą wyceną na piśmie, która jest bezpłatna. Napisz przez formularz kontaktowy.
Wybrane projekty
Przykłady mojej pracy.
E-commerce Development: centrumpoludnie.pl
Projekt portalu centrumpoludnie.pl dla centrum handlowego, obejmujący prezentację sklepów, promocji, aktualności i wygodną administrację treścią.
E-commerce Development: estel-poland.com
estel-poland.com to profesjonalny sklep internetowy z kosmetykami, stworzony z myślą o klientach poszukujących wysokiej jakości produktów pielęgnacyjnych i m...
E-commerce Development: floresy.online
Floresy.online to witryna stworzona dla Floresy, wiodącego producenta, hurtownika i detalisty sztucznych roślin, kwiatów i drzew. Firma działa w branży od p...
Najbliższe wydarzenia WordPress
Spotkaj się z nami na WordCampie
Dołącz do społeczności WordPress w Gdyni. Regularnie bywam na meetupach i WordCampach w całej Polsce - WordUp Trójmiasto, WordCamp Polska i WordCamp Europe. Podejdź i porozmawiajmy.
Dodaj kalendarz WPPotrzebujesz usługi: Programista WooCommerce w Gdyni?
Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.
Opisz projektSprawdź inne usługi WordPress i bazę wiedzy
Sklepy, checkout i logika sprzedażowa.
Awaria sklepu, wolny checkout, chaos po aktualizacji.
Opieka, monitoring i przewidywalna dostępność WooCommerce.
Checklisty UE dla sklepu: VAT, dostępność, dowody zgodności.
White-label development WordPress dla agencji.
Synchronizacja WooCommerce z ERP i hurtownią.
Automatyzacja procesów biznesowych wokół WordPress i systemów firmowych.
Biblioteka konkretnych przypadków automatyzacji.
Powiązane kategorie
Artykuły wspierające temat

Google uruchomiło Universal Cart w Search i Gemini w oparciu o Universal Commerce Protocol. Sprawdź, jak dostosować sklep WooCommerce do natywnych transakcji agentowych AI.

Architektura sklepu WooCommerce na Astro 7. Co zostaje w wp-admin, które wtyczki umierają z motywem, Store API kontra GraphQL i dlaczego kasy nie odpinasz od WooCommerce.

Od 27 września 2026 sklep internetowy musi pokazać konsumentowi wzór powiadomienia o gwarancji ustawowej, a przy gwarancji producenta na trwałość etykietę GARAN. Co dokładnie, gdzie, od kiedy i jak to wdrożyć w WooCommerce.