WordPress WooCommerce

Zestaw startowy Headless dla WooCommerce: odłączony frontend i API

Gotowy frontend Next.js 15 dla WooCommerce: uwierzytelnianie JWT, koszyk, checkout, ISR i wdrożenie na Vercelu albo Hetznerze jednym poleceniem.

Headless Starter Kit przenosi Twój sklep WooCommerce na architekturę headless w kilka minut. Wtyczka udostępnia po stronie WordPressa niezbędne API JWT i REST oraz oddaje do pobrania bezpośrednio z panelu kompletny projekt Next.js 15, wstępnie skonfigurowany Twoimi adresami i sekretami.

Next.js 15 WooCommerce 8+ Zgodne z HPOS Gotowe na Vercel i Hetzner
  • Zwrot w 30 dni
  • 12 miesięcy aktualizacji
  • Wsparcie 24 h
www.datafirefly.com/pl/
Zestaw startowy headless dla odłączonego frontendu sklepu WooCommerce
v1.0.0 · zaktualizowano 2026-05-23
Co robi

W skrócie.

01

Samodzielne uwierzytelnianie JWT

Login, refresh, /me, register, logout, bez zależności Composera i bez zewnętrznych bibliotek (własna implementacja HS256).

02

Koszyk bezstanowy albo serwerowy

Tryb podpisanego JWT dla edge i wielu instancji albo natywny WC_Session, żeby zachować zgodność z Twoimi rozszerzeniami WooCommerce.

03

Checkout WooCommerce nienaruszony

Tworzenie prawdziwego zamówienia, uruchomienie natywnych hooków i przekierowanie do istniejącej bramki płatności (Stripe, PayPal, Mollie i inne).

04

ISR na żądanie

Webhooki dla produktów, kategorii, zamówień i stron. Next.js regeneruje tylko to, co się zmieniło, bez crona i bez pełnego przebudowania.

05

Wdrożenie jednym poleceniem

Vercel bez konfiguracji albo Hetzner przez docker-compose i dołączony skrypt bash. Zmienne środowiskowe wypełnione z góry.

06

Starter Next.js w paczce

Tailwind 3.4, App Router, iron-session, strony: główna, listing, karta produktu z ISR, koszyk, checkout, logowanie, rejestracja, konto klienta.

Wersja pełna

Wszystko, co warto wiedzieć, zanim zainstalujesz.

Szczegółowe spojrzenie na to, jak działa Zestaw startowy Headless dla WooCommerce: odłączony frontend i API, dlaczego zbudowaliśmy go w ten sposób i jaka myśl stoi za powyższymi funkcjami.

§ 01

Po co przechodzić na headless?

Odłączenie frontendu od zaplecza WordPressa daje wydajność (Core Web Vitals na zielono dzięki ISR), swobodę w projektowaniu (Tailwind i nowoczesne komponenty React) oraz bezpieczeństwo (Twoje zaplecze pozostaje niewidoczne publicznie). Headless Starter Kit dostarcza gotowy pomost, bez wymyślania od nowa uwierzytelniania, koszyka i checkoutu.

§ 02

Uwierzytelnianie JWT bez zależności

Wtyczka zawiera własną implementację HS256: bez Composera, bez zewnętrznej biblioteki i bez forka simple-jwt-auth. Krótkożyjące tokeny dostępu (domyślnie 60 minut) i długożyjące tokeny odświeżające (30 dni), wszystkie konfigurowalne. Tokeny odświeżające są przechowywane po stronie Next.js w szyfrowanych ciasteczkach httpOnly przez iron-session.

§ 03

Koszyk: wybierz swój tryb

Tryb JWT (domyślny): cały koszyk jest serializowany do podpisanego tokenu zwracanego nagłówkiem X-DFHSK-Cart. Żadnej bazy danych w grze, idealne pod Vercel edge i wiele instancji. Tryb serwerowy: koszyk żyje w natywnym WC_Session. Niezbędny, jeśli używasz rozszerzeń WooCommerce podłączających się pod koszyk (subskrypcje, dynamiczne ceny i inne).

§ 04

Checkout: całe WooCommerce dalej działa

Wtyczka nie implementuje checkoutu od nowa. Tworzy prawdziwe zamówienie WooCommerce, uruchamia wszystkie zwykłe hooki (powiadomienia, stany magazynowe, podatki, bramki płatności) i zwraca adres przekierowania do bramki. Stripe, PayPal, Mollie, przelew, czek: wszystko, co działa w WooCommerce, działa i tutaj.

§ 05

ISR bez łamania głowy

Przy każdej zmianie produktu, kategorii, strony albo zamówienia wtyczka wysyła podpisane żądanie POST na /api/revalidate Twojego frontu Next.js. W ustawieniach decydujesz, które zdarzenia propagować i które ścieżki albo tagi odświeżać. Bez nieaktualnego cache, bez crona, bez pełnego przebudowania.

§ 06

Starter Next.js w komplecie, gotowy do wdrożenia

Dostarczona paczka ZIP zawiera kompletny projekt Next.js 15 (App Router): strona główna, listing, karta produktu z ISR, koszyk, checkout, logowanie, rejestracja, panel klienta. Zmienne środowiskowe są już wypełnione Twoimi adresami i sekretami z WordPressa. Wdrożenie na Vercelu bez konfiguracji albo na Hetznerze przez docker-compose i skrypt bash.

§ 07

Wbudowana diagnostyka

Zakładka Diagnostyka w panelu WordPressa: 11 automatycznych kontroli (aktywne WooCommerce, czyste bezpośrednie odnośniki, osiągalny REST, HTTPS, wykryty GraphQL, ustawiony sekret JWT, skonfigurowany adres frontu, poprawne źródła CORS, token rewalidacji, klucze WooCommerce REST, tryb koszyka). Zielony, pomarańczowy albo czerwony status pozwala natychmiast wskazać, co blokuje.