Wtyczka WooCommerce na zamówienie - hooki, bezpieczeństwo i utrzymanie

Łukasz Palej
Łukasz Palej
Technical Implementation Expert
Wtyczka WooCommerce na zamówienie - hooki, bezpieczeństwo i utrzymanie
Wtyczka WooCommerce na zamówienie to własny dodatek do sklepu, który zmienia jego działanie przez hooki WordPressa i WooCommerce - akcje i filtry - zamiast edycji plików rdzenia, motywu czy cudzych wtyczek. Dobrze napisana wtyczka sprawdza uprawnienia i tokeny nonce, waliduje dane wejściowe i zabezpiecza dane wyjściowe, deklaruje zgodność z HPOS i blokowym koszykiem oraz ma plan aktualizacji. Bez tego nawet mała wtyczka może zatrzymać sprzedaż po aktualizacji albo otworzyć lukę w zabezpieczeniach.
W tym wpisie wyjaśniamy, jak zbudowana jest wtyczka WooCommerce, które hooki i interfejsy stosować, jakie zasady bezpieczeństwa wynikają z dokumentacji WordPressa i WooCommerce oraz jak utrzymywać własny kod po wdrożeniu. Tekst jest dla właścicieli sklepów, którzy zamawiają wtyczkę u programisty i chcą wiedzieć, czego wymagać przy odbiorze.
[#wazne] W skrócie: wtyczka WooCommerce na zamówienie powinna działać przez hooki (add_action, add_filter), używać obiektów i API WooCommerce zamiast bezpośrednich zapytań do tabel, deklarować zgodność z HPOS, a przy polach w kasie korzystać z interfejsów blokowego checkoutu. Bezpieczeństwo to sprawdzanie uprawnień, nonce, walidacja wejścia i escapowanie wyjścia. Programiści Vinson piszą wtyczki zgodnie z tymi zasadami i przejmują utrzymanie istniejących.
Kiedy sklep potrzebuje wtyczki WooCommerce na zamówienie
Własna wtyczka ma sens, gdy funkcji nie ma w WooCommerce ani w sprawdzonych dodatkach, albo gdy gotowa wtyczka robi dużo więcej, niż potrzebujesz, i obciąża sklep. Typowe przykłady to nietypowe reguły dostawy, dodatkowe dane w zamówieniu, eksport do systemu firmy, własny raport czy automatyczne działania po zmianie statusu. Zanim zamówisz kod, sprawdź listę obecnych wtyczek - czasem lepiej wymienić dwie słabe na jedną dopracowaną. Jak ocenić, które dodatki zostawić, opisujemy we wpisie wtyczki WooCommerce - jak ocenić, które zostawić.
Najważniejsza zasada: zmiany w działaniu sklepu umieszcza się we własnej wtyczce, a nie w plikach WooCommerce, motywu czy cudzych dodatków. Edycja cudzego kodu znika przy pierwszej aktualizacji, a do tego nikt nie wie, że została zrobiona. Wtyczka na zamówienie daje jedno miejsce, w którym widać wszystkie modyfikacje sklepu.
Hooki WooCommerce - jak wtyczka zmienia działanie sklepu
Hooki to punkty, w których jeden kod może zmienić działanie innego. Dokumentacja WordPressa wyróżnia dwa rodzaje. Akcje wykonują zadanie w określonym momencie i nie zwracają wartości - podpina się je funkcją add_action, a domyślny priorytet wynosi 10. Filtry przyjmują wartość, zmieniają ją i zwracają - podpina się je funkcją add_filter, a dokumentacja zaznacza, że filtry nie powinny mieć skutków ubocznych. WooCommerce udostępnia wiele własnych akcji i filtrów, np. przy zmianie statusu zamówienia czy liczeniu koszyka.
Poza hookami wtyczka ma do dyspozycji kilka innych punktów rozszerzenia, a wybór zależy od tego, co ma zmienić:
[#chart:wpr95a]
Dobra wtyczka sama też udostępnia hooki. Wytyczne WooCommerce dla rozszerzeń zalecają dodawanie akcji i filtrów, żeby inni programiści mogli zmienić działanie wtyczki bez edycji jej kodu, oraz szablonów, które sklep może nadpisać w motywie. Własne hooki tworzy się funkcjami do_action i apply_filters.
Wtyczka WooCommerce na zamówienie to własny dodatek do sklepu, który zmienia jego działanie przez hooki WordPressa i WooCommerce - akcje i filtry - zamiast edycji plików rdzenia, motywu czy cudzych wtyczek. Dobrze napisana wtyczka sprawdza uprawnienia i tokeny nonce, waliduje dane wejściowe i zabezpiecza dane wyjściowe, deklaruje zgodność z HPOS i blokowym koszykiem oraz ma plan aktualizacji. Bez tego nawet mała wtyczka może zatrzymać sprzedaż po aktualizacji albo otworzyć lukę w zabezpieczeniach.
W tym wpisie wyjaśniamy, jak zbudowana jest wtyczka WooCommerce, które hooki i interfejsy stosować, jakie zasady bezpieczeństwa wynikają z dokumentacji WordPressa i WooCommerce oraz jak utrzymywać własny kod po wdrożeniu. Tekst jest dla właścicieli sklepów, którzy zamawiają wtyczkę u programisty i chcą wiedzieć, czego wymagać przy odbiorze.
[#wazne] W skrócie: wtyczka WooCommerce na zamówienie powinna działać przez hooki (add_action, add_filter), używać obiektów i API WooCommerce zamiast bezpośrednich zapytań do tabel, deklarować zgodność z HPOS, a przy polach w kasie korzystać z interfejsów blokowego checkoutu. Bezpieczeństwo to sprawdzanie uprawnień, nonce, walidacja wejścia i escapowanie wyjścia. Programiści Vinson piszą wtyczki zgodnie z tymi zasadami i przejmują utrzymanie istniejących.
Kiedy sklep potrzebuje wtyczki WooCommerce na zamówienie
Własna wtyczka ma sens, gdy funkcji nie ma w WooCommerce ani w sprawdzonych dodatkach, albo gdy gotowa wtyczka robi dużo więcej, niż potrzebujesz, i obciąża sklep. Typowe przykłady to nietypowe reguły dostawy, dodatkowe dane w zamówieniu, eksport do systemu firmy, własny raport czy automatyczne działania po zmianie statusu. Zanim zamówisz kod, sprawdź listę obecnych wtyczek - czasem lepiej wymienić dwie słabe na jedną dopracowaną. Jak ocenić, które dodatki zostawić, opisujemy we wpisie wtyczki WooCommerce - jak ocenić, które zostawić.
Najważniejsza zasada: zmiany w działaniu sklepu umieszcza się we własnej wtyczce, a nie w plikach WooCommerce, motywu czy cudzych dodatków. Edycja cudzego kodu znika przy pierwszej aktualizacji, a do tego nikt nie wie, że została zrobiona. Wtyczka na zamówienie daje jedno miejsce, w którym widać wszystkie modyfikacje sklepu.
Hooki WooCommerce - jak wtyczka zmienia działanie sklepu
Hooki to punkty, w których jeden kod może zmienić działanie innego. Dokumentacja WordPressa wyróżnia dwa rodzaje. Akcje wykonują zadanie w określonym momencie i nie zwracają wartości - podpina się je funkcją add_action, a domyślny priorytet wynosi 10. Filtry przyjmują wartość, zmieniają ją i zwracają - podpina się je funkcją add_filter, a dokumentacja zaznacza, że filtry nie powinny mieć skutków ubocznych. WooCommerce udostępnia wiele własnych akcji i filtrów, np. przy zmianie statusu zamówienia czy liczeniu koszyka.
Poza hookami wtyczka ma do dyspozycji kilka innych punktów rozszerzenia, a wybór zależy od tego, co ma zmienić:
[#chart:wpr95a]
Dobra wtyczka sama też udostępnia hooki. Wytyczne WooCommerce dla rozszerzeń zalecają dodawanie akcji i filtrów, żeby inni programiści mogli zmienić działanie wtyczki bez edycji jej kodu, oraz szablonów, które sklep może nadpisać w motywie. Własne hooki tworzy się funkcjami do_action i apply_filters.
- Wycena zadania w 24 h w dni robocze
- Integracje, API, feedy i poprawki w sklepie
- Rozliczenie godzinowe albo za projekt
Konsultację poprowadzi Łukasz Palej, Technical Implementation ExpertHPOS i blokowy koszyk - zgodność wtyczki z nowym WooCommerce
Zgodność z HPOS
Wydajne przechowywanie zamówień (HPOS) trzyma zamówienia we własnych tabelach zamiast w tabelach wpisów WordPressa. Wtyczka, która odczytuje zamówienia przez get_post albo zapisuje dane funkcją update_post_meta, przestaje działać poprawnie. Dokumentacja WooCommerce każe pobierać zamówienie przez wc_get_order, zapisywać metadane metodami obiektu zamówienia, np. update_meta_data, i zatwierdzać je metodą save, a złożone wyszukiwania prowadzić przez zapytania zamówień WooCommerce. Zgodność deklaruje się w głównym pliku wtyczki wywołaniem FeaturesUtil::declare_compatibility dla funkcji custom_order_tables, podpiętym pod akcję before_woocommerce_init (stan na październik 2026 - sprawdź aktualną dokumentację WooCommerce).
Koszyk i kasa w blokach
Według dokumentacji WooCommerce w sklepach uruchomionych po wydaniu WooCommerce 8.3 w listopadzie 2023 r. bloki koszyka i kasy są domyślnym rozwiązaniem. Klasyczne filtry pól w kasie, takie jak woocommerce_checkout_fields, nie sterują blokowym checkoutem - do dodawania pól służy Additional Checkout Fields API. WooCommerce uprzedza też, że niezgodne rozszerzenia mogą powodować brak elementów w kasie, a bramka płatności bez wsparcia bloków może nie pojawić się wśród metod płatności. Wtyczka, która dotyka koszyka lub kasy, musi być testowana na tej wersji kasy, której sklep faktycznie używa.
[#uwaga] Nie korzystaj w wtyczce z kodu WooCommerce oznaczonego jako wewnętrzny - z przestrzeni nazw Automattic\WooCommerce\Internal ani z elementów oznaczonych @internal. Dokumentacja podaje, że nie ma dla niego gwarancji zgodności wstecznej i może zmienić się w dowolnym wydaniu.
Bezpieczeństwo wtyczki WooCommerce - zasady z dokumentacji
Dokumentacja WordPressa każe traktować wszystkie dane jako niezaufane: od użytkownika, z zewnętrznych API, a nawet z własnej bazy. Wynikają z tego cztery podstawowe zasady, które warto wpisać do kryteriów odbioru wtyczki:
Uprawnienia - każda operacja zmieniająca dane sprawdza uprawnienia użytkownika funkcją current_user_can. Samo is_admin nie oznacza, że użytkownik jest administratorem.
Nonce - formularze i żądania AJAX zawierają token nonce, weryfikowany np. przez check_admin_referer lub check_ajax_referer. Dokumentacja podkreśla, że nonce nigdy nie zastępuje sprawdzenia uprawnień.
Walidacja i sanityzacja wejścia - dane od użytkownika są sprawdzane, a niepoprawne odrzucane. Odrzucenie jest według dokumentacji lepsze niż samo oczyszczenie.
Escapowanie wyjścia - dane wyświetlane na stronie są zabezpieczane jak najpóźniej, tuż przed wyświetleniem.
Do tego dochodzą zasady organizacyjne z dokumentacji wtyczek: unikalny prefiks lub przestrzeń nazw dla funkcji, klas, opcji i danych tymczasowych, blokada bezpośredniego wywołania plików przez sprawdzenie stałej ABSPATH oraz ładowanie kodu panelu tylko w panelu. Poniżej najczęstsze błędy bezpieczeństwa w kodzie wtyczek i sposób ich naprawy:
[#chart:wpr95b]
Struktura wtyczki i dobre praktyki WooCommerce
Wytyczne WooCommerce dla rozszerzeń i dokumentacja wtyczek WordPressa zawierają listę praktyk, które ułatwiają utrzymanie. Najważniejsze zebraliśmy w tabeli.
| Obszar | Zalecenie z dokumentacji |
|---|---|
| Pliki | W katalogu głównym tylko plik główny i ewentualnie uninstall.php, reszta w podkatalogach |
| Zależności | Sprawdzenie, czy WooCommerce jest aktywny, nagłówek Requires Plugins |
| Dane | Unikanie własnych tabel, gdy wystarczą typy wpisów, taksonomie i opcje |
| Dane z zewnętrznych API | Cache w transients zamiast zapytania przy każdym wyświetleniu |
| Logi | Klasa WC_Logger, logowanie włączane przez sprzedawcę |
| Tłumaczenia | Text domain zgodny z nazwą katalogu wtyczki |
| Kod | Rozdzielenie logiki biznesowej i prezentacji, brak nieużywanego kodu, testy z włączonym WP_DEBUG |
Logi i diagnoza błędów
Wtyczka, która wymienia dane z innymi systemami, prędzej czy później trafi na błąd: brak odpowiedzi usługi, niepoprawne dane w zamówieniu, wygasły klucz. Wytyczne WooCommerce zalecają logowanie przez klasę WC_Logger, dzięki czemu sprzedawca widzi wpisy w statusie systemu WooCommerce, a samo logowanie ma być opcją, którą sprzedawca włącza. W praktyce warto zapisywać identyfikator zamówienia, rodzaj operacji i treść błędu, ale nie pełne dane osobowe klientów. Dobry log pozwala odpowiedzieć na pytanie, co stało się z konkretnym zamówieniem, bez zgadywania i bez dostępu programisty do bazy danych sklepu. Przy krytycznych błędach, np. gdy zamówienia przestają trafiać do magazynu, log warto uzupełnić powiadomieniem e-mail do osoby odpowiedzialnej.
Dezaktywacja i odinstalowanie
Dokumentacja WordPressa rozdziela te dwa etapy. Przy dezaktywacji wtyczka czyści dane tymczasowe i pamięć podręczną, ale nie usuwa ustawień. Opcje i własne tabele usuwa się dopiero przy odinstalowaniu, w pliku uninstall.php albo funkcją register_uninstall_hook. Plik uninstall.php powinien na początku sprawdzić stałą WP_UNINSTALL_PLUGIN. Dzięki temu chwilowe wyłączenie wtyczki przy diagnozie problemu nie kasuje konfiguracji sklepu.
Wydajność wtyczki WooCommerce na zamówienie
Wtyczka działa przy każdym wyświetleniu strony, więc nawet drobny błąd wydajnościowy mnoży się przez cały ruch sklepu. Najczęstsze źródła spowolnień to zapytania do bazy wykonywane na każdej podstronie, połączenia z zewnętrznym API w trakcie ładowania strony i skrypty ładowane wszędzie, choć potrzebne w jednym miejscu. Wytyczne WooCommerce zalecają przechowywanie danych z zewnętrznych usług w transients, czyli pamięci tymczasowej WordPressa, zamiast pobierania ich przy każdym wyświetleniu.
Ładowanie warunkowe - kod panelu tylko w panelu, skrypty i style tylko na podstronach, które ich używają.
Zadania w tle - eksporty, synchronizacje i wysyłka danych do innych systemów poza procesem składania zamówienia. WooCommerce zawiera bibliotekę Action Scheduler, z której korzystają rozszerzenia do zadań wykonywanych w tle.
Ostrożność z koszykiem - kod podpięty pod liczenie koszyka uruchamia się wielokrotnie, więc nie powinien wykonywać ciężkich operacji.
Pomiar przed i po - czas odpowiedzi karty produktu, koszyka i kasy sprawdzony przed wdrożeniem wtyczki i po nim.
Przykłady wtyczek WooCommerce na zamówienie
Żeby łatwiej przełożyć potrzebę na zakres prac, poniżej kilka typowych zleceń i elementów, z których się składają:
Reguła dostawy zależna od produktów w koszyku - filtr metod dostawy, który ukrywa lub zmienia metodę dla gabarytów, z ustawieniami w panelu.
Dodatkowe pole w zamówieniu - pole w kasie przez Additional Checkout Fields API, zapis w metadanych zamówienia zgodny z HPOS i wyświetlenie w panelu oraz w e-mailu.
Przekazanie zamówienia do magazynu - akcja przy zmianie statusu dodaje zadanie w tle, które wysyła dane i zapisuje odpowiedź w notatce zamówienia.
Raport dla zespołu - strona w panelu dostępna tylko dla ról z uprawnieniem, z danymi pobranymi przez obiekty i zapytania WooCommerce.
[#checklista] Odbiór wtyczki od programisty: 1) kod w repozytorium z historią zmian, 2) zmiany przez hooki, bez edycji WooCommerce, motywu i cudzych wtyczek, 3) deklaracja zgodności z HPOS i test z włączonym HPOS, 4) test w kasie, której używa sklep - blokowej lub klasycznej, 5) sprawdzenie uprawnień, nonce, walidacji i escapowania, 6) brak błędów i ostrzeżeń przy WP_DEBUG, 7) opis ustawień, hooków i sposobu odinstalowania.
Utrzymanie wtyczki na zamówienie po wdrożeniu
Wtyczka napisana raz nie jest gotowa na zawsze. WordPress, WooCommerce i PHP wydają nowe wersje, a sklep dokłada kolejne dodatki. Wytyczne WooCommerce polecają narzędzie Quality Insights Toolkit (QIT), które testuje rozszerzenie z nowymi wersjami PHP, WordPressa i WooCommerce oraz z innymi aktywnymi rozszerzeniami. Niezależnie od narzędzi warto ustalić stały rytm przeglądów, np. po każdym większym wydaniu WooCommerce, i osobę, która decyduje o wdrożeniu aktualizacji na sklep. Bez takiej osoby aktualizacje są odkładane, aż sklep zostaje na starych wersjach z lukami w zabezpieczeniach. Proces wydawania zmian warto ułożyć tak:
[#chart:wpr95c]
Każdą zmianę w kodzie wtyczki i każdą aktualizację WooCommerce sprawdza się na kopii sklepu przed wdrożeniem. Jak przeprowadzić takie testy krok po kroku, opisujemy we wpisie aktualizacje wtyczek WooCommerce - jak testować bez ryzyka.
Kod wtyczki w repozytorium z historią zmian i plikiem changelog.
Numer wersji podnoszony przy każdym wydaniu, z opisem zmian.
Nagłówki z minimalną wersją WordPressa, PHP i WooCommerce aktualizowane po testach.
Dokumentacja hooków i ustawień, żeby kolejny programista mógł przejąć kod.
Wtyczka czy integracja przez REST API
Nie każda funkcja musi działać wewnątrz sklepu. Gdy zadaniem jest wymiana danych z ERP, magazynem czy hurtownią, często lepiej napisać zewnętrzną usługę korzystającą z REST API i webhooków WooCommerce, a w sklepie zostawić tylko niewielką wtyczkę z hookami. Taki podział zmniejsza obciążenie serwera sklepu i ryzyko, że błąd integracji zatrzyma kasę. Szczegóły opisujemy w artykule WooCommerce REST API - jak pobierać zamówienia i aktualizować ceny.
Jak zlecić wtyczkę WooCommerce na zamówienie
Dobre zlecenie opisuje cel w języku biznesu, ale zawiera też wymagania, które później ułatwią odbiór i utrzymanie. Warto, żeby znalazły się w nim co najmniej:
Opis funkcji z przykładami: kto, kiedy i w jakiej sytuacji z niej korzysta.
Wersje WordPressa, WooCommerce i PHP używane w sklepie oraz informacja, czy kasa działa na blokach, czy na klasycznym szablonie.
Lista wtyczek, z którymi nowy kod musi współpracować, np. płatności, wysyłek i integracji.
Wymagania bezpieczeństwa i zgodności z HPOS jako kryteria odbioru.
Ustalenia dotyczące kodu źródłowego, dokumentacji i utrzymania po wdrożeniu.
Jeśli wtyczka zmienia wygląd elementów sklepu, warto też ustalić, czy jej szablony mają dać się nadpisać w motywie. Wytyczne WooCommerce zalecają taki system szablonów, bo pozwala zmienić wygląd bez edycji kodu wtyczki, a aktualizacja wtyczki nie kasuje zmian wprowadzonych w motywie.
Jak Vinson pomaga przy wtyczkach WooCommerce na zamówienie
Zapewniamy wsparcie programistyczne dla sklepów i sprzedawców: integracje, automatyzacje, poprawki i rozwój sklepów oraz narzędzi. Piszemy wtyczki WooCommerce oparte na hookach, zgodne z HPOS i blokowym koszykiem, z kontrolą uprawnień, nonce i escapowaniem danych. Przejmujemy też istniejące wtyczki: robimy przegląd kodu, porządkujemy modyfikacje rozrzucone po motywie i ustawiamy proces testów przed aktualizacjami. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.
Najczęściej zadawane pytania
Czym różni się akcja od filtra w WooCommerce?
Akcja uruchamia kod w określonym momencie, np. po zmianie statusu zamówienia, i nie zwraca wartości. Filtr przyjmuje wartość, np. cenę lub tekst, zmienia ją i zwraca. Akcje podpina się funkcją add_action, filtry funkcją add_filter.
Czy można wkleić kod do functions.php zamiast pisać wtyczkę?
Można, ale kod w pliku motywu przestaje działać po zmianie motywu, a w motywie bez motywu potomnego znika przy aktualizacji. Zmiany w działaniu sklepu lepiej trzymać w osobnej wtyczce, którą da się wersjonować, wyłączyć i przekazać innemu programiście.
Jak sprawdzić, czy wtyczka jest zgodna z HPOS?
Sprawdź, czy wtyczka deklaruje zgodność z funkcją custom_order_tables i czy pobiera zamówienia przez wc_get_order oraz metody obiektu zamówienia, a nie przez funkcje wpisów WordPressa. Ostatecznym testem jest sprawdzenie działania na kopii sklepu z włączonym HPOS.
Jakie zabezpieczenia powinna mieć wtyczka WooCommerce?
Sprawdzanie uprawnień funkcją current_user_can przy każdej zmianie danych, tokeny nonce w formularzach i żądaniach AJAX, walidację danych wejściowych i escapowanie danych wyświetlanych na stronie. Do tego blokadę bezpośredniego wywołania plików i unikalny prefiks dla funkcji i opcji.
Do kogo należy kod wtyczki napisanej na zamówienie?
To zależy od umowy z programistą. Przed rozpoczęciem prac warto ustalić przeniesienie praw lub licencję, przekazanie kodu źródłowego w repozytorium i dokumentacji. Szczegóły zapisów umownych najlepiej skonsultować z prawnikiem.
Wtyczka WooCommerce na zamówienie jest tak dobra, jak jej zgodność z zasadami platformy i plan utrzymania. Jeśli potrzebujesz nowej wtyczki albo przeglądu obecnego kodu, sprawdź wsparcie programistyczne Vinson.
HPOS i blokowy koszyk - zgodność wtyczki z nowym WooCommerce
Zgodność z HPOS
Wydajne przechowywanie zamówień (HPOS) trzyma zamówienia we własnych tabelach zamiast w tabelach wpisów WordPressa. Wtyczka, która odczytuje zamówienia przez get_post albo zapisuje dane funkcją update_post_meta, przestaje działać poprawnie. Dokumentacja WooCommerce każe pobierać zamówienie przez wc_get_order, zapisywać metadane metodami obiektu zamówienia, np. update_meta_data, i zatwierdzać je metodą save, a złożone wyszukiwania prowadzić przez zapytania zamówień WooCommerce. Zgodność deklaruje się w głównym pliku wtyczki wywołaniem FeaturesUtil::declare_compatibility dla funkcji custom_order_tables, podpiętym pod akcję before_woocommerce_init (stan na październik 2026 - sprawdź aktualną dokumentację WooCommerce).
Koszyk i kasa w blokach
Według dokumentacji WooCommerce w sklepach uruchomionych po wydaniu WooCommerce 8.3 w listopadzie 2023 r. bloki koszyka i kasy są domyślnym rozwiązaniem. Klasyczne filtry pól w kasie, takie jak woocommerce_checkout_fields, nie sterują blokowym checkoutem - do dodawania pól służy Additional Checkout Fields API. WooCommerce uprzedza też, że niezgodne rozszerzenia mogą powodować brak elementów w kasie, a bramka płatności bez wsparcia bloków może nie pojawić się wśród metod płatności. Wtyczka, która dotyka koszyka lub kasy, musi być testowana na tej wersji kasy, której sklep faktycznie używa.
[#uwaga] Nie korzystaj w wtyczce z kodu WooCommerce oznaczonego jako wewnętrzny - z przestrzeni nazw Automattic\WooCommerce\Internal ani z elementów oznaczonych @internal. Dokumentacja podaje, że nie ma dla niego gwarancji zgodności wstecznej i może zmienić się w dowolnym wydaniu.
Bezpieczeństwo wtyczki WooCommerce - zasady z dokumentacji
Dokumentacja WordPressa każe traktować wszystkie dane jako niezaufane: od użytkownika, z zewnętrznych API, a nawet z własnej bazy. Wynikają z tego cztery podstawowe zasady, które warto wpisać do kryteriów odbioru wtyczki:
Uprawnienia - każda operacja zmieniająca dane sprawdza uprawnienia użytkownika funkcją current_user_can. Samo is_admin nie oznacza, że użytkownik jest administratorem.
Nonce - formularze i żądania AJAX zawierają token nonce, weryfikowany np. przez check_admin_referer lub check_ajax_referer. Dokumentacja podkreśla, że nonce nigdy nie zastępuje sprawdzenia uprawnień.
Walidacja i sanityzacja wejścia - dane od użytkownika są sprawdzane, a niepoprawne odrzucane. Odrzucenie jest według dokumentacji lepsze niż samo oczyszczenie.
Escapowanie wyjścia - dane wyświetlane na stronie są zabezpieczane jak najpóźniej, tuż przed wyświetleniem.
Do tego dochodzą zasady organizacyjne z dokumentacji wtyczek: unikalny prefiks lub przestrzeń nazw dla funkcji, klas, opcji i danych tymczasowych, blokada bezpośredniego wywołania plików przez sprawdzenie stałej ABSPATH oraz ładowanie kodu panelu tylko w panelu. Poniżej najczęstsze błędy bezpieczeństwa w kodzie wtyczek i sposób ich naprawy:
[#chart:wpr95b]
Struktura wtyczki i dobre praktyki WooCommerce
Wytyczne WooCommerce dla rozszerzeń i dokumentacja wtyczek WordPressa zawierają listę praktyk, które ułatwiają utrzymanie. Najważniejsze zebraliśmy w tabeli.
| Obszar | Zalecenie z dokumentacji |
|---|---|
| Pliki | W katalogu głównym tylko plik główny i ewentualnie uninstall.php, reszta w podkatalogach |
| Zależności | Sprawdzenie, czy WooCommerce jest aktywny, nagłówek Requires Plugins |
| Dane | Unikanie własnych tabel, gdy wystarczą typy wpisów, taksonomie i opcje |
| Dane z zewnętrznych API | Cache w transients zamiast zapytania przy każdym wyświetleniu |
| Logi | Klasa WC_Logger, logowanie włączane przez sprzedawcę |
| Tłumaczenia | Text domain zgodny z nazwą katalogu wtyczki |
| Kod | Rozdzielenie logiki biznesowej i prezentacji, brak nieużywanego kodu, testy z włączonym WP_DEBUG |
Logi i diagnoza błędów
Wtyczka, która wymienia dane z innymi systemami, prędzej czy później trafi na błąd: brak odpowiedzi usługi, niepoprawne dane w zamówieniu, wygasły klucz. Wytyczne WooCommerce zalecają logowanie przez klasę WC_Logger, dzięki czemu sprzedawca widzi wpisy w statusie systemu WooCommerce, a samo logowanie ma być opcją, którą sprzedawca włącza. W praktyce warto zapisywać identyfikator zamówienia, rodzaj operacji i treść błędu, ale nie pełne dane osobowe klientów. Dobry log pozwala odpowiedzieć na pytanie, co stało się z konkretnym zamówieniem, bez zgadywania i bez dostępu programisty do bazy danych sklepu. Przy krytycznych błędach, np. gdy zamówienia przestają trafiać do magazynu, log warto uzupełnić powiadomieniem e-mail do osoby odpowiedzialnej.
Dezaktywacja i odinstalowanie
Dokumentacja WordPressa rozdziela te dwa etapy. Przy dezaktywacji wtyczka czyści dane tymczasowe i pamięć podręczną, ale nie usuwa ustawień. Opcje i własne tabele usuwa się dopiero przy odinstalowaniu, w pliku uninstall.php albo funkcją register_uninstall_hook. Plik uninstall.php powinien na początku sprawdzić stałą WP_UNINSTALL_PLUGIN. Dzięki temu chwilowe wyłączenie wtyczki przy diagnozie problemu nie kasuje konfiguracji sklepu.
Wydajność wtyczki WooCommerce na zamówienie
Wtyczka działa przy każdym wyświetleniu strony, więc nawet drobny błąd wydajnościowy mnoży się przez cały ruch sklepu. Najczęstsze źródła spowolnień to zapytania do bazy wykonywane na każdej podstronie, połączenia z zewnętrznym API w trakcie ładowania strony i skrypty ładowane wszędzie, choć potrzebne w jednym miejscu. Wytyczne WooCommerce zalecają przechowywanie danych z zewnętrznych usług w transients, czyli pamięci tymczasowej WordPressa, zamiast pobierania ich przy każdym wyświetleniu.
Ładowanie warunkowe - kod panelu tylko w panelu, skrypty i style tylko na podstronach, które ich używają.
Zadania w tle - eksporty, synchronizacje i wysyłka danych do innych systemów poza procesem składania zamówienia. WooCommerce zawiera bibliotekę Action Scheduler, z której korzystają rozszerzenia do zadań wykonywanych w tle.
Ostrożność z koszykiem - kod podpięty pod liczenie koszyka uruchamia się wielokrotnie, więc nie powinien wykonywać ciężkich operacji.
Pomiar przed i po - czas odpowiedzi karty produktu, koszyka i kasy sprawdzony przed wdrożeniem wtyczki i po nim.
Przykłady wtyczek WooCommerce na zamówienie
Żeby łatwiej przełożyć potrzebę na zakres prac, poniżej kilka typowych zleceń i elementów, z których się składają:
Reguła dostawy zależna od produktów w koszyku - filtr metod dostawy, który ukrywa lub zmienia metodę dla gabarytów, z ustawieniami w panelu.
Dodatkowe pole w zamówieniu - pole w kasie przez Additional Checkout Fields API, zapis w metadanych zamówienia zgodny z HPOS i wyświetlenie w panelu oraz w e-mailu.
Przekazanie zamówienia do magazynu - akcja przy zmianie statusu dodaje zadanie w tle, które wysyła dane i zapisuje odpowiedź w notatce zamówienia.
Raport dla zespołu - strona w panelu dostępna tylko dla ról z uprawnieniem, z danymi pobranymi przez obiekty i zapytania WooCommerce.
[#checklista] Odbiór wtyczki od programisty: 1) kod w repozytorium z historią zmian, 2) zmiany przez hooki, bez edycji WooCommerce, motywu i cudzych wtyczek, 3) deklaracja zgodności z HPOS i test z włączonym HPOS, 4) test w kasie, której używa sklep - blokowej lub klasycznej, 5) sprawdzenie uprawnień, nonce, walidacji i escapowania, 6) brak błędów i ostrzeżeń przy WP_DEBUG, 7) opis ustawień, hooków i sposobu odinstalowania.
Utrzymanie wtyczki na zamówienie po wdrożeniu
Wtyczka napisana raz nie jest gotowa na zawsze. WordPress, WooCommerce i PHP wydają nowe wersje, a sklep dokłada kolejne dodatki. Wytyczne WooCommerce polecają narzędzie Quality Insights Toolkit (QIT), które testuje rozszerzenie z nowymi wersjami PHP, WordPressa i WooCommerce oraz z innymi aktywnymi rozszerzeniami. Niezależnie od narzędzi warto ustalić stały rytm przeglądów, np. po każdym większym wydaniu WooCommerce, i osobę, która decyduje o wdrożeniu aktualizacji na sklep. Bez takiej osoby aktualizacje są odkładane, aż sklep zostaje na starych wersjach z lukami w zabezpieczeniach. Proces wydawania zmian warto ułożyć tak:
[#chart:wpr95c]
Każdą zmianę w kodzie wtyczki i każdą aktualizację WooCommerce sprawdza się na kopii sklepu przed wdrożeniem. Jak przeprowadzić takie testy krok po kroku, opisujemy we wpisie aktualizacje wtyczek WooCommerce - jak testować bez ryzyka.
Kod wtyczki w repozytorium z historią zmian i plikiem changelog.
Numer wersji podnoszony przy każdym wydaniu, z opisem zmian.
Nagłówki z minimalną wersją WordPressa, PHP i WooCommerce aktualizowane po testach.
Dokumentacja hooków i ustawień, żeby kolejny programista mógł przejąć kod.
Wtyczka czy integracja przez REST API
Nie każda funkcja musi działać wewnątrz sklepu. Gdy zadaniem jest wymiana danych z ERP, magazynem czy hurtownią, często lepiej napisać zewnętrzną usługę korzystającą z REST API i webhooków WooCommerce, a w sklepie zostawić tylko niewielką wtyczkę z hookami. Taki podział zmniejsza obciążenie serwera sklepu i ryzyko, że błąd integracji zatrzyma kasę. Szczegóły opisujemy w artykule WooCommerce REST API - jak pobierać zamówienia i aktualizować ceny.
Jak zlecić wtyczkę WooCommerce na zamówienie
Dobre zlecenie opisuje cel w języku biznesu, ale zawiera też wymagania, które później ułatwią odbiór i utrzymanie. Warto, żeby znalazły się w nim co najmniej:
Opis funkcji z przykładami: kto, kiedy i w jakiej sytuacji z niej korzysta.
Wersje WordPressa, WooCommerce i PHP używane w sklepie oraz informacja, czy kasa działa na blokach, czy na klasycznym szablonie.
Lista wtyczek, z którymi nowy kod musi współpracować, np. płatności, wysyłek i integracji.
Wymagania bezpieczeństwa i zgodności z HPOS jako kryteria odbioru.
Ustalenia dotyczące kodu źródłowego, dokumentacji i utrzymania po wdrożeniu.
Jeśli wtyczka zmienia wygląd elementów sklepu, warto też ustalić, czy jej szablony mają dać się nadpisać w motywie. Wytyczne WooCommerce zalecają taki system szablonów, bo pozwala zmienić wygląd bez edycji kodu wtyczki, a aktualizacja wtyczki nie kasuje zmian wprowadzonych w motywie.
Jak Vinson pomaga przy wtyczkach WooCommerce na zamówienie
Zapewniamy wsparcie programistyczne dla sklepów i sprzedawców: integracje, automatyzacje, poprawki i rozwój sklepów oraz narzędzi. Piszemy wtyczki WooCommerce oparte na hookach, zgodne z HPOS i blokowym koszykiem, z kontrolą uprawnień, nonce i escapowaniem danych. Przejmujemy też istniejące wtyczki: robimy przegląd kodu, porządkujemy modyfikacje rozrzucone po motywie i ustawiamy proces testów przed aktualizacjami. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.
Najczęściej zadawane pytania
Czym różni się akcja od filtra w WooCommerce?
Akcja uruchamia kod w określonym momencie, np. po zmianie statusu zamówienia, i nie zwraca wartości. Filtr przyjmuje wartość, np. cenę lub tekst, zmienia ją i zwraca. Akcje podpina się funkcją add_action, filtry funkcją add_filter.
Czy można wkleić kod do functions.php zamiast pisać wtyczkę?
Można, ale kod w pliku motywu przestaje działać po zmianie motywu, a w motywie bez motywu potomnego znika przy aktualizacji. Zmiany w działaniu sklepu lepiej trzymać w osobnej wtyczce, którą da się wersjonować, wyłączyć i przekazać innemu programiście.
Jak sprawdzić, czy wtyczka jest zgodna z HPOS?
Sprawdź, czy wtyczka deklaruje zgodność z funkcją custom_order_tables i czy pobiera zamówienia przez wc_get_order oraz metody obiektu zamówienia, a nie przez funkcje wpisów WordPressa. Ostatecznym testem jest sprawdzenie działania na kopii sklepu z włączonym HPOS.
Jakie zabezpieczenia powinna mieć wtyczka WooCommerce?
Sprawdzanie uprawnień funkcją current_user_can przy każdej zmianie danych, tokeny nonce w formularzach i żądaniach AJAX, walidację danych wejściowych i escapowanie danych wyświetlanych na stronie. Do tego blokadę bezpośredniego wywołania plików i unikalny prefiks dla funkcji i opcji.
Do kogo należy kod wtyczki napisanej na zamówienie?
To zależy od umowy z programistą. Przed rozpoczęciem prac warto ustalić przeniesienie praw lub licencję, przekazanie kodu źródłowego w repozytorium i dokumentacji. Szczegóły zapisów umownych najlepiej skonsultować z prawnikiem.
Wtyczka WooCommerce na zamówienie jest tak dobra, jak jej zgodność z zasadami platformy i plan utrzymania. Jeśli potrzebujesz nowej wtyczki albo przeglądu obecnego kodu, sprawdź wsparcie programistyczne Vinson.


Łukasz Palej
Technical Implementation Expert
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Wsparcie programistyczne dla e-commerce
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
Napisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Łukasz Palej, Technical Implementation ExpertNapisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Łukasz Palej, Technical Implementation Expert