wp_count_terms: contar los términos de una taxonomía

Devuelve cuántos términos contiene una taxonomía. Es el complemento de los listados de términos, que no devuelven ningún total por sí mismos.

Argumentos

Argumento Obligatorio Significado
taxonomy Sí La clave de la taxonomía

Permisos

mcp:read y wp:content:read. No se requiere ninguna capacidad de WordPress.

Qué devuelve

Un único count.

También cuenta los términos vacíos

El recuento incluye términos sin entradas. Es deliberado y es el comportamiento correcto para la pregunta que esta herramienta suele responder —«¿qué tamaño tiene esta taxonomía?»— porque los términos sin usar forman parte del desorden que quizá quieras evaluar.

Eso significa que la cifra puede superar lo que un visitante llegaría a encontrarse. Un sitio con 40 etiquetas en uso y 60 abandonadas informa de 100.

Funciona con cualquier taxonomía

A diferencia de las herramientas de listado, que están fijadas a categorías y etiquetas, esta acepta cualquier clave de taxonomía, incluidas las personalizadas.

Eso la convierte en la única herramienta de este capítulo que puede decirte algo sobre los términos de una taxonomía personalizada. Para una taxonomía personalizada no existe una herramienta de listado dedicada, así que wp_count_terms es la forma de confirmar que los términos existen antes de trabajar con ellos.

Obtén las claves válidas en wp_get_taxonomies.

Por qué es la primera llamada en un trabajo con taxonomías

Los listados de términos tienen un límite de 100 por página y no informan de ningún total, así que un listado por sí solo no puede decirte si has visto todo.

Cuenta las etiquetas, luego lista las 100 primeras y dime si esas son todas.

Sin el recuento, un asistente que lista una sola vez razonará sobre cien etiquetas como si fueran toda la taxonomía, y una limpieza basada en esa suposición se perderá todo lo que venga después.

Dimensionar una reorganización

El recuento frente a los campos count del listado te da la forma:

  1. wp_count_terms para el total.
  2. Un listado para los recuentos individuales de entradas.
  3. Compara.

Una taxonomía con 200 términos en la que la primera página del listado muestra la mayoría de los recuentos en uno o cero es una taxonomía que creció por accidente, y la recomendación honesta suele ser la consolidación antes que una limpieza dirigida por el asistente. Consulta Crear términos y organizar el contenido.

Cómo usarla bien

Cuenta los términos de «category» y de «post_tag».

¿Cuántos términos tiene la taxonomía «project-type»?

Al comienzo de un sitio desconocido:

Lista las taxonomías, luego cuenta los términos de cada una y luego detente.

Qué no hace

  • Sin desglose. Un número, no una distribución.
  • Sin filtrado. Cuenta la taxonomía.
  • Sin IDs ni nombres. Usa las herramientas de listado.
  • Sin recuento de cuántas entradas usan la taxonomía. Eso es el count de cada término.

Problemas habituales

Síntoma Causa
Un recuento de cero para una taxonomía que sí ves Clave de taxonomía incorrecta; comprueba wp_get_taxonomies
Más alto que los términos en uso Los términos vacíos están incluidos
No coincide con el administrador de WordPress El administrador puede estar ocultando los términos vacíos
`wp_get_tags`: listar etiquetas
Anterior
Crear un término de taxonomía
Siguiente