Registrar una Custom Taxonomy

Php marzo 10, 2026

Las Custom Taxonomies son sistemas de clasificación personalizados para tus CPTs. Funcionan igual que las categorías (jerárquicas) o las etiquetas (no jerárquicas) de WordPress pero aplicadas a cualquier tipo de contenido. Son esenciales para filtrar y organizar los contenidos de tu CPT de forma semántica.

Casos de uso: categorizar proyectos por tecnología usada, agrupar recetas por tipo de cocina, clasificar inmuebles por zona geográfica.

<?php
function mi_plugin_register_taxonomy() {
    register_taxonomy( 'tecnologia', 'proyecto', array(
        'labels' => array(
            'name'          => 'Tecnologías',
            'singular_name' => 'Tecnología',
            'all_items'     => 'Todas las tecnologías',
            'edit_item'     => 'Editar tecnología',
            'add_new_item'  => 'Añadir tecnología',
        ),
        'hierarchical'      => true,
        'public'            => true,
        'show_in_rest'      => true,
        'rewrite'           => array( 'slug' => 'tecnologia' ),
    ) );
}
add_action( 'init', 'mi_plugin_register_taxonomy' );

¿Qué hace cada parte?

  • register_taxonomy(): registra la taxonomía con el slug tecnologia y la asocia al CPT proyecto. El segundo parámetro puede ser un array si quieres asociarla a varios CPTs.
  • labels: textos que aparecen en el panel de administración para esta taxonomía.
  • hierarchical => true: se comporta como categorías (árbol con padres e hijos). Con false se comporta como etiquetas (lista plana).
  • public => true: la taxonomía aparece en el frontend y tiene su propia página de archivo.
  • show_in_rest => true: expone la taxonomía en la REST API y la hace compatible con Gutenberg.
  • rewrite: define el slug en las URLs de los archivos de cada término (ej. /tecnologia/php/).