WooCommerce od zera — konfiguracja sklepu, płatności i wysyłki krok po kroku

W tym artykule przeprowadzę Cię przez konfigurację sklepu od zera do działającego MVP.

Zanim zaczniesz konfigurację WooCommerce

WooCommerce nie jest tylko katalogiem produktów. To proces sprzedaży: produkt, koszyk, checkout, płatność, wysyłka, wiadomości transakcyjne, dokumenty i obsługa zwrotów. Dlatego przed instalacją warto ustalić minimum:

• czy sklep sprzedaje tylko w Polsce, czy także za granicę,
• czy ceny w panelu będą wpisywane brutto czy netto,
• jakie produkty mają inne stawki VAT,
• jakie metody dostawy będą dostępne dla różnych krajów i koszyków,
• jakie płatności mają być dostępne w pierwszej wersji,
• czy sklep będzie używał klasycznego checkoutu, czy bloków Cart/Checkout.

Instalacja WooCommerce krok po kroku

WooCommerce to wtyczka WordPress i instalujesz ją standardowo:

Panel WP → Wtyczki → Dodaj nową → Szukaj "WooCommerce" → Zainstaluj → Aktywuj

Po aktywacji uruchamia się kreator, który możesz pominąć. Pokażę konfigurację manualną, która daje więcej kontroli nad całością.

Struktura WooCommerce po instalacji

Po instalacji pojawią się:

wp-content/
├── plugins/
│   └── woocommerce/           # Rdzeń wtyczki
└── uploads/
    └── woocommerce_uploads/   # Pliki do pobrania, logi

Oraz nowe strony:

Podstawowe ustawienia sklepu WooCommerce

Wszystko w: WooCommerce → Ustawienia

Zakładka Ogólne w WooCommerce

Adres sklepu:
├── Kraj: Polska
├── Województwo: (domyślne dla wysyłki)
└── Lokalizacje sprzedaży: Sprzedaż do wszystkich krajów
                           lub: Sprzedaż do wybranych krajów

Opcje walutowe:
├── Waluta: Polski złoty (zł)
├── Pozycja waluty: Prawo ze spacją (100 zł)
├── Separator tysięcy: (spacja)
└── Separator dziesiętny: ,

Zakładka Produkty w WooCommerce

Strony sklepu:
├── Strona sklepu: Sklep (stworzona automatycznie)
└── Przekierowanie do koszyka: ❌ (lepszy UX bez przekierowania)

Wymiary:
├── Jednostka wagi: kg
└── Jednostka wymiarów: cm

Recenzje:
├── Włącz recenzje: ✓
├── Tylko zweryfikowani: ✓ (kupili produkt)
└── Oceny gwiazdkowe: ✓

Jeśli sprzedajesz produkty fizyczne, od razu włącz też zarządzanie stanem magazynowym. Dla małego sklepu wystarczy prosty model:

Magazyn:
├── Włącz zarządzanie stanem magazynowym: ✓
├── Wstrzymaj stan magazynowy: 60 minut
├── Powiadomienia o niskim stanie: ✓
├── Próg niskiego stanu: np. 3
└── Ukrywaj produkty niedostępne: zależnie od strategii sprzedaży

To jest ważne przy płatnościach online: klient może przejść do bramki, porzucić płatność albo wrócić po kilku minutach, więc sklep musi wiedzieć, jak długo rezerwuje produkt w koszyku.

Zakładka Podatki w WooCommerce

Podatki najpierw włączasz w ustawieniach ogólnych:

WooCommerce → Ustawienia → Ogólne
└── Włącz stawki podatkowe i obliczenia: ✓

Dopiero wtedy pojawi się zakładka Podatki. Najważniejsza decyzja to sposób wpisywania cen:

Ceny z podatkiem:
├── "Tak, będę wprowadzać ceny z podatkiem"
├── Wyświetlaj ceny w sklepie: "Z podatkiem"
└── Wyświetlaj ceny w koszyku i zamówieniu: "Z podatkiem"

W polskim B2C najczęściej wpisujesz i pokazujesz ceny brutto. Przy B2B lub sprzedaży międzynarodowej możesz potrzebować cen netto, ale wtedy ustawienia muszą być spójne w całym sklepie.

Przykładowa struktura dla Polski:

Klasy podatkowe:
├── Standard rate: 23% VAT
├── Reduced rate: 8% VAT
└── Reduced rate / custom class: 5% VAT

Sprawdź też podatek dla wysyłki:

Klasa podatkowa wysyłki:
├── Na podstawie produktów w koszyku (domyślnie)
└── albo konkretna klasa, jeśli księgowość tego wymaga

Zakładka Wysyłka w WooCommerce

Strefy wysyłki:
├── Polska
│   ├── Kurier: 15 zł (stała stawka)
│   ├── Paczkomat: 12 zł
│   └── Darmowa wysyłka: powyżej 200 zł
└── Europa
    └── Kurier międzynarodowy: 50 zł

Wysyłkę konfiguruj od najprostszych reguł:

1. Dodaj strefę Polska.
2. Dodaj metody: stała stawka, darmowa wysyłka, odbiór osobisty lub integracja z przewoźnikiem.
3. Dodaj osobną strefę dla krajów, do których realnie wysyłasz.
4. Na końcu ustaw Lokalizacje nieobjęte innymi strefami albo zostaw je bez metod, jeśli nie chcesz przypadkowej sprzedaży do nieobsługiwanych krajów.

Dla produktów o różnych gabarytach dodaj klasy wysyłkowe:

WooCommerce → Ustawienia → Wysyłka → Klasy wysyłkowe
├── Mała paczka
├── Produkt ciężki
└── Produkt ponadgabarytowy

Potem przypisz klasę do produktu w sekcji Dane produktu → Wysyłka. Dzięki temu zwykła koszulka może kosztować 12 zł dostawy, a ciężki sprzęt 60 zł.

Dla polskiego sklepu praktycznie zawsze sprawdź integrację z operatorem dostawy: InPost, DPD, DHL, Orlen Paczka, Furgonetka, Apaczka albo BaseLinker. Sama metoda "Paczkomat: 12 zł" pokaże koszt w koszyku, ale nie wygeneruje etykiety, nie obsłuży wyboru punktu odbioru i nie wyśle numeru śledzenia bez dodatkowej integracji.

Zakładka Płatności w WooCommerce

Wbudowane metody:

Dla płatności online potrzebujesz bramki płatności:

• Przelewy24 — BLIK, szybkie przelewy, karty i portfele zależnie od konta,
• PayU — BLIK, przelewy, karty, raty i portfele zależnie od konta,
• Stripe / WooPayments — karty, portfele i wybrane lokalne metody, dobre przy sprzedaży międzynarodowej,
• PayPal — często jako opcja dodatkowa dla klientów zagranicznych.

// Przykład: Po instalacji wtyczki Przelewy24
WooCommerce → Ustawienia → Płatności → Przelewy24
├── Włącz: ✓
├── ID sprzedawcy: XXXXX
├── CRC: YYYYY
└── Tryb testowy: ✓ (na start)

Przed produkcją przetestuj minimum:

Po testach przełącz bramkę z sandboxu na produkcję, podmień dane dostępowe i wykonaj prawdziwą płatność niską kwotą. Dopiero wtedy masz pewność, że produkcyjne konto, przekierowania, webhooki i statusy działają razem.

Produkty w WooCommerce: typy i konfiguracja

WooCommerce obsługuje różne typy produktów:

Produkt prosty w WooCommerce

Tytuł: Koszulka Basic
Opis: Bawełniana koszulka...
Cena regularna: 79 zł
Cena promocyjna: 59 zł (opcjonalnie)

Dane produktu:
├── Ogólne: Ceny
├── Magazyn: SKU, stan magazynowy
├── Wysyłka: Waga, wymiary
├── Powiązane: Upsells, cross-sells
└── Zaawansowane: Notatka, kolejność menu

Produkt z wariantami w WooCommerce

Tytuł: Koszulka Basic
Atrybuty:
├── Rozmiar: S, M, L, XL (używane do wariantów: ✓)
└── Kolor: Czarny, Biały, Szary (używane do wariantów: ✓)

Warianty (generowane automatycznie):
├── S/Czarny: 79 zł, SKU: KB-S-BLK
├── S/Biały: 79 zł, SKU: KB-S-WHT
├── M/Czarny: 79 zł, SKU: KB-M-BLK
└── ...

Produkt wirtualny i cyfrowy

Tytuł: E-book "Frontend dla początkujących"
Wirtualny: ✓ (brak wysyłki)
Do pobrania: ✓

Pliki do pobrania:
├── Nazwa: E-book PDF
└── URL: /wp-content/uploads/woocommerce_uploads/ebook.pdf

Limit pobrań: 3
Wygaśnięcie: 30 dni

Produkt zewnętrzny lub afiliacyjny

Tytuł: Laptop XYZ
URL produktu: https://partner.pl/laptop-xyz
Tekst przycisku: "Kup na Partner.pl"
Cena: 3499 zł

Produkt grupowany w WooCommerce

Zestaw kilku osobnych produktów wyświetlanych na jednej stronie, a klient dodaje je do koszyka indywidualnie.

Tytuł: Zestaw kuchenny
Produkty w zestawie:
├── Nóż szefa kuchni (osobny produkt prosty)
├── Deska do krojenia (osobny produkt prosty)
└── Ostrzałka (osobny produkt prosty)

Każdy produkt w zestawie ma własną cenę i SKU, ale produkt grupowany sam w sobie nie ma ceny.

REST API, Store API i headless WooCommerce

WooCommerce ma dwa ważne typy API, które łatwo pomylić:

• REST API WooCommerce — dobre do integracji administracyjnych, synchronizacji produktów, ERP, PIM, księgowości i zamówień po stronie serwera.
• Store API — przeznaczone do funkcji sklepowych po stronie klienta: katalogu, koszyka, checkoutu i bloków WooCommerce.

Jeśli budujesz zwykły sklep na WordPressie, możesz ten rozdział potraktować jako zaawansowany. Jeśli budujesz frontend w React albo Next.js, rozróżnienie jest krytyczne.

Włączenie API w WooCommerce

WooCommerce → Ustawienia → Zaawansowane → REST API → Dodaj klucz
├── Opis: Integracja ERP / backend
├── Użytkownik: konto techniczne lub administrator
└── Uprawnienia: tylko taki zakres, jaki jest potrzebny

Otrzymujesz:

• Consumer Key: ck_xxxxx
• Consumer Secret: cs_xxxxx

Przykłady zapytań do WooCommerce API

// lib/woocommerce.ts
const WOO_URL = 'https://twojsklep.pl/wp-json/wc/v3'
const CONSUMER_KEY = process.env.WC_CONSUMER_KEY
const CONSUMER_SECRET = process.env.WC_CONSUMER_SECRET
 
async function wooFetch(endpoint: string) {
  if (!CONSUMER_KEY || !CONSUMER_SECRET) {
    throw new Error('Missing WooCommerce API credentials')
  }
 
  const credentials = Buffer.from(
    `${CONSUMER_KEY}:${CONSUMER_SECRET}`,
  ).toString('base64')
 
  const response = await fetch(`${WOO_URL}${endpoint}`, {
    headers: {
      Authorization: `Basic ${credentials}`,
    },
  })
 
  if (!response.ok) {
    throw new Error(`WooCommerce API error: ${response.status}`)
  }
 
  return response.json()
}
 
// Pobierz produkty
const products = await wooFetch('/products?per_page=10')
 
// Pobierz kategorie
const categories = await wooFetch('/products/categories')
 
// Pobierz zamówienia
const orders = await wooFetch('/orders?status=processing')

Popularne endpointy WooCommerce API

Jeśli budujesz headless storefront, pamiętaj o praktycznym podziale:

• REST API świetnie nadaje się do integracji administracyjnych, ERP, synchronizacji katalogu i operacji backendowych.
• Store API lepiej pasuje do frontendu sklepu, koszyka i checkoutu w architekturze headless, ponieważ jest projektowane pod customer-facing cart i checkout.

To detal, o którym łatwo zapomnieć na początku, a później kończy się przepisywaniem połowy integracji.

HPOS i kompatybilność wtyczek WooCommerce

Nowoczesne sklepy WooCommerce powinny brać pod uwagę High-Performance Order Storage (HPOS), czyli nowy model przechowywania zamówień w dedykowanych tabelach. Dla większych sklepów to ważny krok w stronę lepszej wydajności i przewidywalności.

Przed uruchomieniem HPOS sprawdź jednak:

• czy bramka płatności go wspiera,
• czy integracje księgowe i magazynowe są kompatybilne,
• czy własne wtyczki nie zakładają starego modelu danych w wp_posts i wp_postmeta.

Od WooCommerce 8.2+ HPOS jest domyślnie włączony na nowych instalacjach, czyli nie trzeba go ręcznie aktywować. Jest to jeden z najważniejszych punktów listy kontrolnej, ponieważ jeśli masz starszy sklep lub niekompatybilną wtyczkę, możesz HPOS tymczasowo wyłączyć, ale na nowych instalacjach zostaw domyślne ustawienie.

Customizacja sklepu przez hooki WooCommerce

WooCommerce rozszerza system hooków WordPressa. To dobre miejsce na małe zmiany, ale nie zaczynaj od nich, jeśli da się coś ustawić w panelu albo przez sprawdzoną wtyczkę.

Popularne akcje WooCommerce

// Przed formularzem koszyka
add_action('woocommerce_before_cart', function() {
    echo '<div class="free-shipping-notice">';
    echo 'Darmowa wysyłka od 200 zł!';
    echo '</div>';
});
 
// Po dodaniu do koszyka
add_action('woocommerce_add_to_cart', function($cart_item_key, $product_id, $quantity) {
    // Tracking, analytics...
    error_log("Dodano produkt $product_id x$quantity");
}, 10, 3);
 
// Po złożeniu zamówienia
add_action('woocommerce_thankyou', function($order_id) {
    $order = wc_get_order($order_id);
    // Integracja z CRM, e-mail marketingiem...
});

Popularne filtry WooCommerce

// Modyfikacja ceny wyświetlanej
add_filter('woocommerce_get_price_html', function($price, $product) {
    if ($product->is_on_sale()) {
        return '<span class="sale-badge">SALE</span> ' . $price;
    }
    return $price;
}, 10, 2);
 
// Dodanie pola do checkout
add_filter('woocommerce_checkout_fields', function($fields) {
    $fields['billing']['billing_nip'] = [
        'label'       => 'NIP (opcjonalnie)',
        'placeholder' => '000-000-00-00',
        'required'    => false,
        'priority'    => 35,
    ];
    return $fields;
});
 
// Modyfikacja tekstu przycisku
add_filter('woocommerce_product_single_add_to_cart_text', function() {
    return 'Dodaj do koszyka';
});

Szablony WooCommerce i ich nadpisywanie

Aby nadpisać szablon WooCommerce w swoim motywie:

wp-content/themes/moj-motyw/
└── woocommerce/           # Folder z nadpisanymi szablonami
    ├── single-product.php # Strona produktu
    ├── archive-product.php # Listing produktów
    ├── cart/
    │   └── cart.php       # Koszyk
    └── checkout/
        └── form-checkout.php # Formularz zamówienia

Oryginały znajdziesz w:

wp-content/plugins/woocommerce/templates/

Przykład nadpisania szablonu WooCommerce

<!-- woocommerce/single-product.php -->
<?php get_header(); ?>
 
<main class="product-page">
    <?php while (have_posts()) : the_post(); ?>
        <?php wc_get_template_part('content', 'single-product'); ?>
    <?php endwhile; ?>
</main>
 
<?php get_footer('shop'); ?>

Po każdej większej aktualizacji WooCommerce wejdź w:

WooCommerce → Status → Szablony

Jeśli zobaczysz informację o przestarzałych nadpisaniach, porównaj swoje pliki z aktualnymi wersjami z wp-content/plugins/woocommerce/templates/. Szczególnie uważaj na koszyk, checkout i szablony produktu, bo błędy w tych miejscach bezpośrednio blokują sprzedaż.

E-maile, statusy zamówień i dokumenty

Sklep może poprawnie przyjmować płatności, ale nadal wyglądać dla klienta jak zepsuty, jeśli nie dochodzą wiadomości transakcyjne. Minimum do sprawdzenia:

WooCommerce → Ustawienia → E-maile
├── Nowe zamówienie
├── Zamówienie w trakcie realizacji
├── Zamówienie zakończone
├── Zwrot zamówienia
└── Reset hasła / konto klienta

Na produkcji zwykły wp_mail() często nie wystarczy. Ustaw SMTP albo usługę do wysyłki transakcyjnej, np. MailerSend, Brevo, Mailgun, Postmark, Amazon SES albo SMTP hostingu, jeśli ma dobrą reputację. Następnie wykonaj testowe zamówienie i sprawdź, czy wiadomość trafia do skrzynki odbiorczej, a nie do spamu.

Statusy zamówień, które musisz rozumieć:

Jeśli wystawiasz faktury, paragony, dokumenty magazynowe albo etykiety kurierskie, zaplanuj integrację od razu. W praktyce często dochodzą: Fakturownia, iFirma, wFirma, system magazynowy, BaseLinker, Subiekt albo inny ERP. To nie musi być w MVP, ale trzeba wiedzieć, które dane zamówienia będą potrzebne po zakupie.

Najczęstsze problemy w WooCommerce

1. Strona koszyka WooCommerce nie działa

Sprawdź, czy strony są poprawnie przypisane:

WooCommerce → Ustawienia → Zaawansowane → Ustawienia stron

2. Brak metod płatności w WooCommerce

Sprawdź, czy metoda płatności jest włączona w ustawieniach oraz czy strona ma certyfikat SSL. WooCommerce wymaga HTTPS do płatności online. Jeśli metoda płatności nadal się nie pokazuje, sprawdź:

• czy bramka obsługuje walutę sklepu,
• czy kraj klienta pasuje do konfiguracji bramki,
• czy wtyczka działa z checkoutem opartym na blokach,
• czy metoda nie jest ukrywana przez własny filtr woocommerce_available_payment_gateways,
• czy konto bramki jest aktywne i nie działa jeszcze w trybie sandboxu.

3. Złe ceny i błędy podatków

Ustawienia → Podatki → Ceny podawane z podatkiem

Ustawienie musi być spójne z tym, jak wprowadzasz ceny produktów, tzn. albo wszędzie z VAT-em, albo wszędzie bez VAT-u.

4. Problemy z wariantami produktów

Atrybuty muszą być oznaczone jako "Używane do wariantów" przed wygenerowaniem kombinacji, które możesz ustawić w zakładce Atrybuty w edytorze produktu.

5. Checkout działa na desktopie, ale nie na mobile

To częsty problem po dodaniu pól NIP, mapy punktów odbioru, popupu płatności albo ciężkiego motywu. Testuj checkout na realnym telefonie, nie tylko w responsywnym podglądzie przeglądarki. Sprawdź szczególnie:

• wybór punktu odbioru,
• walidację pól adresowych,
• przejście do bramki płatności,
• powrót z płatności do strony podziękowania,
• widoczność komunikatów błędów.

6. Wiadomości transakcyjne WooCommerce nie dochodzą

Jeśli klient płaci, ale nie dostaje potwierdzenia, problem zwykle leży w dostarczalności e-maili, nie w samym WooCommerce. Ustaw SMTP lub usługę transakcyjną, zweryfikuj domenę i sprawdź rekordy SPF, DKIM oraz DMARC.

Lista kontrolna przed startem sklepu WooCommerce

1. SSL (HTTPS) skonfigurowany,
2. Dane firmy (adres, NIP) uzupełnione,
3. Strona sklepu przypisana w ustawieniach produktów,
4. Strony koszyka, checkoutu, konta i regulaminu poprawnie przypisane,
5. Podatki skonfigurowane dla realnych produktów,
6. Klasy podatkowe przypisane do produktów z obniżoną stawką,
7. Minimum 1 metoda płatności aktywna,
8. Minimum 1 metoda wysyłki aktywna,
9. Klasy wysyłkowe przypisane do produktów niestandardowych,
10. E-maile transakcyjne działają i dochodzą do skrzynki odbiorczej,
11. Polityka prywatności, regulamin i zgody w checkout,
12. Backup bazy danych i plików,
13. Środowisko stagingowe lub kopia testowa,
14. Tryb testowy płatności przełączony na produkcję,
15. Wykonana prawdziwa płatność testowa niską kwotą.

Co sprawdzić przed startem sprzedaży w WooCommerce?

Konfiguracja produktów i płatności to dopiero początek, ponieważ przed odpaleniem sklepu musisz sprawdzić jeszcze:

• wiadomości transakcyjne i ich dostarczalność,
• podatki i stawki wysyłki dla realnych scenariuszy,
• statusy zamówień po płatności i zwrocie,
• kopie zapasowe i środowisko stagingowe,
• wydajność checkoutu na mobile,
• zgodność regulaminów, polityki prywatności i checkboxów zgód z lokalnymi wymaganiami.

Dobry test startowy to trzy pełne zamówienia:

1. Produkt fizyczny z wysyłką kurierską i udaną płatnością online.
2. Produkt z odbiorem w punkcie lub paczkomacie, z anulowaną płatnością.
3. Produkt cyfrowy albo najprostszy produkt bez wysyłki, z testem zwrotu.

Po każdym teście sprawdź: status zamówienia, wiadomość do klienta, wiadomość do administratora, koszt wysyłki, VAT, dane w panelu bramki płatności i to, czy zamówienie da się poprawnie obsłużyć po stronie sklepu.