🎉 USE O CUPOM FIM.DE.SEMANA.FULL | 20% OFF acima de R$ 100,00

Como corrigir o layout quebrado do Blog Pro no Astra Pro no WordPress

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Layout do blog do Astra Pro quebrado no frontend EN: Astra Pro Blog Pro layout broken on frontend
Severidade Atenção
Descrição O layout quebrado do Blog Pro no Astra Pro acontece quando o módulo Blog Pro não esta ativado nas Astra Options, quando o cache serve um CSS antigo, ou quando um layout personalizado sobrepoe o arquivo do blog, fazendo o grid e as colunas não aplicarem no frontend.

O que é layout quebrado do Blog Pro no Astra Pro?

O layout do Blog Pro no Astra Pro e controlado pelo módulo Blog Pro, um dos addons que o Astra Pro entrega e que precisa ser ativado individualmente no painel de Astra Options. Quando ativo, ele libera no Personalizar opções avancadas de layout para a página de posts e os arquivos: número de colunas do grid, estrutura do post, posicao da imagem destacada e os meta dados exibidos. O Astra gera essas regras como CSS dinâmico e as serve no frontend.

Quando o layout aparece quebrado, o blog exibe os posts empilhados em uma única coluna sem o grid esperado, perde o espacamento, ou ignora a posicao da imagem destacada que você definiu no Personalizar. Isso ocorre porque a configuração salva não chega ao visitante: o módulo foi desativado, um plugin de cache esta servindo um CSS antigo, ou um layout personalizado do Astra ou do construtor de páginas assumiu a renderizacao do arquivo no lugar do template do blog.

Como identificar

  • Os posts do blog aparecem empilhados em uma única coluna no frontend, mesmo com o grid de duas ou três colunas definido no Personalizar.
  • O espacamento, as bordas e a posicao da imagem destacada definidos em Personalizar -> Blog não aparecem para o visitante.
  • As opções de layout do Blog somem do Personalizar e não ha como configurar colunas ou estrutura do post.
  • O layout aparece correto na previa do Personalizar, mas quebra ao abrir a página do blog em uma aba anonima.
  • Depois de uma atualização do Astra Pro ou do tema, o blog volta para o layout padrão de coluna única sem motivo aparente.
Antes de começar: Antes de regenerar CSS, mexer em Layouts Personalizados ou alterar plugins de cache em producao, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o layout do blog quebre ainda mais.

Como prevenir

  • Após atualizar o Astra Pro ou o tema, confirme que o módulo Blog Pro continua ativo e regenere o CSS do Astra antes de validar o blog.
  • Sempre que ajustar o layout do blog no Personalizar, limpe o cache do site e da CDN para que o visitante receba o CSS atualizado.
  • Mantenha uma lista de exclusão no plugin de performance para o CSS do Astra, evitando que Remove Unused CSS apague as classes de grid do blog.
  • Documente quais Layouts Personalizados apontam para arquivos e blog, para não criar dois templates competindo pela mesma página.

Causa

  • O módulo Blog Pro esta desativado em Aparencia -> Astra Options: sem o addon ligado, as opções avancadas de layout do blog não são registradas no Personalizar nem aplicadas no frontend.
  • Um plugin de cache de página ou de minificacao de CSS (como WP Rocket ou Autoptimize) esta servindo uma versão antiga da folha de estilo, sem as regras de grid recem-salvas do blog.
  • O cache de CSS dinâmico do próprio Astra ficou desatualizado após uma atualização do tema ou do addon, e o arquivo de estilo gerado não reflete as configurações atuais do Personalizar.
  • Um Layout Personalizado do Astra (Custom Layouts) ou um template de arquivo do construtor de páginas esta com a condicao de exibicao apontando para o blog, sobrepondo o template e ignorando as opções do Blog Pro.
  • Plugins de otimização com Remove Unused CSS ou combinacao de arquivos removeram as classes de grid do Astra por engano, deixando o markup do blog sem o estilo das colunas.

Como resolver

  1. Confirme que o módulo Blog Pro esta ativado: No painel do WordPress, abra as Astra Options e verifique se o módulo Blog Pro esta com o interruptor ligado. Sem o addon ativo, as opções avancadas de layout do blog nem aparecem no Personalizar e nada e aplicado no frontend.
    Painel WP -> Aparencia -> Astra Options
    Localize o módulo 'Blog Pro' e ligue o interruptor (Activate)
  2. Revise as opções de layout do blog no Personalizar: Abra o Personalizar e va até a seção Blog. Confirme o número de colunas do grid, a estrutura do post e a posicao da imagem destacada, salve e publique de novo para forcar o Astra a regravar o CSS dinâmico do blog.
    Painel WP -> Aparencia -> Personalizar -> Blog -> Arquivo do Blog
    Defina as colunas do grid e a estrutura do post
    Clique em Publicar para salvar as configurações
  3. Limpe o cache do site e o CSS dinâmico do Astra: Limpe o cache do plugin de cache e da CDN e regenere o CSS do Astra. Um CSS antigo em cache e a causa mais comum de o layout do blog ficar certo no Personalizar e quebrado para o visitante.
    Limpe o cache do plugin de cache (ex.: WP Rocket -> Limpar Cache)
    Painel WP -> Aparencia -> Astra Options -> Regenerar arquivos de CSS do Astra
    Recarregue a página do blog em uma aba anonima para validar
  4. Verifique Layouts Personalizados sobrepondo o blog: Procure por um Custom Layout do Astra ou um template do construtor de páginas com condicao de exibicao apontando para a página de posts ou para os arquivos. Esse layout assume a renderizacao e ignora as opções do Blog Pro.
    Painel WP -> Aparencia -> Custom Layouts
    Abra layouts do tipo Archive/Blog e revise as Display Rules
    Ajuste ou desative a condicao que aponta para o blog
  5. Teste contra conflito de otimização de CSS: Se o grid ainda não aplicar, desative temporariamente os recursos de combinar CSS e Remove Unused CSS do plugin de performance e recarregue o blog. Se o layout voltar, exclua o CSS do Astra dessas otimizacoes em vez de desliga-las por completo.
    Painel WP -> plugin de performance -> desligue 'Combine CSS' e 'Remove Unused CSS'
    Recarregue a página do blog e confira o grid
    Adicione o CSS do Astra a lista de exclusão da otimização
PHP
<?php
// Forca o Astra a regravar o CSS dinamico do blog quando ele fica em cache antigo.
// Coloque em um plugin utilitario e remova depois de regenerar.
add_action( 'init', 'full_astra_regenera_css_blog' );
function full_astra_regenera_css_blog() {
    if ( ! is_admin() || ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // Astra expoe um helper para limpar o cache de CSS dinamico.
    if ( class_exists( 'Astra_Cache_Base' ) && method_exists( 'Astra_Cache_Base', 'refresh_assets' ) ) {
        Astra_Cache_Base::refresh_assets( 'astra' );
    } elseif ( function_exists( 'astra_clear_all_assets_cache' ) ) {
        astra_clear_all_assets_cache();
    }
}

Perguntas frequentes

Por que o layout do blog do Astra Pro aparece quebrado so no frontend
Quase sempre o problema e CSS em cache. O Personalizar usa uma previa ao vivo, mas o visitante recebe a folha de estilo gerada e armazenada em cache. Limpe o cache do plugin e da CDN e regenere o CSS do Astra em Astra Options para o grid voltar a aplicar.
Onde fica o módulo Blog Pro no Astra Pro
Ele fica em Aparencia, dentro do painel de Astra Options, na lista de módulos do Astra Pro. Cada módulo e ativado individualmente por um interruptor. Com o Blog Pro desligado, as opções avancadas de layout do blog nem aparecem no Personalizar.
As opções de layout do blog sumiram do Personalizar, o que fazer
Isso indica que o módulo Blog Pro esta desativado ou que o plugin Astra Pro não esta ativo. Confirme a ativacao do Astra Pro e ligue o módulo Blog Pro em Astra Options. As seções de layout do blog voltam ao Personalizar assim que o addon e ativado.
Atualizei o Astra e o blog voltou para uma coluna so
Uma atualização pode deixar o CSS dinâmico do tema desatualizado. Va em Astra Options e use a opção de regenerar os arquivos de CSS do Astra, depois limpe o cache do site. Confira também se o módulo Blog Pro continuou ativado após a atualização.
Um plugin de cache pode quebrar o layout do blog do Astra
Sim. Recursos de combinar e minificar CSS e principalmente o Remove Unused CSS podem apagar as classes de grid do Astra. Adicione o CSS do Astra a lista de exclusão dessas otimizacoes em vez de desligar o plugin de performance inteiro.
Por que o layout muda dependendo da página do blog que abro
Provavelmente ha um Layout Personalizado do Astra ou um template de arquivo do construtor de páginas com condicao de exibicao apontando para parte do blog. Esse layout sobrepoe o template padrão e ignora as opções do Blog Pro. Revise as Display Rules em Custom Layouts.
Preciso editar código para corrigir o layout do Blog Pro
Na maioria dos casos não. Ativar o módulo, ajustar o Personalizar e limpar o cache resolve. Editar código so e necessário para forcar a regeneracao do CSS por hook ou excluir o CSS do Astra de uma otimização agressiva, como mostra o exemplo desta página.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes