Programista WooCommerce w Gdyni

Naprawa i rozwój sklepów WooCommerce w Gdyni i Trójmieście: webhooki, nadpisane szablony, stany magazynowe, prawo konsumenckie i KSeF. Praca zdalna, pisemnie.

Programista WooCommerce

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

Mój profil na WordPress.org

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.

Widok z Kamiennej Góry na gdyński port, zdjęcie sprzed 1934 roku

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ę?

ObjawGdzie 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ącegoStatus webhooka i dziennik w WooCommerce > Status > Logs
Stan magazynowy rośnie albo maleje bez sprzedażyPrzepływ statusów zamówień, w tym failed i on-hold
Link z kampanii nie napełnia koszykaIdentyfikatory i SKU w parametrze products
Płatność przechodzi, a zamówienie zostaje bez statusuDziennik 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ą?

  1. 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.
  2. Pytania i diagnoza. Odpowiadam pytaniami, potem opisuję znalezioną przyczynę i proponowany zakres poprawki.
  3. Zakres i założenia. Pierwsza wycena jest bezpłatna. Prace ruszają po zaksięgowaniu zaliczki.
  4. Staging i odbiór. Poprawkę robię na kopii, ty sprawdzasz zamówienie testowe, płatność próbną, zwrot i mail do klienta.
  5. 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.

Zobacz też w innych miastach Polski

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 WP

Potrzebujesz usługi: Programista WooCommerce w Gdyni?

Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.

Opisz projekt

Sprawdź inne usługi WordPress i bazę wiedzy