receita

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.

resposta curtaUm hub de conteúdo é uma página que reúne e organiza todos os posts de um tópico. Em WordPress, um shortcode com WP_Query filtrado por categoria ou tag, cache em transient e limpeza do cache ao salvar posts entrega um hub que se atualiza sozinho. Escreva sempre um texto de abertura próprio; lista automática sozinha é página fina.
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

  1. 01Defina os tópicos e a taxonomia que os representa (um slug por hub).
  2. 02Crie a página do hub e escreva a abertura: o que o tópico cobre, para quem é, por onde começar.
  3. 03Insira o shortcode com o slug da categoria.
  4. 04Ative o cache e a invalidação automática.
  5. 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_rows dispensa 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 LIKE com o caractere _ escapado, porque em SQL o sublinhado é curinga. Sem o escape, a consulta pode apagar transients de outros plugins.
  • O hook transition_post_status cobre 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:

  1. Uma resposta curta no topo: o que é o tópico em duas ou três frases.
  2. Uma seção "Comece por aqui" com três a cinco links escolhidos à mão.
  3. A lista automática, depois dessa seção.
  4. 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.

  1. Publique um post de teste na categoria e recarregue o hub: ele deve aparecer.
  2. Despublique-o: deve desaparecer.
  3. 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).
  4. Verifique com wp option list --search="_transient_hub_*" --fields=option_name (WP-CLI) que as chaves hub_ existem após a visita e são removidas depois de salvar um post.
  5. 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

ErroEfeitoCorreção
Lista não atualizacache velhoconfirme os hooks de limpeza ou apague com wp transient delete --all
Hub sem texto editorialpágina finaescreva a abertura e a seção "comece por aqui"
Mesma lista em vários hubsconteúdo duplicado entre páginasum post, um hub principal
Consulta lenta em site grandetempo de resposta altoreduza limite e pagine
Slug de categoria erradohub vazioconfira 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

  1. WP_Query, WordPress Developer Resources (2026-10-14)
  2. add_shortcode(), WordPress Developer Resources (2026-10-14)
  3. set_transient(), WordPress Developer Resources (2026-10-14)
  4. transition_post_status, WordPress Developer Resources (2026-10-14)
  5. 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.