Como cuidar da taxonomia no WordPress: meu sistema para classificar posts

Quando um site cresce ao longo dos anos, a taxonomia começa a virar um problema. Um problema silencioso, porque passa bastante tempo quase despercebido.

No começo não acontece nada. Você cria uma categoria nova, adiciona uma tag, testa outra, muda o foco editorial… e continua publicando.

Mas, conforme o site cresce, um dia o post vai parar em sem categoria. Em outro, você esquece uma tag que cairia como uma luva. E, no terceiro, esquece se já tinha criado ou não determinada tag e por quais motivos fez isso (sim/não).

Se você quer fazer isso direito, chega um momento em que classificar um post começa a demorar mais do que deveria. Porque há possibilidades demais e nem sempre você tem claro, ou se lembra, quando usar cada uma.

Era isso que estava acontecendo comigo e por isso expliquei recentemente como recategorizei e refiz as tags de todo o meu WordPress.

Não vou repetir aqui como organizei meu site, salvo o indispensável para você entender melhor este sistema: três grandes pilares: Negócios, Tecnologia e Lazer e várias subcategorias de segundo nível em cada uma delas, além das tags.

Aliás, se você se perde um pouco com tudo isso, aqui tem um artigo em que explico a diferença entre tags e categorias, e quando usar uma ou outra.

O objetivo: decidir mais rápido como classificar cada post e não bagunçar tudo

A ideia era criar um sistema que facilitasse minha vida na hora de marcar um post com tags. Algo imediato e com baixa chance de erro ou omissão.

Além disso, como objetivo secundário, queria ter algum controle sobre quantos conteúdos tinha criado em cada categoria ou tag.

Uma coisa importante aqui é que, antes de colocar a mão na massa com a solução, defini dois tipos de tags:

• Estruturais: São as que não pertencem a uma categoria concreta, mas descrevem o formato ou a intenção do post. Por exemplo: Tutorial, Resenha, Recomendado, Economizar ou Privacidade.
• Aninhadas: Estas têm uma categoria natural. Por exemplo, Google Analytics encaixa dentro da subcategoria Analítica, Email dentro de Marketing, Chromebook dentro de Hardware, Consoles dentro de Videogames ou Quadrinhos europeus dentro de Quadrinhos.

Isso facilitava muito a visualização, como você verá agora.

A solução: uma tela própria no admin do WordPress

Eu poderia ter montado isso em um mapa mental, que era minha primeira ideia pelo lado visual.

Ou em uma planilha do Excel, por causa dos números.

Mas, nos dois casos, a gestão e a manutenção seriam manuais, coisa que eu queria evitar a todo custo.

Então, a solução era montar algo dentro do WordPress.

Como fiz isso?

Criando uma página personalizada dentro do administrador do WordPress por meio de código em functions.php.  

Essa tela funciona como um pequeno mapa editorial dividido em duas metades:

Na parte esquerda aparecem as categorias principais e suas subcategorias. Abaixo de cada uma são exibidas as tags recomendadas para classificar posts desse bloco.

Na parte direita aparecem as tags, divididas nos dois blocos mencionados antes: estruturais e aninhadas.

Além disso, acrescentei:

• Um campo de busca.
• Links para arquivo e edição
• Contadores de posts por taxonomia.

Você acessa essa tela pela seção de posts:

O código

Aqui deixo o código que adicionei ao functions.php, mas atenção: você precisa editá-lo para encaixar nas suas categorias e tags. Você pode fazer isso por conta própria ou explicar para o ChatGPT e pedir que ele modifique:

/* =========================================================
 * MAPA EDITORIAL DE TAXONOMÍAS
 * Página interna para visualizar categorías y etiquetas
 * ========================================================= */

add_action('admin_menu', 'yg_mapa_editorial_menu');

function yg_mapa_editorial_menu() {
	add_submenu_page(
		'edit.php',
		'Mapa editorial',
		'Mapa editorial',
		'manage_categories',
		'yg-mapa-editorial',
		'yg_render_mapa_editorial'
	);
}

/**
 * Configuración editorial del mapa.
 */
function yg_mapa_editorial_config() {
	return array(
		'categorias_principales' => array(
			'Negocio',
			'Tecnología',
			'Ocio',
		),

		// Categorías obsoletas o que no queremos mostrar en el mapa editorial.
		'categorias_excluidas' => array(
			'Diseño',
			'Diseño gráfico',
			'Diseño web',
			'Ilustración',
			'Usabilidad',
			'Sin categoría',
		),

		// Etiquetas transversales: formato, enfoque o intención del contenido.
		'etiquetas_estructurales' => array(
			'Tutorial',
			'Reseña',
			'Recomendado',
			'Ahorrar',
			'Privacidad',
		),

		// Etiquetas temáticas/anidadas por pilar.
		// Productividad queda como anidada de Negocio.
		'etiquetas_anidadas' => array(
			'Negocio' => array(
				'Productividad',
				'Google Analytics',
				'CRO',
				'SEO',
				'Email',
				'Acumbamail',
			),

			'Tecnología' => array(
				'WordPress',
				'Chromebook',
				'Gmail',
				'Trello',
				'Video',
			),

			'Ocio' => array(
				'Consolas',
				'Retro',
				'Cómic Americano',
				'Cómic Europeo',
				'Manga',
				'Pérez-Reverte',
			),
		),

		// Etiquetas recomendadas bajo cada categoría.
		// La clave debe coincidir con el slug habitual de la categoría.
		'etiquetas_por_categoria' => array(
			// Negocio
			'negocio'          => array('Productividad', 'SEO', 'CRO', 'Email', 'Acumbamail', 'Google Analytics'),
			'analitica'        => array('Google Analytics', 'CRO', 'Tutorial'),
			'casos-de-exito'   => array('Productividad'),
			'ecommerce'        => array('CRO', 'Email', 'Acumbamail', 'Google Analytics', 'Tutorial'),
			'inversion'        => array('Ahorrar'),
			'marketing'        => array('Email', 'Acumbamail', 'SEO', 'CRO', 'Productividad'),
			'negocios-online'  => array('Productividad', 'SEO', 'CRO'),

			// Tecnología
			'tecnologia'              => array('WordPress', 'Privacidad', 'Tutorial'),
			'hardware'                => array('Chromebook', 'Tutorial'),
			'herramientas'            => array('Trello', 'Gmail', 'WordPress', 'Tutorial'),
			'inteligencia-artificial' => array('Video', 'Tutorial'),
			'software'                => array('WordPress', 'Gmail', 'Trello', 'Privacidad', 'Tutorial'),

			// Ocio
			'ocio'         => array('Reseña', 'Recomendado'),
			'comics'      => array('Cómic Americano', 'Cómic Europeo', 'Manga', 'Reseña'),
			'libros'      => array('Pérez-Reverte', 'Reseña', 'Recomendado'),
			'musica'      => array('Video', 'Reseña'),
			'peliculas'   => array('Reseña', 'Recomendado'),
			'series'      => array('Reseña', 'Recomendado'),
			'videojuegos' => array('Consolas', 'Retro', 'Reseña', 'Recomendado'),
		),
	);
}

/**
 * Recupera término por nombre o slug.
 */
function yg_mapa_get_term_by_name_or_slug($name, $taxonomy) {
	$term = get_term_by('name', $name, $taxonomy);

	if (!$term) {
		$term = get_term_by('slug', sanitize_title($name), $taxonomy);
	}

	if (!$term || is_wp_error($term)) {
		return null;
	}

	return $term;
}

/**
 * Comprueba si una categoría debe ocultarse.
 */
function yg_mapa_categoria_excluida($term, $config) {
	if (!$term || is_wp_error($term)) {
		return true;
	}

	return in_array($term->name, $config['categorias_excluidas'], true);
}

/**
 * Render de una etiqueta como píldora compacta dentro de tarjetas de categoría.
 */
function yg_mapa_tag_pill($tag_name) {
	$term = yg_mapa_get_term_by_name_or_slug($tag_name, 'post_tag');

	if (!$term) {
		return '<span class="yg-map-pill yg-map-pill--missing">' . esc_html($tag_name) . ' <small>no existe</small></span>';
	}

	$edit_link    = get_edit_term_link($term->term_id, 'post_tag');
	$archive_link = get_term_link($term);

	$html  = '<span class="yg-map-pill">';
	$html .= '<strong>' . esc_html($term->name) . '</strong>';
	$html .= '<em>' . intval($term->count) . '</em>';

	if (!is_wp_error($archive_link)) {
		$html .= '<a href="' . esc_url($archive_link) . '" target="_blank">ver</a>';
	}

	if ($edit_link) {
		$html .= '<a href="' . esc_url($edit_link) . '">editar</a>';
	}

	$html .= '</span>';

	return $html;
}

/**
 * Render de tarjeta compacta de categoría.
 */
function yg_mapa_category_card($term, $config) {
	if (!$term || is_wp_error($term)) {
		return;
	}

	if (yg_mapa_categoria_excluida($term, $config)) {
		return;
	}

	$archive_link = get_term_link($term);
	$edit_link    = get_edit_term_link($term->term_id, 'category');

	$recommended_tags = array();

	if (!empty($config['etiquetas_por_categoria'][$term->slug])) {
		$recommended_tags = $config['etiquetas_por_categoria'][$term->slug];
	}

	echo '<article class="yg-map-card yg-map-card--category" data-map-search="' . esc_attr(strtolower($term->name)) . '">';

	echo '<div class="yg-map-card__top">';
	echo '<h3>' . esc_html($term->name) . '</h3>';
	echo '<span class="yg-map-count">' . intval($term->count) . ' artículos</span>';
	echo '</div>';

	if (!empty($recommended_tags)) {
		echo '<div class="yg-map-card__tags">';
		echo '<span class="yg-map-label">Etiquetas recomendadas</span>';
		echo '<div class="yg-map-pills">';

		foreach ($recommended_tags as $tag_name) {
			echo yg_mapa_tag_pill($tag_name);
		}

		echo '</div>';
		echo '</div>';
	}

	echo '<div class="yg-map-card__actions">';

	if (!is_wp_error($archive_link)) {
		echo '<a href="' . esc_url($archive_link) . '" target="_blank">Ver archivo</a>';
	}

	if ($edit_link) {
		echo '<a href="' . esc_url($edit_link) . '">Editar</a>';
	}

	echo '</div>';

	echo '</article>';
}

/**
 * Render de tarjeta compacta de etiqueta.
 * No muestra ya las píldoras "Estructural" / "Anidada".
 */
function yg_mapa_tag_card($tag_name) {
	$term = yg_mapa_get_term_by_name_or_slug($tag_name, 'post_tag');

	if (!$term) {
		echo '<article class="yg-map-card yg-map-card--tag yg-map-card--missing">';
		echo '<div class="yg-map-card__top">';
		echo '<h3>' . esc_html($tag_name) . '</h3>';
		echo '<span class="yg-map-count">no existe</span>';
		echo '</div>';
		echo '</article>';
		return;
	}

	$archive_link = get_term_link($term);
	$edit_link    = get_edit_term_link($term->term_id, 'post_tag');

	echo '<article class="yg-map-card yg-map-card--tag" data-map-search="' . esc_attr(strtolower($term->name)) . '">';

	echo '<div class="yg-map-card__top">';
	echo '<h3>' . esc_html($term->name) . '</h3>';
	echo '<span class="yg-map-count">' . intval($term->count) . ' artículos</span>';
	echo '</div>';

	echo '<div class="yg-map-card__actions">';

	if (!is_wp_error($archive_link)) {
		echo '<a href="' . esc_url($archive_link) . '" target="_blank">Ver archivo</a>';
	}

	if ($edit_link) {
		echo '<a href="' . esc_url($edit_link) . '">Editar</a>';
	}

	echo '</div>';

	echo '</article>';
}

/**
 * Render principal.
 */
function yg_render_mapa_editorial() {
	if (!current_user_can('manage_categories')) {
		wp_die('No tienes permisos para ver esta página.');
	}

	$config = yg_mapa_editorial_config();

	echo '<div class="wrap yg-map-wrap">';
	echo '<h1>Mapa editorial</h1>';

	echo '<p class="yg-map-intro">Consulta de forma rápida las categorías y etiquetas recomendadas para decidir cómo clasificar cada artículo.</p>';

	echo '<input type="search" id="yg-map-search" class="yg-map-search" placeholder="Buscar categoría o etiqueta..." />';

	echo '<div class="yg-map-layout">';

	/* ======================
	 * CATEGORÍAS
	 * ====================== */
	echo '<section class="yg-map-panel">';
	echo '<div class="yg-map-panel__head">';
	echo '<h2>Categorías</h2>';
	echo '<p>Estructura principal de la web. Debajo de cada categoría se muestran sus etiquetas anidadas recomendadas.</p>';
	echo '</div>';

	foreach ($config['categorias_principales'] as $parent_name) {
		$parent = yg_mapa_get_term_by_name_or_slug($parent_name, 'category');

		if (!$parent || yg_mapa_categoria_excluida($parent, $config)) {
			continue;
		}

		echo '<div class="yg-map-category-group">';
		echo '<h2 class="yg-map-group-title">' . esc_html($parent->name) . '</h2>';

		yg_mapa_category_card($parent, $config);

		$children = get_categories(array(
			'taxonomy'   => 'category',
			'hide_empty' => false,
			'parent'     => $parent->term_id,
			'orderby'    => 'name',
			'order'      => 'ASC',
		));

		if (!empty($children)) {
			echo '<div class="yg-map-child-grid">';

			foreach ($children as $child) {
				yg_mapa_category_card($child, $config);
			}

			echo '</div>';
		}

		echo '</div>';
	}

	echo '</section>';

	/* ======================
	 * ETIQUETAS
	 * ====================== */
	echo '<section class="yg-map-panel">';
	echo '<div class="yg-map-panel__head">';
	echo '<h2>Etiquetas</h2>';
	echo '<p>Separación editorial entre etiquetas estructurales y etiquetas anidadas por pilar.</p>';
	echo '</div>';

	// Estructurales
	echo '<div class="yg-map-tag-block">';
	echo '<h2 class="yg-map-group-title">Estructurales</h2>';
	echo '<p class="yg-map-help">Transversales: formato, intención o enfoque. Se pueden usar en artículos de distintas categorías.</p>';
	echo '<div class="yg-map-tag-grid">';

	foreach ($config['etiquetas_estructurales'] as $tag_name) {
		yg_mapa_tag_card($tag_name);
	}

	echo '</div>';
	echo '</div>';

	// Anidadas
	echo '<div class="yg-map-tag-block">';
	echo '<h2 class="yg-map-group-title">Anidadas</h2>';
	echo '<p class="yg-map-help">Temáticas: deben usarse principalmente dentro de su pilar o categoría natural.</p>';

	foreach ($config['etiquetas_anidadas'] as $group_name => $tags) {
		echo '<div class="yg-map-nested-group">';
		echo '<h3>' . esc_html($group_name) . '</h3>';
		echo '<div class="yg-map-tag-grid">';

		foreach ($tags as $tag_name) {
			yg_mapa_tag_card($tag_name);
		}

		echo '</div>';
		echo '</div>';
	}

	echo '</div>';

	echo '</section>';

	echo '</div>'; // layout
	echo '</div>'; // wrap

	yg_mapa_editorial_styles();
	yg_mapa_editorial_scripts();
}

/**
 * CSS interno para la pantalla.
 */
function yg_mapa_editorial_styles() {
	?>
	<style>
		.yg-map-wrap {
			max-width: 1320px;
		}

		.yg-map-intro {
			margin: 4px 0 18px;
			color: #555;
			font-size: 14px;
		}

		.yg-map-search {
			width: 100%;
			max-width: 520px;
			margin: 0 0 22px;
			padding: 10px 12px;
			border: 1px solid #ccd0d4;
			border-radius: 6px;
			background: #fff;
		}

		.yg-map-layout {
			display: grid;
			grid-template-columns: minmax(0, 1.05fr) minmax(0, 0.95fr);
			gap: 22px;
			align-items: start;
		}

		.yg-map-panel {
			background: #fff;
			border: 1px solid #dcdcde;
			border-radius: 8px;
			padding: 18px;
		}

		.yg-map-panel__head {
			margin-bottom: 16px;
		}

		.yg-map-panel__head h2 {
			margin: 0 0 4px;
			font-size: 18px;
		}

		.yg-map-panel__head p,
		.yg-map-help {
			margin: 0;
			color: #666;
			font-size: 12px;
			line-height: 1.45;
		}

		.yg-map-category-group,
		.yg-map-tag-block {
			margin-bottom: 22px;
		}

		.yg-map-category-group:last-child,
		.yg-map-tag-block:last-child {
			margin-bottom: 0;
		}

		.yg-map-group-title {
			margin: 0 0 10px;
			padding: 0 0 7px;
			border-bottom: 1px solid #ececec;
			font-size: 15px;
			font-weight: 700;
			color: #1d2327;
		}

		.yg-map-child-grid,
		.yg-map-tag-grid {
			display: grid;
			grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));
			gap: 10px;
		}

		.yg-map-nested-group {
			margin-top: 16px;
		}

		.yg-map-nested-group h3 {
			margin: 0 0 8px;
			font-size: 14px;
			color: #1d2327;
		}

		.yg-map-card {
			background: #fdfdfd;
			border: 1px solid #dcdcde;
			border-radius: 8px;
			padding: 10px;
			min-height: auto;
		}

		.yg-map-card--missing {
			opacity: .65;
			border-style: dashed;
		}

		.yg-map-card__top {
			display: flex;
			gap: 8px;
			justify-content: space-between;
			align-items: flex-start;
			margin-bottom: 7px;
		}

		.yg-map-card h3 {
			margin: 0;
			font-size: 13px;
			line-height: 1.25;
			font-weight: 700;
			color: #1d2327;
		}

		.yg-map-count {
			flex: 0 0 auto;
			display: inline-flex;
			align-items: center;
			white-space: nowrap;
			padding: 3px 7px;
			border-radius: 999px;
			background: #fff4ce;
			color: #5f4500;
			font-size: 11px;
			font-weight: 600;
		}

		.yg-map-card__tags {
			margin-top: 8px;
		}

		.yg-map-label {
			display: block;
			margin-bottom: 5px;
			font-size: 11px;
			font-weight: 700;
			text-transform: uppercase;
			letter-spacing: .02em;
			color: #646970;
		}

		.yg-map-pills {
			display: flex;
			flex-wrap: wrap;
			gap: 5px;
		}

		.yg-map-pill {
			display: inline-flex;
			align-items: center;
			gap: 5px;
			padding: 4px 7px;
			border-radius: 999px;
			background: #f0f6fc;
			border: 1px solid #c5d9ed;
			font-size: 11px;
			color: #1d2327;
		}

		.yg-map-pill em {
			font-style: normal;
			color: #646970;
		}

		.yg-map-pill a {
			text-decoration: none;
		}

		.yg-map-pill--missing {
			background: #fff7f7;
			border-color: #f0b8b8;
			color: #8a2424;
		}

		.yg-map-card__actions {
			display: flex;
			gap: 8px;
			flex-wrap: wrap;
			margin-top: 7px;
			font-size: 11px;
		}

		.yg-map-card__actions a {
			text-decoration: none;
		}

		@media (max-width: 1100px) {
			.yg-map-layout {
				grid-template-columns: 1fr;
			}
		}
	</style>
	<?php
}

/**
 * JS interno para buscador rápido.
 */
function yg_mapa_editorial_scripts() {
	?>
	<script>
		document.addEventListener('DOMContentLoaded', function () {
			const input = document.getElementById('yg-map-search');
			if (!input) return;

			input.addEventListener('input', function () {
				const query = this.value.toLowerCase().trim();
				const cards = document.querySelectorAll('.yg-map-card');

				cards.forEach(function (card) {
					const text = card.textContent.toLowerCase();
					card.style.display = text.includes(query) ? '' : 'none';
				});
			});
		});
	</script>
	<?php
}

Além disso, se quiser, você pode separar o CSS no style.css, mas eu preferi manter todo o código junto.

Para que serve realmente

Este mapa editorial não muda a taxonomia do WordPress; ele facilita a forma de usá-la.

Antes eu tinha uma lista de categorias e tags seguindo um critério escolhido na época. Agora tenho esse critério visível e à mão, o que me permite:

• Classificar posts mais rápido mantendo coerência editorial.
• Evitar a criação de tags duplicadas ou desnecessárias.
• Detectar taxonomias com poucos posts.
• Escalar corretamente o site se eu publicar mais conteúdo, que é a ideia.

Conclusão

Organizar a taxonomia do WordPress não é só criar categorias e tags, mas ter um sistema para usá-las bem.

No meu caso, neste ponto, eu precisava de uma camada editorial por cima: um sistema simples que sugerisse as tags que fazem sentido em cada tipo de conteúdo.

Se você tem um site pequeno, talvez não precise disso, mas se publica há anos e já começa a hesitar entre categorias, tags, temas, formatos e ferramentas, criar um mapa editorial ou um sistema editorial pode evitar bastante caos, agora e no futuro.

Não é uma grande revolução técnica, mas é uma melhoria para economizar tempo e publicar sempre com o mesmo critério.