Custom Layouts do Astra não aplicam: como corrigir

Tipo Page Builders

Nome do erro Custom Layouts não aplicam no Astra Pro EN: Astra Pro Custom Layouts not applying

Severidade Grave

Descrição Quando os Custom Layouts do Astra não aplicam, um cabeçalho, rodape, hook ou template do Site Builder do Astra Pro fica invisivel em páginas especificas, mesmo salvo. A causa quase sempre esta nas Display Rules: alvo errado em Display On, exclusão em Do Not Display On vencendo, ou outro layout com prioridade maior assumindo o local.

O que é os Custom Layouts do Astra que não aplicam?

Os Custom Layouts do Site Builder do Astra Pro permitem criar cabeçalhos, rodapes, blocos em hooks, páginas 404 e templates de Single e Archive sem tema filho. Cada layout so aparece onde as Display Rules mandam: a opção Display On define os alvos (site inteiro, um grupo de posts ou páginas, ou um alvo específico) e a opção Do Not Display On adiciona exclusoes. Quando o layout não aplica numa página, na prática a regra de exibicao daquele layout não alcanca aquela página, foi excluida por uma regra de exclusão, ou perdeu para outro layout de prioridade maior no mesmo local.

Como identificar

O layout aparece no preview do editor e na home, mas some em páginas, posts ou arquivos especificos do site.
O cabeçalho ou rodape do Site Builder volta a ser o do tema padrão apenas em algumas URLs.
Após definir uma exclusão em Do Not Display On, o layout some de páginas onde antes aparecia.
Dois custom layouts do mesmo tipo disputam o mesmo local e só um deles renderiza.
O layout aparece para você logado como admin, mas o visitante deslogado não o vê.

Como prevenir

Use Display On com o alvo mais amplo que faca sentido e reserve Do Not Display On apenas para as poucas excecoes reais
Padronize números de prioridade distintos entre layouts do mesmo tipo para evitar disputa pelo mesmo local
Após salvar uma Display Rule, teste a página afetada numa aba anonima e limpe o cache para confirmar o resultado real

Causa

A opção Display On do layout aponta para um alvo que não inclui a página afetada (ex.: definida como Specific Pages com a página errada, ou um Post Type que não cobre aquela URL).
Uma regra em Do Not Display On (Exclusion Rule) cobre a página e vence o Display On, removendo o layout daquele local.
Existe outro custom layout do mesmo tipo (header/footer/hook) com número de prioridade menor, que tem precedencia e assume o local.
O módulo Custom Layouts (Site Builder) esta desativado em Astra -> Dashboard, ou o plugin Astra Pro (Astra Addon) não esta ativo na instalação.
A regra Display for Users limita o layout a um perfil ou estado de login (ex.: somente Logged In), escondendo-o do visitante anonimo.
Plugin de cache de página ou CDN servindo o HTML antigo da URL, de antes da regra de exibicao ser ajustada.

Como resolver

Confira o alvo em Display On: abra o custom layout no Site Builder e revise a opção Display On. Garanta que o alvo cobre a página afetada, em vez de um alvo estreito demais que a deixa de fora. Os caminhos abaixo mostram onde verificar.
```
Aparência -> Custom Layouts -> (abra o layout) -> Settings -> Display Rules
Display On: Entire Website ou Singulars / Archives ou Specific Pages
```
Revise as exclusoes em Do Not Display On: uma exclusão vence o Display On. Se a página afetada (ou um grupo que a contem) estiver listada na exclusão, remova-a para o layout voltar a aparecer ali.
```
Display Rules -> Do Not Display On (Exclusion Rule) -> remova a página afetada
```
Ajuste a prioridade entre layouts concorrentes: quando dois layouts do mesmo tipo miram o mesmo local, o de número de prioridade menor vence. Defina prioridades distintas para que o layout certo assuma a página.
```
Settings -> Priority: número menor = maior precedência (ex.: 5 vence 10)
```
Garanta o módulo e a licenca ativos: o recurso depende do Astra Pro (Astra Addon) e do módulo Site Builder habilitado. Confirme que ambos estão ativos antes de seguir.
```
Aparência -> Astra -> Dashboard -> ative o módulo Custom Layouts / Site Builder
Plugins -> confirme Astra Pro (Astra Addon) ativo e licença válida
```
Cheque a regra Display for Users: se o layout some so para o visitante anonimo, a restricao por perfil ou estado de login esta filtrando a exibicao. Ajuste para incluir o público desejado.
```
Display Rules -> Display for Users -> inclua Logged Out / All Users conforme o público
```
Limpe cache e atualize os permalinks: regras de exibicao recem-salvas podem ficar presas em HTML antigo. Limpe o cache do site e do CDN e regrave os permalinks para o Site Builder reler as regras.
```
Configurações -> Links permanentes -> Salvar alterações (sem mudar nada)
limpe o cache do plugin de cache e do CDN
```

PHP

// mu-plugin de diagnóstico: lista os custom layouts do Astra que miram a URL atual
// e mostra Display On / Do Not Display On / prioridade. Some ?astra_debug_layouts=1 na URL (admin).
add_action( 'wp', function () {
    if ( ! is_user_logged_in() || ! current_user_can( 'manage_options' ) ) {
        return;
    }
    if ( ! isset( $_GET['astra_debug_layouts'] ) ) {
        return;
    }
    $layouts = get_posts( array(
        'post_type'      => 'astra-advanced-hook', // CPT dos Custom Layouts do Astra Pro
        'posts_per_page' => -1,
        'post_status'    => 'publish',
    ) );
    foreach ( $layouts as $l ) {
        $rules    = get_post_meta( $l->ID, 'ast-advanced-hook-location', true ); // Display On
        $exclude  = get_post_meta( $l->ID, 'ast-advanced-hook-exclusion', true ); // Do Not Display On
        $priority = get_post_meta( $l->ID, 'ast-advanced-hook-priority', true );
        error_log( sprintf(
            'Astra Layout #%d "%s" | priority=%s | display_on=%s | exclude=%s',
            $l->ID, $l->post_title, $priority,
            wp_json_encode( $rules ), wp_json_encode( $exclude )
        ) );
    }
} );

Perguntas frequentes

Por que meu custom layout aparece na home mas some em uma página?

Quase sempre porque o Display On daquele layout não cobre a página afetada, ou porque uma regra em Do Not Display On a exclui. Abra o layout no Site Builder, amplie o alvo do Display On e remova a página das exclusoes para ele voltar a renderizar ali.

Display On e Do Not Display On entram em conflito: qual vence?

A exclusão vence. O Do Not Display On funciona como Exclusion Rule sobre o Display On: o layout aparece em tudo que o Display On define, menos no que o Do Not Display On lista. Se a página sumiu logo após criar uma exclusão, a causa esta na regra de exclusão.

Tenho dois cabeçalhos do Site Builder e so um aparece. Por que?

Quando dois custom layouts do mesmo tipo miram o mesmo local, a prioridade decide. O número de prioridade menor tem precedencia e renderiza; o outro fica oculto naquele local. Defina prioridades distintas para o cabeçalho certo assumir a página.

Preciso do Astra Pro para usar Custom Layouts?

Sim. O Site Builder com Custom Layouts e um recurso do Astra Pro (Astra Addon). Se o plugin não estiver ativo, com licenca valida e com o módulo habilitado no Dashboard do Astra, os layouts simplesmente não são aplicados no frontend.

O layout aparece para mim logado, mas o visitante não ve. O que houve?

A regra Display for Users esta filtrando por perfil ou estado de login. Se estiver definida como Logged In, o visitante anonimo não ve o layout. Ajuste a regra para incluir Logged Out ou All Users conforme o público que deve enxergar o conteúdo.

Mudei a Display Rule mas a página não atualizou. O que fazer?

Regras novas podem ficar presas no cache da página. Limpe o cache do plugin de cache e do CDN e regrave os permalinks em Configurações -> Links permanentes (Salvar sem mudar nada). Depois teste a URL numa aba anonima para ver o resultado real, sem cache do navegador.

Custom Layout funciona com qualquer tema?

Não. O Site Builder e parte do tema Astra com o Astra Pro; ele substitui cabeçalho, rodape e templates do próprio Astra. Em outro tema os hooks e áreas que o layout mira não existem, entao a aplicação não acontece. O tema ativo precisa ser o Astra.

Como sei se o problema e a regra ou o cache?

Revise primeiro Display On, Do Not Display On e prioridade no Site Builder. Se a regra parece correta, limpe o cache e teste numa aba anonima: se o layout aparece sem cache, era HTML antigo; se continua ausente com a regra certa, revise novamente o alvo e as exclusoes.

Atenção

Como corrigir o erro de loop em Repeater aninhado no ACF PRO

O erro de loop em Repeater aninhado no ACF PRO acontece quando um have_rows de um Repeater filho e percorrido sem chamar the_row, ou quando o nome do sub campo não casa, gerando loop infinito com tela branca ou nenhuma linha exibida.

Atenção

Como corrigir o Modal Popup do Ultimate Addons que não abre no WordPress

O modal popup do Ultimate Addons não abre quando o tipo de gatilho está mal configurado, quando o elemento de clique não recebe a classe ou ID que dispara o modal, ou quando um conflito de JavaScript interrompe o script do widget antes de o popup ser acionado.

Atenção

Como corrigir o JetTabs que não alterna conteúdo no frontend

O JetTabs não alterna conteúdo no frontend quando o JavaScript do widget não carrega, IDs de aba duplicados colidem ou a otimização de cache adia o script, deixando as abas presas no primeiro item ao clicar.

Grave

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

O erro de compatibilidade do Elementor com o PHP 8.3 acontece quando uma versão antiga do plugin roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o editor ou o front-end. A correção é alinhar o Elementor e o Elementor Pro na última versão e garantir os recursos de PHP exigidos.

Atenção

Como corrigir o JetTricks que não aplica efeitos no Elementor

O JetTricks não aplica efeitos no Elementor quando o plugin ou o Elementor estão inativos ou desatualizados, quando o efeito é verificado apenas no editor (a maioria roda só no frontend publicado) ou quando cache e otimização de JavaScript bloqueiam os scripts do JetTricks.

Atenção

Como corrigir o layout quebrado de páginas de curso entre Tutor LMS e Astra Pro no WordPress

O layout quebrado entre Tutor LMS e Astra na página de curso ocorre quando o template de single course do Tutor entra em conflito com o container, a sidebar ou a largura de conteúdo definidos pelo tema Astra, deixando a página desalinhada, com sidebar indevida ou sobreposta ao cabeçalho.

Setores

Extensões

Integrações

Como corrigir Custom Layouts que não aplicam no Astra Pro

O que é os Custom Layouts do Astra que não aplicam?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de loop em Repeater aninhado no ACF PRO

Como corrigir o Modal Popup do Ultimate Addons que não abre no WordPress

Como corrigir o JetTabs que não alterna conteúdo no frontend

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

Como corrigir o JetTricks que não aplica efeitos no Elementor

Como corrigir o layout quebrado de páginas de curso entre Tutor LMS e Astra Pro no WordPress

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