WordPress WooCommerce

Headless Starter Kit

Frontend Next.js 15 pronto all'uso per WooCommerce — autenticazione JWT, carrello, checkout, ISR, distribuzione Vercel o Hetzner in un comando.

Headless Starter Kit trasforma il tuo negozio WooCommerce in un commercio headless in pochi minuti. Il plugin espone le API JWT e REST necessarie lato WordPress e consegna, in download diretto dall'admin, un progetto Next.js 15 completo preconfigurato con i tuoi URL e segreti.

Next.js 15 WooCommerce 8+ Compatibile HPOS Vercel e Hetzner ready
  • Rimborso 30 giorni
  • 12 mesi di aggiornamenti
  • Supporto 24h
www.datafirefly.com/it/
Headless Starter Kit
v1.0.0 · aggiornato 2026-05-23
Cosa fa

L' versione breve.

01

Autenticazione JWT auto-portante

Login, refresh, /me, register, logout — senza dipendenza Composer né libreria di terze parti (HS256 proprietario).

02

Carrello stateless o lato server

Modalità JWT firmata per edge e multi-istanza, oppure WC_Session nativa per restare compatibile con le tue estensioni WooCommerce.

03

Checkout WooCommerce intatto

Crea un vero ordine, attiva tutti gli hook nativi, reindirizza al gateway di pagamento esistente (Stripe, PayPal, Mollie, ecc.).

04

ISR su richiesta

Webhook su prodotti, categorie, ordini, pagine. Next.js rigenera solo ciò che cambia, senza cron né rebuild completo.

05

Distribuzione in un comando

Vercel zero-config o Hetzner tramite docker-compose e script bash inclusi. Variabili d'ambiente precompilate.

06

Starter Next.js consegnato nello ZIP

Tailwind 3.4, App Router, iron-session, pagine home, listing, scheda prodotto ISR, carrello, checkout, login, registrazione, account cliente.

La versione lunga

Tutto quello che vorresti sapere prima di installare.

Uno sguardo dettagliato su come funziona Headless Starter Kit, perché l'abbiamo progettato così, e il ragionamento dietro le funzionalità qui sopra.

§ 01

Perché passare a headless?

Disaccoppiare il frontend dal backend WordPress significa guadagnare in performance (Core Web Vitals nel verde grazie a ISR), flessibilità di design (Tailwind e componenti React moderni) e sicurezza (il tuo back-office resta invisibile al pubblico). Headless Starter Kit fornisce il ponte pronto all'uso, senza dover reinventare auth, carrello o checkout.

§ 02

Autenticazione JWT senza dipendenze

Il plugin incorpora la propria implementazione HS256 — niente Composer, niente libreria di terze parti, niente fork di simple-jwt-auth. Token di accesso a breve durata (60 min per impostazione predefinita) e refresh token a lunga durata (30 giorni), tutti configurabili. I refresh token vengono memorizzati lato Next.js in cookie httpOnly cifrati tramite iron-session.

§ 03

Carrello: scegli la tua modalità

Modalità JWT (predefinita): l'intero carrello viene serializzato in un token firmato restituito tramite l'header X-DFHSK-Cart. Nessun database coinvolto, ideale per Vercel edge o multi-istanza. Modalità server: il carrello vive nella WC_Session nativa. Indispensabile se usi estensioni WooCommerce che si agganciano al carrello (abbonamenti, dynamic pricing, ecc.).

§ 04

Checkout: tutto WooCommerce continua a funzionare

Il plugin non re-implementa il checkout. Crea un vero ordine WooCommerce, attiva tutti gli hook abituali (notifiche, magazzino, tasse, gateway di pagamento) e restituisce l'URL di redirect verso il gateway. Stripe, PayPal, Mollie, bonifico, assegno — tutto ciò che funziona su WooCommerce funziona qui.

§ 05

ISR senza mal di testa

Ad ogni modifica di un prodotto, una categoria, una pagina o un ordine, il plugin invia un POST firmato a /api/revalidate del tuo frontend Next.js. Decidi tu nelle impostazioni quali eventi propagare e quali percorsi o tag rivalidare. Niente cache obsoleta, niente cron, niente rebuild completo.

§ 06

Starter Next.js incluso, pronto per la distribuzione

Lo ZIP consegnato contiene un progetto Next.js 15 (App Router) completo: home, listing, scheda prodotto ISR, carrello, checkout, login, registrazione, account cliente. Variabili d'ambiente già compilate con i tuoi URL e segreti WordPress. Distribuzione Vercel zero-config o Hetzner tramite docker-compose e script bash.

§ 07

Diagnostica integrata

Scheda Diagnostica nell'admin WordPress: 11 controlli automatici (WooCommerce attivo, permalink corretti, REST raggiungibile, HTTPS, GraphQL rilevato, segreto JWT definito, URL del front configurato, origini CORS valide, token di rivalidazione, chiavi WooCommerce REST, modalità carrello). Verde, arancione o rosso per identificare all'istante cosa blocca.