Astra mini cart WooCommerce não aparece: como corrigir

Tipo Page Builders

Nome do erro Mini Cart do WooCommerce não exibe no Astra Pro EN: Astra Pro WooCommerce Mini Cart not displaying

Severidade Atenção

Descrição O Astra mini cart do WooCommerce que não aparece deixa o icone ausente no header, abre um dropdown vazio ou exibe a janela transparente. A causa quase sempre e o elemento Cart não adicionado no Header Builder, o script wc-cart-fragments bloqueado pelo cache, ou o filtro de fundo do outline cart desligado após migrar do header antigo.

O que é o Astra mini cart do WooCommerce que não aparece?

O Mini Cart do Astra e o icone de carrinho que fica no cabeçalho e, ao clicar ou passar o mouse, abre um resumo com os itens do WooCommerce sem sair da página. No Header Builder novo do Astra ele e um elemento chamado Cart (Carrinho); no header antigo, era adicionado como último item do menu. A contagem e a atualização em tempo real dependem do script wc-cart-fragments do WooCommerce, que faz uma requisicao AJAX a cada alteração do carrinho. Quando esse elemento não esta no header ou o AJAX e bloqueado, o mini cart some, abre vazio ou não atualiza a quantidade.

Como identificar

O icone do carrinho não aparece no cabeçalho mesmo com o WooCommerce ativo e produtos no catalogo.
Ao clicar no icone, o dropdown do mini cart abre vazio ou não abre, embora haja itens no carrinho.
A janela do mini cart fica transparente e ilegivel sobre o conteúdo da página, sem fundo solido.
O contador de itens ao lado do icone trava em zero e so muda depois de recarregar a página inteira.
O console do navegador mostra falha ao carregar wc-cart-fragments.min.js ou erro de JavaScript no header.

Antes de começar: Antes de editar o functions.php do tema filho ou adicionar snippets, faca backup do arquivo e do banco. Um erro de sintaxe no PHP derruba o site com erro crítico, e e mais seguro usar um plugin de snippets ou testar primeiro em staging.

Como prevenir

Após migrar do header antigo para o Header Builder, confirme que o elemento Carrinho foi readicionado e publicado
Mantenha wc-cart-fragments e o cookie woocommerce_cart_hash sempre fora das otimizacoes e do cache de página
Atualize Astra e Astra Pro juntos e teste o mini cart em staging antes de aplicar otimizacoes de cache em producao

Causa

Elemento Cart (Carrinho) ausente do Header Builder do Astra, em Aparencia -> Personalizar -> Header Builder, deixando o cabeçalho sem o icone do carrinho.
Script wc-cart-fragments do WooCommerce bloqueado por minificacao, combinacao ou adiamento de JavaScript no plugin de cache, quebrando o AJAX que abre e atualiza o mini cart.
Cookie woocommerce_cart_hash e a página servidos a partir do cache de página, congelando a contagem do carrinho em zero para todos os visitantes.
Filtro astra_apply_background_to_outline_cart_builder_element desligado após migrar do header antigo para o Header Footer Builder, deixando o outline cart transparente (corrigido no Astra 3.6.7, mas não aplicado automaticamente em sites existentes).
Estilo do carrinho definido como Off-Canvas ou Slide-In em Aparencia -> Personalizar -> Header Builder -> Carrinho enquanto o tema filho ou um plugin remove o markup do drawer, impedindo o painel de abrir.

Como resolver

Adicione o elemento Cart no Header Builder: confirme que o icone do carrinho esta no cabeçalho. Abra o Personalizador, entre no Header Builder, arraste o elemento Carrinho para a área desejada e publique. No header antigo, use o último item do menu como WooCommerce. Os caminhos exatos estão abaixo.
```
Aparencia -> Personalizar -> Header Builder -> arrastar elemento 'Carrinho' para a área do cabeçalho
Header antigo: Aparencia -> Personalizar -> Header -> Primary Menu -> Last Item in Menu -> WooCommerce
```
Escolha o estilo de carrinho e o icone: ainda no Personalizador, abra as opções do elemento Carrinho e selecione um dos icones disponiveis e o estilo de exibicao (Dropdown ou Slide-In). Se o painel não abre, troque temporariamente para Dropdown para descartar problema no markup do drawer.
```
Aparencia -> Personalizar -> Header Builder -> Carrinho -> Cart Icon Style + Cart Click Action (Dropdown / Slide-In)
```
Libere o cart fragments e o cookie no cache: no plugin de cache, exclua o script de fragments da minificacao e do adiamento de JS e impeca o cache de página de servir o carrinho. Isso restaura o AJAX que abre e atualiza o mini cart. Use as exclusoes abaixo.
```
Excluir da minificacao/combinacao/defer de JS: wc-cart-fragments
Não cachear o cookie: woocommerce_cart_hash
Excluir do cache de página: /cart/, /checkout/, /minha-conta/
```
Reaplique o fundo do outline cart: se o mini cart abre transparente após migrar do header antigo, reative o fundo do outline cart com o filtro oficial do Astro. Adicione o snippet em um plugin de código ou no functions.php do tema filho. O código esta na seção abaixo.
Teste sem cache e sem plugins concorrentes: limpe todo o cache, recarregue com o cache do navegador desativado e, se persistir, ative o tema Astra padrão sem tema filho e desative plugins de otimização um a um para isolar o que remove o markup do mini cart.

PHP

// functions.php do tema filho ou plugin de snippets
// Reaplica o fundo solido no outline cart do Header Builder (Astra 3.6.7+),
// resolvendo o mini cart que fica transparente apos migrar do header antigo.
add_filter( 'astra_apply_background_to_outline_cart_builder_element', '__return_true' );

// Opcional: forca o reenfileiramento do script que abre e atualiza o mini cart
// caso uma otimizacao agressiva o tenha removido do header.
add_action( 'wp_enqueue_scripts', function () {
    if ( function_exists( 'is_cart' ) && ! is_admin() ) {
        wp_enqueue_script( 'wc-cart-fragments' );
    }
}, 20 );

Perguntas frequentes

O icone do carrinho sumiu do header depois de mudar o cabeçalho. Por que?

Ao migrar para o Header Builder do Astra, o elemento Carrinho não e movido sozinho. Abra Aparencia, Personalizar e Header Builder, arraste o elemento Carrinho de volta para a área do cabeçalho e publique. No header antigo, o caminho e definir o último item do menu como WooCommerce.

O mini cart abre vazio mesmo com itens no carrinho. Como resolver?

Quase sempre e o script wc-cart-fragments bloqueado pelo cache. Exclua esse script da minificacao e do adiamento de JS, impeca o cache de página de servir o carrinho e mantenha o cookie woocommerce_cart_hash fora do cache. Sem o AJAX dele, o dropdown abre sem os itens.

O contador de itens trava em zero. O que esta errado?

A página esta sendo servida do cache com o estado antigo do carrinho. Configure o plugin de cache para não cachear o cookie woocommerce_cart_hash e excluir as páginas de carrinho e checkout. Assim o WooCommerce atualiza a contagem via fragments sem recarregar a página inteira.

Por que o mini cart fica transparente e ilegivel?

Esse e um problema conhecido ao migrar do header antigo para o Header Footer Builder do Astra. O fundo do outline cart deixa de ser aplicado. A correção oficial e reativar o filtro astra_apply_background_to_outline_cart_builder_element, disponível a partir do Astra 3.6.7, num plugin de snippets ou no tema filho.

Qual a diferenca entre Dropdown e Slide-In no carrinho do Astra?

Dropdown abre um pequeno resumo logo abaixo do icone, e Slide-In (Off-Canvas) desliza um painel lateral com o carrinho. Ambos são escolhidos em Aparencia, Personalizar, Header Builder, Carrinho. Se o Slide-In não abre, troque para Dropdown para descartar que um plugin removeu o markup do painel lateral.

Posso exibir o mini cart fora do cabeçalho?

Sim. O Astra oferece um shortcode de mini cart que pode ser colocado em páginas, widgets ou construtores. Adicione o carrinho ao header como Slide-In e use o shortcode astra_woo_mini_cart onde quiser que o icone apareca, mantendo o mesmo comportamento do cabeçalho.

Preciso do Astra Pro para ter o mini cart do WooCommerce?

O Astra gratuito já exibe o icone do carrinho no header. O Astra Pro amplia o controle: estilos de Off-Canvas, posicionamento no Header Builder e opções visuais do icone e do contador. Se o icone sumiu, primeiro confirme o elemento no Header Builder antes de suspeitar da licenca Pro.

Atenção

Como corrigir estilos que não aplicam entre Ultimate Addons e Astra Pro no WordPress

O problema dos estilos do Ultimate Addons e Astra Pro que não aplicam acontece quando o CSS dos widgets UAEL fica preso em arquivos gerados desatualizados, em cache do site ou é sobrescrito pelo CSS dinâmico do Astra Pro, deixando o widget sem visual no frontend.

Atenção

Como corrigir o widget de galeria do Elementor que não carrega imagens no WordPress

A galeria do Elementor não carrega imagens quando o tamanho de miniatura selecionado no widget não existe na biblioteca de mídia, quando um plugin de cache ou lazy load adia o carregamento das fotos, ou quando o caminho dos arquivos quebrou após migração, CDN ou troca de domínio.

Atenção

Como corrigir o Google Maps Field no ACF PRO (chave de API)

O Google Maps Field do ACF PRO exige uma chave de API do Google registrada via filtro acf/fields/google_map/api ou acf_update_setting. Sem ela, o campo mostra um mapa cinza e o console acusa erro da Google Maps JavaScript API.

Atenção

Como corrigir o WYSIWYG Field do ACF PRO quando o editor não carrega no WordPress

O ACF WYSIWYG editor não carrega quando o TinyMCE do WordPress não inicializa no campo: a opção Delay initialization espera um clique, uma linha nova de Repeater ou Flexible Content é inserida sem reanexar o editor, ou um erro de JavaScript trava a Block API antes do ACF montar o campo.

Atenção

Como corrigir o Clone Field que não duplica campos no ACF PRO

O Clone Field do ACF PRO não duplica campos quando dois clones do mesmo grupo compartilham o field_key, quando o Display está como Group sem prefixo de nome, ou quando o grupo clonado original está inativo, fazendo os campos sumirem ou não salvarem.

Atenção

Como corrigir o Gallery Field com imagens que não carregam no ACF PRO

O ACF Gallery Field não carrega imagem quando o código do template trata o retorno da galeria de forma diferente do Return Format configurado no campo, ou quando o grupo de campos não casa com o post editado, fazendo a galeria voltar vazia no frontend.

Setores

Extensões

Integrações

Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce

O que é o Astra mini cart do WooCommerce que não aparece?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir estilos que não aplicam entre Ultimate Addons e Astra Pro no WordPress

Como corrigir o widget de galeria do Elementor que não carrega imagens no WordPress

Como corrigir o Google Maps Field no ACF PRO (chave de API)

Como corrigir o WYSIWYG Field do ACF PRO quando o editor não carrega no WordPress

Como corrigir o Clone Field que não duplica campos no ACF PRO

Como corrigir o Gallery Field com imagens que não carregam no ACF PRO

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos