Tudo o que quer saber antes de instalar.
Uma análise detalhada de como o Kit Headless WooCommerce: Front-end Desacoplado e API funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.
Porquê passar para headless?
Desacoplar o front-end do back-end WordPress é ganhar em desempenho (Core Web Vitals no verde graças ao ISR), em flexibilidade de design (Tailwind e componentes React modernos) e em segurança (o seu back-office fica invisível publicamente). O Headless Starter Kit fornece a ponte pronta a usar sem reinventar a autenticação, o carrinho nem o checkout.
Autenticação JWT sem dependências
O plugin traz a sua própria implementação HS256, sem necessidade de Composer, de bibliotecas de terceiros ou de um fork do simple-jwt-auth. Tokens de acesso de curta duração (60 minutos por predefinição) e refresh tokens de longa duração (30 dias), todos configuráveis. Os refresh tokens são guardados do lado do Next.js em cookies httpOnly cifrados através do iron-session.
Carrinho: escolha o seu modo
Modo JWT (predefinido): o carrinho completo é serializado num token assinado devolvido no cabeçalho X-DFHSK-Cart. Sem qualquer base de dados envolvida, ideal para Vercel edge ou para várias instâncias. Modo servidor: o carrinho vive no WC_Session nativo. Indispensável se usa extensões WC que fazem hook no carrinho (subscrições, preços dinâmicos, etc.).
Checkout: todo o WooCommerce continua utilizável
O plugin não reimplementa o checkout. Cria uma encomenda WooCommerce real, aciona todos os hooks habituais (notificações, stock, impostos, gateways de pagamento) e devolve o URL de redirecionamento para o gateway. Stripe, PayPal, Mollie, transferência, cheque: tudo o que funciona no WooCommerce funciona aqui.
ISR sem dores de cabeça
A cada alteração de um produto, de uma categoria, de uma página ou de uma encomenda, o plugin envia um POST assinado para o /api/revalidate do seu front-end Next.js. Decide nas definições que eventos propagar e que caminhos ou tags revalidar. Sem cache obsoleta, sem cron, sem rebuild completo.
Starter Next.js incluído, pronto a implantar
O ZIP entregue contém um projeto Next.js 15 (App Router) completo: página inicial, listagem, ficha de produto ISR, carrinho, checkout, início de sessão, registo e área de cliente. Variáveis de ambiente já preenchidas com os seus URL e segredos do WordPress. Implantação Vercel sem configuração ou Hetzner através de docker-compose e script bash.
Diagnósticos integrados
Separador Diagnósticos na administração do WordPress: 11 verificações automáticas (WooCommerce ativo, ligações permanentes limpas, REST acessível, HTTPS, GraphQL detetado, segredo JWT definido, URL do front-end configurado, origens CORS válidas, token de revalidação, chaves REST do WooCommerce, modo do carrinho). Verde, laranja ou vermelho para identificar de imediato o que está a bloquear.
Ainda não existem avaliações.