Estudo de Caso: Categorias Exibindo Posts Errados no WordPress

Ao organizar as páginas de categorias do SEOcomIA, encontramos um comportamento aparentemente estranho: algumas páginas possuíam apenas uma ou duas postagens relacionadas ao tema, mas exibiam vários artigos de outras áreas do site.

À primeira vista, parecia que o WordPress estava “preenchendo” automaticamente os espaços vazios da grade com outros conteúdos. A causa real, porém, era diferente: o bloco Loop de Consulta havia perdido o filtro que restringia os resultados à categoria correspondente.

Este estudo de caso mostra como identificamos o problema, qual configuração estava faltando, por que a grade visual não era a verdadeira causa e como corrigimos as páginas sem precisar recriar toda a estrutura.

O problema encontrado

O site utiliza páginas específicas para apresentar conteúdos agrupados por temas e subtemas. Entre elas estão áreas como Performance, Auditoria, Conteúdo e Topic Clusters, Backlinks, Palavras-chave, Penalidades e outras categorias editoriais.

Em algumas dessas páginas, a estrutura funcionava corretamente: se existiam duas postagens na categoria, apenas aquelas duas apareciam.

Em outras, entretanto, uma categoria com poucos conteúdos apresentava seis postagens ou mais, incluindo artigos completamente diferentes do assunto daquela página.

Isso criava dois problemas.

  • O usuário encontrava conteúdos sem relação com a seção em que estava navegando.
  • A organização temática do site deixava de representar corretamente a estrutura editorial planejada.

Para um projeto que trabalha com SEO, arquitetura e organização temática, manter essas relações claras também é importante para que páginas e conteúdos relacionados sejam apresentados de forma coerente.

Nossa primeira suspeita: a grade

O comportamento apareceu justamente em páginas que utilizavam uma grade de três colunas.

Por isso, inicialmente parecia razoável imaginar que o padrão de grade estivesse solicitando seis postagens e, quando não encontrava quantidade suficiente dentro daquela categoria, procurasse outros conteúdos para preencher os espaços.

Essa interpretação parecia ainda mais provável porque o código problemático continha uma configuração semelhante a esta:

<!-- wp:query {"queryId":7,"query":{
"perPage":6,
"postType":"post",
"order":"desc",
"orderBy":"date",
"sticky":"exclude",
"inherit":false
},
"metadata":{
"patternName":"core/query-grid-posts",
"name":"Grade"
}} -->

O bloco realmente estava configurado para exibir seis posts em uma grade.

Mas esse não era o problema principal.

A grade controla a apresentação, não a categoria

No bloco Query Loop, existem duas funções que precisam ser diferenciadas.

  • Consulta: define quais conteúdos serão recuperados.
  • Post Template: define como cada resultado será apresentado.

É no Post Template que podemos escolher uma disposição em lista ou grade, incluir título, data, resumo, imagem destacada e outros elementos.

Já a seleção das postagens pertence à consulta.

Portanto, configurar:

"layout":{"type":"grid","columnCount":3}

determina que os resultados sejam apresentados em três colunas. Isso não informa ao WordPress que os resultados precisam pertencer a determinada categoria.

O detalhe que estava faltando

Ao comparar uma página problemática com outra que funcionava corretamente, encontramos a diferença decisiva.

A página correta possuía uma consulta semelhante a esta:

"inherit":false,
"taxQuery":{
  "include":{
    "category":[139]
  }
}

Já na página problemática existia:

"inherit":false

mas não existia nenhum taxQuery.

Esse era o problema.

O que o taxQuery faz?

taxQuery é a parte da consulta utilizada para filtrar conteúdos por taxonomias, como categorias e tags.

Neste exemplo:

"taxQuery":{
  "include":{
    "category":[139]
  }
}

a consulta determina que os resultados precisam pertencer à categoria cujo identificador é 139.

Se apenas duas postagens estiverem atribuídas a essa categoria, apenas duas serão retornadas.

A consulta não precisa procurar outros conteúdos para completar seis posições da grade.

Sem esse filtro, entretanto, o bloco continua podendo solicitar seis postagens, mas não possui uma regra dizendo que elas precisam pertencer àquela categoria específica.

Os posts não eram realmente aleatórios

Esse foi outro aprendizado importante.

Visualmente, os conteúdos pareciam aleatórios porque não tinham relação com a página em que estavam sendo apresentados.

Na realidade, o bloco estava seguindo sua consulta geral, normalmente organizada pelos posts mais recentes, porque nenhum filtro de categoria havia sido aplicado.

Portanto, o comportamento não era:

“A categoria possui apenas duas postagens, então o WordPress vai procurar quatro conteúdos aleatórios para completar a grade.”

O comportamento era mais próximo de:

“A consulta solicita postagens, mas não possui um filtro dizendo de qual categoria elas devem vir.”

Essa diferença é importante porque muda completamente a solução.

A solução adotada

Em vez de tentar corrigir o problema modificando a quantidade de colunas ou reduzindo o número de posts exibidos, restauramos primeiro uma estrutura básica de consulta.

O padrão utilizado passou a seguir esta lógica:

<!-- wp:query {"queryId":1,"query":{
"perPage":10,
"pages":0,
"offset":0,
"postType":"post",
"order":"desc",
"orderBy":"date",
"author":"",
"search":"",
"exclude":[],
"sticky":"",
"inherit":false,
"taxQuery":{
  "include":{
    "category":[ID_DA_CATEGORIA]
  }
},
"parents":[],
"format":[],
"excludeCurrent":null
}} -->

O ponto fundamental não é o número 10 de posts nem o queryId.

O elemento realmente importante para o problema analisado é:

"taxQuery":{
  "include":{
    "category":[ID_DA_CATEGORIA]
  }
}

Cada página recebe o identificador correspondente à sua própria categoria.

O queryId não é o ID da categoria

Esse detalhe também pode gerar confusão quando observamos o código do Gutenberg.

Uma configuração como:

"queryId":7

não significa que a consulta esteja filtrando a categoria 7.

O identificador utilizado no filtro aparece explicitamente dentro de taxQuery.

Por isso, alterar apenas o queryId não resolveria o problema.

Por que voltamos ao formato simples antes da grade?

Durante a correção, adotamos uma estratégia simples: primeiro restaurar a consulta funcionando corretamente e somente depois aplicar novamente a apresentação em grade.

Isso ajudou a separar duas perguntas diferentes:

  1. Estamos recuperando as postagens corretas?
  2. Como queremos apresentar essas postagens?

Depois que a primeira pergunta estava resolvida, alterar o Post Template para três colunas passou a ser apenas uma decisão visual.

Essa separação tornou o diagnóstico muito mais simples.

Como o problema provavelmente surgiu

Algumas das páginas haviam sido alteradas antes da definição do padrão final utilizado no site.

Ao selecionar ou substituir padrões de Query Loop no editor, é possível alterar não apenas a aparência, mas também atributos da própria consulta.

No nosso caso, determinadas páginas passaram a utilizar o padrão identificado como core/query-grid-posts, mas sem conservar o filtro específico da categoria.

Por isso, páginas visualmente semelhantes apresentavam comportamentos diferentes.

Como identificar esse problema no editor

Não é obrigatório editar código para verificar a configuração.

O próprio WordPress permite selecionar o bloco Query Loop e trabalhar com uma consulta personalizada.

Na configuração do bloco, o tipo de consulta deve permitir filtros. Entre esses filtros estão taxonomias, que podem limitar os resultados por categoria ou tag.

Uma forma prática de conferir uma página é:

  1. Abrir a página no editor.
  2. Selecionar o Loop de Consulta pela Visão em Lista.
  3. Conferir se a consulta é personalizada.
  4. Abrir os filtros.
  5. Verificar se a categoria correta está selecionada.
  6. Somente depois selecionar o Modelo de Post para alterar lista ou grade.

Essa divisão entre consulta e apresentação é uma das principais lições deste caso.

O impacto na arquitetura temática

O problema poderia ser considerado apenas visual, mas havia também uma questão de arquitetura.

Se uma página chamada “Performance” apresenta artigos sobre assuntos completamente diferentes, ela deixa de cumprir corretamente sua função de agrupar conteúdos relacionados.

O mesmo vale para páginas dedicadas a auditoria, backlinks, palavras-chave, penalidades ou outros temas.

Uma organização coerente ajuda usuários a navegar entre conteúdos relacionados e fortalece a lógica de arquitetura temática e Topic Clusters.

Essa estrutura também pode ser complementada por uma estratégia de links internos, conectando artigos relacionados além das páginas de categoria.

O que não fizemos

Algumas soluções poderiam esconder visualmente o problema sem realmente corrigi-lo.

  • Reduzir o número de posts exibidos.
  • Alterar de três para duas colunas.
  • Excluir manualmente os posts incorretos.
  • Criar uma página diferente para cada quantidade de conteúdo.
  • Esperar que a situação desaparecesse quando mais artigos fossem publicados.

Nenhuma dessas opções resolveria a causa: a consulta continuaria sem saber qual categoria deveria utilizar.

Um padrão reutilizável para novas páginas

Depois de identificar a causa, passamos a utilizar uma estrutura-base para páginas desse tipo.

O processo passou a ser:

  1. Criar ou identificar a categoria.
  2. Confirmar seu ID.
  3. Criar a página correspondente.
  4. Inserir o Query Loop.
  5. Definir a consulta como personalizada.
  6. Filtrar explicitamente pela categoria.
  7. Testar se aparecem somente os conteúdos esperados.
  8. Configurar o Post Template como grade.
  9. Definir títulos, datas, imagens e demais elementos visuais.

Esse padrão reduz a possibilidade de uma alteração visual quebrar silenciosamente a lógica editorial da página.

O que este caso ensina sobre diagnóstico

O principal aprendizado não está apenas no código taxQuery.

O caso mostra a importância de separar sintomas de causas.

O sintoma era:

“A grade está mostrando artigos errados.”

A causa era:

“A consulta não está filtrada pela categoria correta.”

Alterar a grade atacaria o sintoma. Restaurar o filtro corrigiu a causa.

Esse raciocínio também é útil em uma auditoria e diagnóstico: antes de aplicar uma correção, é importante entender qual configuração realmente produz o comportamento observado.

Modelos generativos também podem ajudar na análise

Em situações como essa, ferramentas de Inteligência Artificial podem ajudar a comparar dois blocos de código e localizar diferenças estruturais.

Uma ferramenta de IA pode, por exemplo, comparar uma página funcional com outra problemática e destacar atributos ausentes.

O ChatGPT também pode ajudar a interpretar o código dos blocos Gutenberg, desde que a comparação seja feita com uma referência funcional e que as alterações sejam testadas no próprio site.

Em projetos de Marketing Digital, esse tipo de diagnóstico reduz retrabalho em estruturas de conteúdo. Uma rotina de Automação também poderia, em projetos maiores, verificar configurações repetitivas e identificar diferenças entre páginas que deveriam seguir o mesmo padrão.

A configuração técnica também faz parte da otimização

Um site pode ter bons artigos e ainda apresentar problemas porque sua estrutura não relaciona corretamente esses conteúdos.

Por isso, arquitetura, consultas, navegação, URLs e filtros também devem fazer parte de uma revisão de otimização técnica.

A organização do conteúdo não existe apenas dentro dos textos. Ela também depende da maneira como o sistema publica, agrupa e apresenta as páginas.

Checklist para evitar o mesmo problema

  • Confira se o Loop de Consulta é personalizado.
  • Verifique se existe filtro de taxonomia.
  • Confirme se a categoria selecionada é a correta.
  • Não confunda queryId com o ID da categoria.
  • Teste a consulta antes de configurar a grade.
  • Confira o resultado quando a categoria possui apenas uma ou duas postagens.
  • Use uma página funcional como referência ao corrigir estruturas antigas.
  • Depois de alterar padrões visuais, confira novamente os filtros.

Conclusão

O problema das categorias do SEOcomIA parecia inicialmente um comportamento da grade, mas a investigação mostrou que a causa estava na própria consulta.

Algumas páginas haviam perdido o filtro taxQuery. Sem ele, o Loop de Consulta continuava recuperando postagens sem restringi-las ao tema correspondente.

A correção foi simples depois que a causa ficou clara: restaurar o filtro da categoria e somente depois configurar a apresentação em grade.

O caso também deixou uma regra útil para futuras páginas: primeiro definir quais conteúdos devem aparecer; depois decidir como eles serão apresentados.

Fontes consultadas

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Rolar para cima