blog
WordPress

Como ligar cache no WooCommerce sem quebrar o carrinho

As quatro rotas que precisam sair do cache antes de ligar, o que fazer com o mini carrinho que fica congelado no topo e como confirmar tudo na aba Rede do navegador.

JR · · 11 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: antes de ativar, tire quatro rotas do cache: carrinho, finalizar compra, minha conta e os endpoints da conta (pedidos, endereços, downloads, confirmação de pedido). Depois trate o mini carrinho do topo com ESI ou AJAX e confirme na aba Rede: categoria com hit, checkout sem cache.

Neste artigo
  1. Backup e caminho de volta antes do primeiro clique
  2. As quatro rotas que precisam ficar fora do cache
  3. Como declarar a exclusão no LiteSpeed Cache
  4. Por que o mini carrinho do topo é o problema de verdade
  5. Como confirmar na aba Rede que categoria dá HIT e checkout não
  6. Quando algo sai errado
  7. O que este guia não promete

Backup e caminho de volta antes do primeiro clique

Ligar cache de servidor numa loja é uma mudança que afeta o que o visitante vê, não só a velocidade. Se der errado, o sintoma clássico é o cliente adicionar produto e o carrinho continuar mostrando zero itens, ou pior, ver o carrinho de outra pessoa.

Faça duas coisas antes de qualquer clique:

Depois de desligar, limpe o que já ficou armazenado em LiteSpeed Cache > Painel ou no menu do topo (o ícone do plugin, opção Purgar tudo). Desligar sem purgar deixa cópias antigas de lado por algum tempo, dependendo da configuração do servidor.

Não faça a primeira configuração em horário de pico de vendas. Faça quando você puder navegar na loja como visitante por uns 20 minutos sem pressa.

As quatro rotas que precisam ficar fora do cache

Uma loja WooCommerce tem páginas públicas iguais para todo mundo (home, categoria, produto) e páginas que mostram dados de uma pessoa específica. Só as primeiras podem ser servidas do cache.

A documentação oficial do LSCache for WordPress, na página de compatibilidade com plugins de terceiros, descreve o WooCommerce como suportado pelo plugin, que já traz tratamento próprio para as páginas dinâmicas da loja (LSCache for WordPress: Third-Party Plugin Compatibility). Mesmo assim, vale conferir e, se necessário, declarar as exclusões na mão, porque lojas com páginas renomeadas ou traduzidas fogem do padrão.

As quatro rotas são estas:

Rota Slug padrão em instalação em inglês O que ela mostra Pode ser cacheada
Carrinho /cart/ Itens que aquele visitante adicionou Não
Finalizar compra /checkout/ Endereço, frete e pagamento do visitante Não
Minha conta /my-account/ Login, dados pessoais Não
Endpoints da conta e da finalização /my-account/orders/, /my-account/edit-address/, /my-account/downloads/, /checkout/order-received/ Pedidos, endereços, downloads e a confirmação de compra com o número do pedido Não

Os endpoints são os mais esquecidos. O WooCommerce não cria uma página separada para cada área da conta nem para a confirmação do pedido: ele usa endpoints, que são pedaços de URL pendurados na página Minha conta ou na de finalização. Como a exclusão do LiteSpeed Cache casa pelo início do caminho, excluir a página Minha conta já cobre os endpoints dela, e excluir a página de finalização já cobre a confirmação de pedido. A ressalva é a loja que usa slug fora do padrão nesses endpoints, ou página separada para a confirmação: aí a linha específica precisa entrar na lista.

Onde conferir os slugs reais da sua loja

Não presuma os caminhos. Em loja em português é comum ver /carrinho/, /finalizar-compra/ e /minha-conta/.

  1. Vá em WooCommerce > Configurações > Avançado. No topo aparecem Página do carrinho, Página de finalização e Página da conta. Anote as três.
  2. Na mesma tela, role até Endpoints da conta e Endpoints de finalização de compra. Anote cada valor (por exemplo orders, edit-address, downloads, order-received).
  3. Abra cada página no navegador e copie a URL da barra de endereço. É esse texto, e não o nome do menu, que vai nas exclusões.

Na tela você deve terminar com uma lista escrita, algo como: /carrinho/, /finalizar-compra/, /minha-conta/ e os endpoints anotados.

O que pode e o que não pode entrar no cacheHome, categoria, produtoIguais para todos, podem cachearCarrinhoItens do visitante, nunca cachearFinalizar compraEndereço e pagamento, nunca cachearMinha contaLogin e dados pessoais, nunca cachearEndpoints da conta e pedidoPedidos, downloads, confirmação, nunca cachear
Separe as páginas públicas das páginas que mostram dados de uma pessoa.

Como declarar a exclusão no LiteSpeed Cache

  1. Acesse LiteSpeed Cache > Cache e abra a aba Não armazenar URIs em cache (em inglês, Do Not Cache URIs).
  2. Cole um caminho por linha, começando com a barra, sem o domínio. Exemplo baseado numa loja em português:
/carrinho
/finalizar-compra
/minha-conta
/finalizar-compra/pedido-recebido
  1. Clique em Salvar alterações. A tela recarrega e os caminhos aparecem na caixa, um por linha.
  2. Purgue tudo em LiteSpeed Cache > Painel > Purgar tudo. Na tela aparece a confirmação de que o cache foi limpo.

A quarta linha é redundante enquanto o endpoint de confirmação ficar pendurado na página de finalização, já que o campo faz correspondência pelo início do caminho: /minha-conta cobre /minha-conta/pedidos/ e /finalizar-compra cobre a confirmação. Ela está aí porque custa nada e protege o caso em que a loja usa outro slug ou página separada para a confirmação de pedido. Linha a mais nessa caixa custa desempenho só naquela URL; linha a menos custa um carrinho errado para o cliente.

Se o cache é de outro plugin ou do próprio servidor

O conceito é o mesmo e o campo muda de nome: "Never cache page", "Páginas nunca em cache", "Bypass URLs". Procure um campo que aceite caminhos e coloque as mesmas rotas. Se o cache é do servidor e não do plugin, peça ao suporte da sua hospedagem para aplicar a exclusão nas quatro rotas: é uma regra padrão e qualquer painel de hospedagem com cache de página tem onde colocar.

Por que o mini carrinho do topo é o problema de verdade

As quatro exclusões resolvem as páginas inteiras. Sobra o widget de carrinho que fica no cabeçalho, aquele "0 itens, R$ 0,00". Ele aparece dentro de páginas que são cacheadas, como a home e as categorias. Se a página inteira foi guardada com "0 itens", todo visitante vai ver zero, mesmo com três produtos adicionados.

Existem dois caminhos e eles não são equivalentes.

ESI, o bloco dinâmico dentro de uma página cacheada

ESI (Edge Side Includes) é um recurso do servidor web que monta trechos dinâmicos na hora de entregar uma página guardada: você marca um pedaço do HTML como "este trecho não entra no cache, monte na hora". O resto da página continua sendo servido do cache. O LiteSpeed Cache tem a aba ESI em LiteSpeed Cache > Cache, com a opção de ativar ESI e uma lista de blocos a tornar dinâmicos (o widget do carrinho costuma estar entre eles, configurável em Aparência > Widgets, onde cada widget ganha um bloco LiteSpeed Cache com a opção de ativar ESI).

Para descobrir se o seu servidor entrega ESI, há dois caminhos verificáveis. Na tela: se a aba ESI aparecer com a opção desabilitada, com aviso de indisponibilidade, ou se o bloco LiteSpeed Cache do widget não oferecer a opção, o recurso não está disponível. No comportamento: ative ESI na aba, ative o bloco no widget do carrinho, purgue tudo e faça o teste das duas janelas anônimas descrito adiante; se o número do mini carrinho não acompanhar o que você adicionou, o caminho não está funcionando. Em caso de dúvida, pergunte ao suporte da sua hospedagem se o servidor web da sua conta processa ESI.

Vantagem: a página de categoria continua inteira no cache. Custo: ESI depende do servidor web suportar o recurso, e a montagem do bloco dinâmico ainda executa PHP a cada visita. É o caminho mais fiel ao comportamento do WooCommerce.

AJAX, o mini carrinho atualizado depois do carregamento

Aqui a página é cacheada com o mini carrinho vazio e um script no navegador pede o conteúdo atual logo depois do carregamento, substituindo o trecho. Temas modernos e alguns plugins de carrinho lateral já fazem isso por padrão.

Vantagem: não depende de ESI. Custo: o visitante vê "0 itens" por uma fração de segundo antes da troca, e se o script falhar o número fica errado sem aviso.

Como escolher entre ESI e AJAX

Em qualquer um dos casos, teste como visitante anônimo. Logado como administrador você normalmente não recebe página do cache, então tudo parece funcionar.

Como confirmar na aba Rede que categoria dá HIT e checkout não

Esta é a parte que fecha a configuração. Você não precisa confiar no painel do plugin: dá para ver o cabeçalho que o servidor manda.

Abrir a loja numa janela anônima

Abra uma janela anônima (Ctrl+Shift+N no Chrome, Ctrl+Shift+P no Firefox) e vá até uma página de categoria. Janela anônima garante que você não está logado.

Abrir a aba Rede e desabilitar o cache do navegador

Pressione F12, clique em Rede (Network) e marque Desabilitar cache (Disable cache). Isso desliga o cache do navegador, não o do servidor, que é justamente o que queremos observar.

Recarregar e achar a linha do documento HTML

Recarregue a página (F5). Na lista, a primeira linha é o documento HTML, com o nome da URL e tipo document. Clique nela e vá em Cabeçalhos (Headers), seção Cabeçalhos de resposta (Response Headers).

Ler o cabeçalho de cache e entender hit e miss

Procure um cabeçalho cujo nome contenha cache. Em servidor LiteSpeed o nome é x-litespeed-cache e o valor costuma ser hit ou miss. Exemplo de resposta de uma categoria servida do cache:

HTTP/2 200
content-type: text/html; charset=UTF-8
x-litespeed-cache: hit

Na primeira visita depois de purgar, é normal ver miss: a cópia ainda não existia. Recarregue uma segunda vez e o valor deve virar hit. Se continuar miss em toda recarga, alguma coisa está impedindo o armazenamento daquela URL (cookie, exclusão ampla demais, plugin conflitante).

Repetir a leitura no carrinho e no checkout

Adicione um produto, vá para /carrinho/ e depois para /finalizar-compra/, sempre com a aba Rede aberta. Nessas duas URLs o cabeçalho de cache não deve indicar hit. Dependendo da configuração, ele aparece com valor de ausência de cache ou simplesmente não aparece. Qualquer um dos dois está correto.

O teste das duas janelas anônimas, que é o que importa

Com a janela anônima, adicione dois produtos e volte para a home. O mini carrinho do topo precisa mostrar dois itens. Depois abra uma segunda janela anônima separada, entre na loja sem adicionar nada e confirme que o mini carrinho mostra zero. Se a segunda janela mostrar os dois produtos da primeira, pare tudo, desligue o cache e revise as exclusões: há vazamento de conteúdo entre visitantes, que é o pior defeito possível numa loja.

Página Cabeçalho esperado na 2ª visita Mini carrinho
Home hit Só reflete o carrinho com ESI ou AJAX ativo (ver a seção do mini carrinho)
Categoria hit Só reflete o carrinho com ESI ou AJAX ativo
Produto hit Só reflete o carrinho com ESI ou AJAX ativo
Carrinho sem hit Itens reais
Finalizar compra sem hit Itens reais
Minha conta e endpoints sem hit Dados do titular
Sequência para validar o cache da lojaJanela anônimaAbra a loja deslogadoAba Rede, cache offF12, marque Desabilitar cacheRecarregar categoriaSegunda visita deve dar hitConferir carrinho e checkoutNessas URLs, sem hitDuas janelas anônimasSegunda janela precisa mostrar zero
Ordem do teste de verificação depois de purgar tudo.

Quando algo sai errado

Categoria sempre em miss. Verifique se algum plugin está criando cookie em toda visita (chat, popup, teste A/B). Teste desativando um por vez, sempre com a aba Rede aberta na janela anônima.

Cupom aplicado não aparece em outra página. Confirme que o carrinho está na lista de exclusões com o slug real, e não com o slug em inglês presumido.

Pedido confirmado mostra dados de outro pedido. Exclua explicitamente o endpoint de recebimento de pedido. Esse é o caso em que a exclusão genérica do checkout às vezes não cobre a URL com o número do pedido.

Cliente diz que vê a loja logada como outra pessoa. Desligue o cache imediatamente (LiteSpeed Cache > Cache > Ativar Cache = OFF), purgue tudo, e só volte a ligar depois de revisar exclusões e cookies de login. Perda de alguns milissegundos é reversível; sessão trocada entre clientes não é.

Depois de trocar de tema ou de plugin de carrinho. Repita o teste das duas janelas anônimas. Temas mudam a forma de renderizar o mini carrinho e o que funcionava pode parar de funcionar sem nenhum aviso no painel.

O que este guia não promete

Não há aqui nenhuma medição de tempo de resposta feita por nós, nem estimativa de ganho de conversão. Cache de página reduz trabalho do PHP e do banco nas páginas que são idênticas para todos os visitantes, e isso é verificável na sua própria loja com a aba Rede e com o relógio do navegador. Quanto isso vale em venda depende do seu tráfego, do seu tema e do que mais está pesando na página (imagem grande, script de terceiro, consulta lenta).

Duas recomendações contra o hábito comum:

O que a documentação oficial do LSCache for WordPress sobre compatibilidade com plugins de terceiros sustenta é um ponto só: o WooCommerce consta como suportado pelo plugin. O campo Não armazenar URIs em cache, a aba ESI e o bloco LiteSpeed no widget são telas do plugin, descritas aqui como aparecem na instalação, e não vêm dessa página. Os slugs usados nos exemplos são de uma instalação em português e precisam ser conferidos em WooCommerce > Configurações > Avançado na sua loja antes de serem copiados.

Referências

  1. Documentação oficial (litespeed) — LSCache for WordPress: Third-Party Plugin Compatibility. Consultado em 2026-10-15.
Leia também