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.

Instalacja

WooCommerce to wtyczka WordPress, instalujesz 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 pojawią się:

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

Oraz nowe strony:

Podstawowe ustawienia

Wszystko w: WooCommerce → Ustawienia

Zakładka: Ogólne

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

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: ✓

Zakładka: Podatki

Dla Polski podatek VAT:

Włącz podatki: ✓

Ceny z podatkiem:
├── "Tak, będę wprowadzać ceny z podatkiem"
└── Wyświetlaj ceny: "Z podatkiem"

Stawki standardowe:
| Kod kraju | Stawka | Nazwa  | Priorytet | Zastosowanie                      |
|-----------|--------|--------|-----------|-----------------------------------|
| PL        | 23     | VAT    | 1         | Standardowa                       |
| PL        | 8      | VAT 8% | 1         | Usługi budowlane, gastronomia     |
| PL        | 5      | VAT 5% | 1         | Żywność nieprzetworzona, książki, leki |

Zakładka: Wysyłka

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ł

Zakładka: Płatności

Wbudowane metody:

Dla prawdziwych płatności online potrzebujesz wtyczki:

• Przelewy24 — najpopularniejszy w PL,
• PayU — BLIK, karty,
• Stripe — międzynarodowo, karty,
• PayPal — 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)

Produkty — typy i konfiguracja

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

Produkt prosty

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

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 (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/afiliacyjny

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

Produkt grupowany

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 — produkt grupowany sam w sobie nie ma ceny.

REST API WooCommerce

WooCommerce ma rozbudowane APIAPI, czyli Application Programming Interface, definiuje sposób komunikacji między aplikacjami lub modułami. Tu chodzi o konwencje plików Next.js, które zamieniają eksportowaną funkcję w gotowy plik sitemap.xml lub robots.txt., które jest idealne do headless:

Włączenie API

WooCommerce → Ustawienia → Zaawansowane → REST API → Dodaj klucz
├── Opis: Frontend App
├── Użytkownik: admin
└── Uprawnienia: Odczyt/Zapis

Otrzymujesz:

• Consumer Key: ck_xxxxx
• Consumer Secret: cs_xxxxx

Przykłady zapytań

// 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) {
  // btoa() dostępne globalnie od Node.js 16+
  // alternatywnie: Buffer.from(`${CONSUMER_KEY}:${CONSUMER_SECRET}`).toString('base64')
  const credentials = btoa(`${CONSUMER_KEY}:${CONSUMER_SECRET}`)
  const response = await fetch(`${WOO_URL}${endpoint}`, {
    headers: {
      Authorization: `Basic ${credentials}`,
    },
  })
  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

Jeśli budujesz headless storefront, pamiętaj o ważnym rozróżnieniu:

• REST APIREST API to interfejs udostępniający dane przez standardowe metody HTTP (GET, POST...) pod adresami zasobów — w WordPressie domyślnie pod /wp-json/. ś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.

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

HPOS i kompatybilność wtyczek

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 custom pluginy nie zakładają starego modelu danych w wp_posts i wp_postmeta.

Od WooCommerce 8.2+ HPOS jest domyślnie włączone na nowych instalacjach — nie musisz go ręcznie aktywować. W praktyce to jeden z najważniejszych punktów checklisty: jeśli masz starszy sklep lub niekompatybilną wtyczkę, możesz HPOS tymczasowo wyłączyć, ale na nowych instalacjach zostaw domyślne ustawienie.

Customizacja — hooks WooCommerce

WooCommerce rozszerza system hooks WordPressa:

Popularne akcje

// 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, email marketing...
});

Popularne filtry

// 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

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

<!-- 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'); ?>

Najczęstsze problemy

1. Strona koszyka nie działa

Sprawdź, czy strony są poprawnie przypisane:

WooCommerce → Ustawienia → Zaawansowane → Ustawienia stron

2. Brak płatności

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.

3. Złe ceny (podatki)

Ustawienia → Podatki → Ceny podawane z podatkiem

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

4. Problemy z wariantami

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

Checklist przed startem całości

□ SSL (HTTPS) skonfigurowany,
□ Dane firmy (adres, NIP) uzupełnione,
□ Podatki skonfigurowane dla PL,
□ Minimum 1 metoda płatności aktywna,
□ Minimum 1 metoda wysyłki aktywna,
□ Strony (koszyk, checkout, konto) poprawnie przypisane,
□ Emaile transakcyjne działają,
□ Polityka prywatności i regulamin,
□ Backup bazy danych,
□ Tryb testowy płatności → Produkcja,

Co sprawdzić przed startem sprzedaży

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

• emaile 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.