🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o widget Post Grid que não exibe posts no Essential Addons

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Widget Post Grid não exibe posts no Essential Addons EN: Essential Addons Post Grid not displaying posts
Severidade Atenção
Descrição O widget Post Grid do Essential Addons mostra a grade vazia quando a Query do widget aponta para uma fonte sem conteúdo: um Source de termo sem posts publicados, um Custom Post Type não suportado, um filtro de categoria que não casa ou um Offset maior que o total de posts.

O que é Post Grid do Essential Addons sem exibir posts?

O Post Grid do Essential Addons é um widget de conteúdo dinâmico do Elementor que monta uma grade a partir de uma WP_Query interna. Quem decide o que aparece é a aba Content do widget: o Source (Post, Page ou Custom Post Type), os filtros de termo (categorias e tags em Include ou Exclude), o Posts Per Page e o Offset. A grade fica vazia quando essa consulta retorna zero posts, e não porque o widget está quebrado. Como o editor do Elementor às vezes mostra um placeholder de demonstração, o problema só fica visível ao salvar e abrir a página no frontend, onde a WP_Query roda contra o conteúdo real do site.

Como identificar

  • A grade do Post Grid aparece totalmente vazia no frontend, sem cards de post, enquanto o restante da página do Elementor renderiza normalmente
  • O editor do Elementor mostra posts de exemplo (placeholder) dentro do widget, mas no site publicado a área fica em branco
  • Ao trocar o Source de ‘Post’ para um Custom Post Type no painel do widget, a lista some e a grade não atualiza com os itens daquele tipo
  • A grade fica vazia só quando há um filtro de categoria ou tag aplicado em Include Term, e volta a mostrar posts ao remover o filtro
  • A primeira página mostra menos posts do que deveria ou nada, porque o valor de Offset está maior que o total de posts disponíveis
  • No console do navegador não há erro de JavaScript, e o código-fonte da página mostra a estrutura do widget sem nenhum item de post dentro dela

Como prevenir

  • Antes de publicar, abra a página em uma aba anônima e confirme que o Post Grid está renderizando posts reais, e não o placeholder de demonstração do editor
  • Ao usar um Custom Post Type como Source, garanta que ele foi registrado como público e que existe ao menos um post publicado daquele tipo antes de montar a grade
  • Documente os filtros de Include Term e Exclude Term de cada Post Grid, para que ao reorganizar categorias ninguém esvazie a grade sem perceber
  • Mantenha o Offset em zero a menos que exista um motivo claro, e revise o Posts Per Page sempre que o número de posts publicados cair

Causa

  • O Source na aba Content do widget está em 'Custom Post Type' apontando para um tipo registrado sem a flag public ou sem posts publicados, e a WP_Query do widget retorna zero itens.
  • Um termo foi escolhido em Include Term (categoria ou tag) na Query do widget, mas nenhum post publicado está atribuído a esse termo, então o filtro elimina todos os resultados.
  • O campo Offset na seção Query está com um número maior ou igual ao total de posts publicados (por exemplo Offset 10 num site com 8 posts), e a consulta começa depois do último post existente.
  • Os posts da fonte escolhida estão com status Rascunho, Privado ou Pendente, e o Post Grid lista apenas posts com status Publicado por padrão.
  • Um termo válido foi colocado em Exclude Term abrangendo a única categoria que tinha posts, removendo todo o conteúdo da grade.
  • O widget está apontando para o Source 'Related' ou 'Current Query' dentro de um template do Theme Builder, e fora do contexto correto (página de arquivo ou single) essa consulta não tem posts para resolver.

Como resolver

  1. Confirme que a Query está retornando zero posts: Edite a página com o Elementor, selecione o widget Post Grid e abra a aba Content. Verifique no frontend, em uma aba anônima, se a grade está realmente vazia para o visitante. O objetivo deste passo é confirmar que o problema é a consulta do widget, e não cache ou um conflito de tema.
    Elementor -> editar página -> selecionar o widget Post Grid -> aba Content
  2. Volte o Source para Post e teste sem filtros: Na seção Query da aba Content, troque o Source de volta para Post e remova qualquer termo de Include Term e Exclude Term. Salve e recarregue o frontend. Se os posts voltarem a aparecer, a causa está na configuração anterior de fonte ou de filtro, e você isola o ajuste a partir daí.
    aba Content -> Query -> Source -> Post
    aba Content -> Query -> Include Term -> (vazio)
    aba Content -> Query -> Exclude Term -> (vazio)
  3. Ajuste Posts Per Page e zere o Offset: Ainda na seção Query, defina um Posts Per Page compatível com o total de posts do site e coloque o Offset em zero. Um Offset alto pula os primeiros posts e pode esvaziar a grade quando o site tem poucos itens publicados.
    aba Content -> Query -> Posts Per Page -> 6
    aba Content -> Query -> Offset -> 0
  4. Garanta que a fonte tem posts publicados e visíveis: Confira no painel do WordPress se a fonte escolhida tem conteúdo com status Publicado, porque o Post Grid ignora rascunhos e privados. Se a fonte for um Custom Post Type, o tipo precisa estar registrado como público e ter posts publicados para o widget conseguir listar.
    Posts -> Todos os posts -> filtrar por Publicado
    checar o Custom Post Type em Source com posts publicados e public habilitado
  5. Regenere os assets e limpe o cache: Depois de ajustar a consulta, salve a página, regenere os arquivos do Essential Addons e limpe o cache do site e do plugin de cache. Isso evita que a página antiga, com a grade vazia, continue sendo servida ao visitante depois da correção.
    Essential Addons -> Settings -> Save Default Settings
    Elementor -> Tools -> Regenerate CSS & Data
PHP
function full_registrar_cpt_para_post_grid() {
    register_post_type( 'projeto', array(
        'label'        => 'Projetos',
        'public'       => true,
        'show_in_rest' => true,
        'has_archive'  => true,
        'supports'     => array( 'title', 'editor', 'thumbnail' ),
    ) );
}
add_action( 'init', 'full_registrar_cpt_para_post_grid' );

Perguntas frequentes

Por que o Post Grid mostra posts no editor do Elementor mas fica vazio no site publicado?
O editor do Elementor exibe um placeholder de demonstração quando a consulta do widget não casa com o conteúdo real. No frontend a WP_Query roda contra os posts do site e, se o Source, o filtro de termo ou o Offset não retornam nada, a grade aparece vazia. Por isso a diferença entre o editor e a página publicada.
Configurei um Custom Post Type no Source e o Post Grid não exibe nada, o que fazer?
Verifique se o Custom Post Type foi registrado como público e se tem posts com status Publicado. Tipos registrados sem a flag public ou sem conteúdo publicado fazem a WP_Query do widget retornar zero itens. Garanta também que o tipo realmente aparece na lista de Source do widget.
A grade fica vazia só quando aplico um filtro de categoria, por quê?
Quando você escolhe um termo em Include Term, o Post Grid lista apenas posts atribuídos àquela categoria ou tag. Se nenhum post publicado está nesse termo, o filtro elimina todos os resultados. Confira no painel se a categoria selecionada tem posts publicados ou remova o filtro para confirmar.
O que o campo Offset faz e como ele esvazia o Post Grid?
O Offset diz ao widget quantos posts pular antes de começar a montar a grade. Se o Offset for igual ou maior que o total de posts publicados, a consulta começa depois do último post e nada é exibido. Coloque o Offset em zero para listar a partir do primeiro post.
O Post Grid lista rascunhos e posts privados?
Não. Por padrão o widget exibe apenas posts com status Publicado. Conteúdo em Rascunho, Pendente ou Privado é ignorado pela consulta. Publique os posts ou ajuste o fluxo de revisão para que a grade volte a mostrar o conteúdo esperado.
Usei o Source Current Query dentro de um template e a grade não tem posts, qual o motivo?
O Source Current Query e o Related dependem do contexto de uma página de arquivo ou de um single dentro do Theme Builder. Fora desse contexto, a consulta não tem posts para resolver e a grade fica vazia. Use esses tipos de Source apenas em templates de arquivo ou de post.
Preciso limpar o cache depois de corrigir a Query do Post Grid?
Sim. Depois de ajustar a consulta, regenere os assets do Essential Addons e limpe o cache do site e do plugin de cache. Sem isso, a versão antiga da página, com a grade vazia, continua sendo entregue ao visitante mesmo com a configuração já corrigida.
O problema do Post Grid vazio também acontece na versão Pro do Essential Addons?
Sim. Os recursos de Query avançada da versão Pro usam a mesma lógica de Source, filtro de termo e Offset. Se a consulta não casa com o conteúdo publicado, a grade fica vazia tanto na versão gratuita quanto na Pro. A correção é a mesma: revisar a fonte, os filtros e o Offset.

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