wp_count_posts: contar entradas
Devuelve cuántas entradas existen por estado, sin enumerarlas. La forma más económica de dimensionar un trabajo antes de empezarlo.
Argumentos
| Argumento | Valor predeterminado | Significado |
|---|---|---|
post_type |
post |
Cualquier tipo de entrada pública |
Permisos
mcp:read y wp:content:read. Sin ninguna capacidad adicional y sin compuerta de escritura: es de solo lectura.
Qué devuelve
Un objeto counts indexado por estado de entrada: publish, draft, pending, private, trash y cualquier otro estado registrado en el sitio.
Un tipo de entrada no público devuelve recuentos vacíos en lugar de un error, lo que conviene tener en cuenta: un resultado vacío puede significar «ninguna» o «no accesible».
Por qué llamarlo primero
Un asistente al que se le pide «actualizar las entradas de esta categoría» empezará a actualizar. Pedir primero un recuento convierte un trabajo abierto en uno conocido:
¿Cuántas entradas publicadas hay? No cambies nada todavía.
La respuesta cambia lo que aceptas. Cuarenta son una sesión; cuatrocientas son un proyecto que necesita planificación, procesamiento por lotes y una prueba piloto.
También cuesta casi nada: una llamada de lectura, dentro del límite de frecuencia de lectura más alto, que devuelve un objeto pequeño.
Interpretar los estados
El desglose suele ser más informativo que el total:
- Un recuento grande de
draftsignifica trabajo sin terminar que una instrucción de «actualizar todas las entradas» tocaría. - Un recuento grande de
trashsignifica eliminaciones que aún no se han purgado. - Un recuento de
pendingsignifica una cola editorial.
Antes de cualquier instrucción masiva, averigua qué estados están dentro del alcance. Consulta wp_get_posts, que de forma predeterminada solo incluye publish.
Tipos de entrada personalizados
Pasa post_type para contar cualquier cosa pública:
Cuenta las entradas de tipo «project».
Para averiguar qué tipos existen, llama primero a wp_get_post_types.
Cómo usarlo bien
Cuenta las entradas y las páginas, y muéstrame ambos desgloses.
¿Cuántos borradores hay del tipo de entrada «project»?
Antes de un lote:
Cuéntalas, luego enumera las diez primeras con sus IDs y después detente.
Esa secuencia —contar, muestrear, detenerse— es la apertura estándar de cualquier trabajo de contenido masivo. Consulta Patrones de prompts para trabajo MCP de varios pasos.
Qué no hace
- Sin filtrado por categoría, autor, fecha o término de búsqueda. Cuenta un tipo de entrada.
- Sin IDs. Usa
wp_get_posts. - Sin recuentos de términos. Consulta
wp_count_terms. - Sin recuentos de medios. Consulta Herramientas de medios.
Problemas habituales
| Síntoma | Causa |
|---|---|
| Recuentos vacíos | El tipo de entrada no es público o no existe |
| El total no coincide con un listado | El listado de forma predeterminada solo incluye publish |
| Los recuentos incluyen elementos enviados a la papelera | Correcto; lee la clave trash por separado |