wp_get_categories: listar categorías
Lista los términos de categoría.
Argumentos
| Argumento | Valor predeterminado | Significado |
|---|---|---|
per_page |
20 | Número de términos, limitado a 1–100 |
search |
— | Filtra por término de búsqueda |
hide_empty |
false | Excluye los términos sin entradas |
Permisos
mcp:read y wp:content:read. No se requiere ninguna capacidad de WordPress.
Qué devuelve
items solo. Cada término lleva id, taxonomy, name, slug, description y count.
No hay total. A diferencia de los listados de entradas y medios, un listado de términos no te dice cuántos existen más allá de la página que has solicitado. Usa wp_count_terms para el tamaño.
Lee esto antes de crear nada
El uso más valioso de esta herramienta es evitar términos duplicados.
Un asistente al que se le pida categorizar entradas creará categorías que no puede encontrar. Sin leer primero la lista existente, produce "News", "news" y "Company News" como tres términos separados — cada uno con su propia página de archivo y su propio slug.
Lista las categorías existentes con sus IDs y recuentos de entradas, y detente.
Después, indica el límite explícitamente:
Usa solo estas categorías. Si una entrada no encaja en ninguna, dímelo en lugar de crear una nueva.
count es el campo que importa
Indica cuántas entradas publicadas usan el término, y es lo que convierte una decisión vaga en una informada:
- Un recuento alto significa que renombrar afecta a muchas páginas de archivo, y eliminar es un cambio estructural.
- Un recuento de cero significa que el término no se usa y es seguro eliminarlo.
- Un recuento de uno o dos suele significar un término creado por accidente.
Antes de eliminar cualquier término, lee el recuento. Consulta wp_delete_term.
hide_empty muestra todo por defecto
Los términos sin uso se incluyen a menos que pases hide_empty. Ese es el valor predeterminado correcto para una auditoría: los términos vacíos son precisamente los que merece la pena revisar.
Pasa hide_empty: true cuando quieras la taxonomía tal y como la experimenta un visitante.
No se informa de la jerarquía
Las categorías se anidan, pero la respuesta no lleva ningún campo parent ni ningún árbol.
Así que un listado no puede decirte qué categorías son hijas de cuáles. Si la estructura importa — antes de crear una hija, o antes de eliminar una padre — compruébala en el administrador de WordPress.
Esta es una laguna real al reorganizar una taxonomía anidada, y merece la pena conocerla antes de prometer que un asistente puede reestructurar una.
Buscar el ID de un término
wp_add_post_terms acepta IDs de término, no nombres, así que este listado suele ser el paso que resuelve uno:
Lista las categorías y dime el ID de "Maintenance".
Si la búsqueda no devuelve nada, no dejes que el asistente continúe creando el término a menos que sea lo que pretendías.
Usarlo bien
Lista las categorías con sus IDs y recuentos.
Busca "service" en las categorías.
Lista las categorías que no tienen entradas.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Menos términos de los esperados | per_page se limita a 100, y no hay total |
| Faltan términos vacíos | Se pasó hide_empty |
| Sin información de padres | No forma parte de la forma de la respuesta |
| Términos que parecen duplicados | Creados sin leer primero la lista existente |