Astra header footer quebrado: corrigir após atualizar

Tipo Page Builders

Nome do erro Header/Footer quebrado no Astra Pro após atualização EN: Astra Pro Header/Footer broken after update

Severidade Grave

Descrição O Astra header footer quebrado após atualização ocorre quando o cabeçalho ou rodape do Astra Pro some, perde estilo ou troca de posicao depois de um update do tema ou do Astra Pro Addon. A causa quase sempre e CSS dinamico em arquivo defasado, módulo Custom Layouts desligado, ou regra de exibicao do layout perdida.

O que é o Astra header footer quebrado após atualização?

O Astra Pro monta cabeçalho e rodape por dois caminhos: o Header Footer Builder nativo (no Personalizar) e o módulo Custom Layouts, que cria cabeçalhos e rodapes próprios ligados a um gancho (hook) e a uma regra de exibicao. Para acelerar o carregamento, o Astra grava o CSS calculado dessas áreas em arquivos estaticos na pasta de uploads, em vez de gerar tudo a cada visita. Quando o tema, o Astra Pro Addon ou o WordPress são atualizados, esses arquivos de CSS podem ficar defasados, um módulo pode voltar desligado, ou a regra de exibicao do Custom Layout pode deixar de casar com a página. O resultado e o cabeçalho ou o rodape sumindo, aparecendo sem estilo ou na posicao errada, mesmo com a configuração salva intacta no banco.

Como identificar

O cabeçalho ou o rodape aparece sem estilo, com os links empilhados e fora de posicao, como se o CSS não tivesse carregado.
O Custom Layout de cabeçalho ou rodape simplesmente não aparece mais no site, mesmo continuando publicado no painel.
A aba do Header Footer Builder ou do Custom Layouts some do Personalizar, sinal de que o módulo do Astra Pro voltou desligado.
O console do navegador acusa erro 404 num arquivo de CSS dentro de wp-content/uploads, indicando CSS dinamico do Astra ausente.
Em páginas especificas o cabeçalho certo não aparece, enquanto na home funciona, apontando regra de exibicao perdida após o update.

Antes de começar: Faca backup do site e do banco antes de regenerar CSS ou editar arquivos de tema, e teste a atualização do Astra Pro em staging: uma incompatibilidade de versão pode derrubar o cabeçalho e o rodape de todas as páginas ao mesmo tempo em producao.

Como prevenir

Atualize sempre o tema Astra e o Astra Pro Addon juntos, na mesma versão, e teste em staging antes da producao
Regenere o CSS dinamico do Astra logo após cada atualização de tema para evitar folha de estilo defasada
Evite sobrescrever header.php e footer.php no tema-filho; prefira o Header Footer Builder ou os Custom Layouts via gancho
Após atualizar, confira na página de módulos do Astra Pro se Header Footer Builder e Custom Layouts continuam ligados

Causa

Arquivos de CSS dinamico do Astra na pasta wp-content/uploads/astra ficaram defasados ou foram apagados na atualização, deixando o cabeçalho e o rodape sem estilo.
O módulo Custom Layouts ou o Header Footer Builder voltou desativado na página de módulos do Astra Pro Addon após o update, removendo o cabeçalho personalizado.
A regra de exibicao (Display Rules) do Custom Layout perdeu o alvo na atualização e o layout deixou de casar com as páginas onde antes aparecia.
Cache de página ou de objeto servindo a versão antiga do header e do footer, mascarando o CSS novo já gerado pelo Astra.
header.php ou footer.php sobrescritos num tema-filho antigo não acompanharam a mudanca de marcacao do Astra Pro na nova versão.
Versão do Astra Pro Addon desencontrada da versão do tema Astra, gerando incompatibilidade entre o builder e a renderizacao do cabeçalho.

Como resolver

Regenere o CSS dinamico do Astra: no painel, abra a tela de ferramentas do tema e clique para recriar os arquivos de CSS. Isso descarta o CSS antigo em arquivo e forca o Astra a gravar a folha de estilo atual do cabeçalho e do rodape.
```
Aparencia -> Astra Options -> Regenerar arquivos de CSS
```
Reative os módulos do Astra Pro: confirme que o Header Footer Builder e o Custom Layouts continuam ligados; uma atualização pode deixar o módulo desligado e remover o cabeçalho personalizado.
```
Aparencia -> Astra Options -> Habilitar módulos -> Custom Layouts
Aparencia -> Astra Options -> Habilitar módulos -> Header Footer Builder
```
Revise a regra de exibicao do Custom Layout: abra o Custom Layout do cabeçalho ou rodape afetado e confira o gancho e a condicao de exibicao; reaplique o alvo se a regra ficou vazia depois do update.
```
Aparencia -> Custom Layouts -> editar o layout -> Display Rules
```
Limpe todos os caches: purgue o cache de página, de objeto e da CDN e recarregue sem cache; o cabeçalho corrigido pode estar mascarado por uma copia antiga.
```
Limpar cache do plugin de cache (purge all)
Ctrl + Shift + R para recarregar sem cache do navegador
```
Alinhe as versões do Astra: atualize o tema Astra e o Astra Pro Addon para a mesma versão mais recente; versões desencontradas quebram a renderizacao do cabeçalho e do rodape.
```
Plugins -> Atualizar o Astra Pro Addon
Aparencia -> Temas -> Atualizar o tema Astra
```
Verifique header.php e footer.php do tema-filho: se o tema-filho sobrescreve esses arquivos, compare-os com os do tema Astra atual; um override antigo pode ignorar a nova marcacao do cabeçalho.
```
Comparar wp-content/themes/astra-child/header.php com wp-content/themes/astra/header.php
Comparar wp-content/themes/astra-child/footer.php com wp-content/themes/astra/footer.php
```

PHP

// functions.php do tema-filho - registra um cabecalho proprio via gancho do Astra
// quando o Header Footer Builder some ou o Custom Layout para de aplicar apos um update.
add_action( 'astra_header', 'meu_header_de_emergencia', 8 );
function meu_header_de_emergencia() {
    // so injeta o fallback se nenhum cabecalho do Astra Pro foi renderizado
    if ( ! did_action( 'astra_masthead' ) ) {
        get_template_part( 'template-parts/header', 'fallback' );
    }
}

// Forca o Astra a recriar o CSS dinamico em arquivo no proximo carregamento
// (equivale ao botao "Regenerar arquivos de CSS" das opcoes do tema).
if ( function_exists( 'astra_addon_filesystem' ) ) {
    delete_option( 'astra-addon-css-version' );
}

Perguntas frequentes

Por que o header do Astra sumiu logo depois de atualizar o tema?

Quase sempre por uma de três razoes: o CSS dinamico em arquivo ficou defasado, o módulo Header Footer Builder ou Custom Layouts voltou desligado, ou a regra de exibicao do layout perdeu o alvo. Regenere o CSS, reative os módulos e revise a regra de exibicao nessa ordem.

Regenerar o CSS do Astra resolve o cabeçalho sem estilo?

Na maioria dos casos, sim. O Astra grava o CSS calculado em arquivos na pasta de uploads para acelerar o site. Quando esses arquivos ficam velhos ou somem após um update, o cabeçalho carrega sem estilo. Recriar os arquivos forca o Astra a gravar a folha de estilo atual.

O Custom Layout continua publicado mas não aparece. O que houve?

Provavelmente a regra de exibicao (Display Rules) perdeu o alvo na atualização, entao o layout não casa mais com nenhuma página. Abra o Custom Layout, confira o gancho e a condicao de exibicao e reaplique o alvo. Verifique também se o módulo Custom Layouts continua ligado.

Onde reativo o Header Footer Builder no Astra Pro?

Na página de módulos do Astra, dentro das opções do tema, em Habilitar módulos. Uma atualização do Astra Pro Addon pode deixar o módulo desligado, e isso remove o cabeçalho ou o rodape personalizado. Basta religar o módulo e salvar para o builder voltar a renderizar.

O cache pode estar escondendo a correção do cabeçalho?

Sim. Mesmo após regenerar o CSS, o cache de página, de objeto ou da CDN pode continuar servindo a versão antiga do header e do footer. Faca um purge completo de todos os caches e recarregue a página sem cache do navegador para ver o resultado real.

Editei header.php no tema-filho e o cabeçalho quebrou após o update. Por que?

Um header.php sobrescrito no tema-filho não acompanha a nova marcacao que o Astra Pro passa a usar na versão atualizada. Compare o arquivo com o do tema Astra novo e ajuste, ou melhor, remova o override e use o Header Footer Builder ou um Custom Layout via gancho.

Atualizei so o plugin Astra Pro Addon e o footer quebrou. E isso?

Pode ser. O Astra Pro Addon e o tema Astra precisam ficar na mesma versão; quando so um e atualizado, o builder e a renderizacao do rodape ficam desencontrados. Atualize tema e plugin para a versão mais recente e regenere o CSS dinamico em seguida.

Preciso reconstruir o cabeçalho do zero para corrigir?

Raramente. A configuração costuma continuar salva no banco mesmo quando o cabeçalho some da tela. Antes de refazer, regenere o CSS, reative os módulos, revise a regra de exibicao e limpe os caches. Reconstruir so vale se o layout estiver de fato corrompido, e com backup feito antes.

Grave

Como corrigir o Happy Addons que não carrega no Elementor

Quando o Happy Addons não carrega, os widgets do plugin somem do painel do editor Elementor, em geral porque foram desativados no Feature Controller, porque a versão do Elementor ficou abaixo da exigida ou porque o cache de assets do editor ficou desatualizado.

Atenção

Como corrigir o erro de taxonomia no JetEngine

O erro de taxonomia no JetEngine acontece quando a taxonomia registrada na aba Taxonomies não aparece no menu, não fica disponível no post type vinculado ou retorna 404, geralmente por opções de visibilidade desligadas, slug invalido ou regras de reescrita não atualizadas.

Grave

Como corrigir o WooCommerce Builder do Elementor que não edita páginas de loja

O WooCommerce Builder do Elementor não edita páginas de loja quando o Elementor Pro está inativo, o WooCommerce não está instalado, ou o template criado no Theme Builder não tem condições de exibição definidas. Sem isso, as páginas de produto e de catálogo continuam usando o layout padrão do tema, mesmo com o template salvo.

Atenção

Como corrigir o Image Field no ACF PRO

O Image Field do ACF PRO não retorna a URL quando o Return Format do campo está como Image Array ou Image ID, mas o template usa o valor como se fosse a string da URL. O ACF devolve um array ou um número de anexo, então o atributo src da imagem sai quebrado ou vazio.

Atenção

Como corrigir o conflito de Custom Fields entre ACF PRO e JetEngine no WordPress

O conflito de Custom Fields entre ACF PRO e JetEngine ocorre quando os dois plugins registram um campo com o mesmo nome de meta e gravam na mesma chave da tabela wp_postmeta, fazendo um sobrescrever o valor salvo pelo outro.

Atenção

Como corrigir o erro de File Upload por permissões de pasta no ACF PRO

O erro de File Upload por permissões de pasta no ACF PRO acontece quando o campo File usa a media popup nativa do WordPress para enviar um arquivo, mas a pasta wp-content/uploads não tem permissão de escrita para o usuário do servidor web, e o upload falha antes de o arquivo ser anexado ao campo.

Setores

Extensões

Integrações

Como corrigir o erro de Header/Footer no Astra Pro após atualização

O que é o Astra header footer quebrado após atualização?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o Happy Addons que não carrega no Elementor

Como corrigir o erro de taxonomia no JetEngine

Como corrigir o WooCommerce Builder do Elementor que não edita páginas de loja

Como corrigir o Image Field no ACF PRO

Como corrigir o conflito de Custom Fields entre ACF PRO e JetEngine no WordPress

Como corrigir o erro de File Upload por permissões de pasta 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