Receita: hub de conteúdo por tópico
Uma página-hub que lista sozinha os posts de um assunto, com cache e atualização ao publicar.
Neste texto
Que problema esta receita resolve?
Um site com cinquenta artigos sobre o mesmo assunto, sem uma página que os organize, obriga o leitor a depender da busca e deixa os posts mais antigos sem links de entrada. A página-hub resolve os dois problemas: apresenta o tema, indica por onde começar e linka todos os artigos do tópico, e cada novo post entra na lista sem edição manual.
A lógica vem de plugins de hub automático e hub de autoridade que Camillo Dantas desenvolveu. Eles não estão à venda. A receita mostra o raciocínio e o código para você montar o seu.
Quando usar e quando não usar
Use quando há ao menos oito a dez posts coesos sobre um tópico e você consegue escrever uma introdução que oriente o leitor.
Não use:
- para criar dezenas de hubs quase iguais com listas sobrepostas. Cada post deve ter um hub principal;
- se a única coisa da página é a lista. Sem texto editorial, o hub não acrescenta nada à categoria que o WordPress já gera;
- para listar milhares de itens numa só página; pagine ou divida por subtópico.
Pré-requisitos
- Taxonomia consistente: categorias ou tags aplicadas com critério.
- Uma página criada no editor para cada hub (slug próprio, texto de abertura).
- Mu-plugin ou plugin próprio.
- Nível: intermediário.
Passo a passo
- 01Defina os tópicos e a taxonomia que os representa (um slug por hub).
- 02Crie a página do hub e escreva a abertura: o que o tópico cobre, para quem é, por onde começar.
- 03Insira o shortcode com o slug da categoria.
- 04Ative o cache e a invalidação automática.
- 05Revise o hub: títulos claros, ordem útil (cronológica ou manual), sem posts fora do tema.
O código do shortcode
<?php
/**
* Plugin Name: Hub de conteúdo por tópico (receita)
*/
add_shortcode( 'hub_topico', function ( $atts ) {
$atts = shortcode_atts( array(
'categoria' => '',
'limite' => 50,
'ordem' => 'DESC',
), $atts, 'hub_topico' );
$slug = sanitize_title( $atts['categoria'] );
if ( '' === $slug ) {
return '';
}
$limite = max( 1, min( 200, (int) $atts['limite'] ) );
$ordem = ( 'ASC' === strtoupper( $atts['ordem'] ) ) ? 'ASC' : 'DESC';
$chave = 'hub_' . md5( $slug . '|' . $limite . '|' . $ordem );
$html = get_transient( $chave );
if ( false !== $html ) {
return $html;
}
$consulta = new WP_Query( array(
'post_type' => 'post',
'post_status' => 'publish',
'posts_per_page' => $limite,
'orderby' => 'date',
'order' => $ordem,
'category_name' => $slug,
'no_found_rows' => true,
'ignore_sticky_posts' => true,
'update_post_term_cache' => false,
) );
if ( ! $consulta->have_posts() ) {
return '';
}
$html = '<ul class="hub-lista">';
while ( $consulta->have_posts() ) {
$consulta->the_post();
$html .= '<li><a href="' . esc_url( get_permalink() ) . '">' . esc_html( get_the_title() ) . '</a>' .
'<span class="hub-data"> (' . esc_html( get_the_date( 'd/m/Y' ) ) . ')</span></li>';
}
wp_reset_postdata();
$html .= '</ul>';
set_transient( $chave, $html, DAY_IN_SECONDS );
return $html;
} );
// Limpa os hubs quando um post muda de estado ou é salvo.
function hub_limpar_cache() {
global $wpdb;
$wpdb->query(
"DELETE FROM {$wpdb->options}
WHERE option_name LIKE '\_transient\_hub\_%'
OR option_name LIKE '\_transient\_timeout\_hub\_%'"
);
}
add_action( 'save_post_post', 'hub_limpar_cache' );
add_action( 'deleted_post', 'hub_limpar_cache' );
add_action( 'transition_post_status', 'hub_limpar_cache' );
Na página do hub, o editor recebe: [hub_topico categoria="core-web-vitals" limite="40"].
Por que cada escolha:
sanitize_title()e a validação do limite impedem valores estranhos vindos do editor.no_found_rowsdispensa a contagem total de resultados, o que torna a consulta mais barata quando não há paginação.- O transient guarda o HTML pronto por 24 horas. Se o site usa cache de objetos persistente (Redis, Memcached), o transient vai para lá; senão, vai para a tabela
options. - A limpeza usa
LIKEcom o caractere_escapado, porque em SQL o sublinhado é curinga. Sem o escape, a consulta pode apagar transients de outros plugins. - O hook
transition_post_statuscobre publicação, despublicação e agendamento.
Estrutura editorial do hub
Código resolve a lista; a utilidade vem do texto. Um hub com o mínimo editorial tem:
- Uma resposta curta no topo: o que é o tópico em duas ou três frases.
- Uma seção "Comece por aqui" com três a cinco links escolhidos à mão.
- A lista automática, depois dessa seção.
- Links para tópicos vizinhos.
Isso evita a armadilha de listas automáticas parecerem arquivos vazios de sentido.
Como testar
Critério de sucesso: um post novo da categoria aparece no hub sem edição manual e some se for despublicado; o hub carrega sem consultas pesadas.
- Publique um post de teste na categoria e recarregue o hub: ele deve aparecer.
- Despublique-o: deve desaparecer.
- Instale o plugin gratuito Query Monitor em homologação e confira que a consulta do hub roda uma vez e, na segunda visita, não roda (cache).
- Verifique com
wp option list --search="_transient_hub_*" --fields=option_name(WP-CLI) que as chaveshub_existem após a visita e são removidas depois de salvar um post. - Abra a página no celular e confira que a lista é legível e os links têm área de toque suficiente.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Lista não atualiza | cache velho | confirme os hooks de limpeza ou apague com wp transient delete --all |
| Hub sem texto editorial | página fina | escreva a abertura e a seção "comece por aqui" |
| Mesma lista em vários hubs | conteúdo duplicado entre páginas | um post, um hub principal |
| Consulta lenta em site grande | tempo de resposta alto | reduza limite e pagine |
| Slug de categoria errado | hub vazio | confira o slug em Posts, Categorias |
Para desfazer, remova o shortcode das páginas, apague o arquivo e rode wp transient delete --all para limpar os caches gerados. Nenhum dado de post é modificado.
Checklist final
- Taxonomia limpa por tópico.
- Hub com abertura e seleção manual de entrada.
- Shortcode com limite definido.
- Cache e invalidação testados.
- Cada post com um hub principal.
- Links para os tópicos vizinhos.
Onde isso se conecta
Esta é a base da arquitetura de silos ensinada no mini-curso Links internos e silos e na trilha de SEO técnico. Combine o hub com os links internos semânticos e com o sumário automático nos artigos. No glossário, o conceito aparece em topic cluster. Os plugins de origem estão descritos em camillodantas.com.br/plugins.
Fontes
- WP_Query, WordPress Developer Resources (2026-10-14)
- add_shortcode(), WordPress Developer Resources (2026-10-14)
- set_transient(), WordPress Developer Resources (2026-10-14)
- transition_post_status, WordPress Developer Resources (2026-10-14)
- wp transient delete, WP-CLI Handbook (2026-10-14)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.