wp_get_posts: listar publicaciones

Lista publicaciones y tipos de contenido personalizados públicos, con filtrado y paginación.

Argumentos

Argumento Valor por defecto Significado
post_type post Cualquier tipo de contenido público
status publish Estado de la publicación que se va a listar
page 1 Número de página
per_page 20 Elementos por página, limitado a 1–100
s — Término de búsqueda
ids — Restringir a IDs específicos

Permisos

mcp:read y wp:content:read.

El contenido publicado y no protegido se puede leer con los alcances de lectura. Otros estados requieren la capacidad de edición del tipo de contenido y el permiso por objeto. Los actores sin permiso para editar el contenido de otros se limitan a sus propias publicaciones no publicadas. El contenido protegido con contraseña requiere permiso para editar esa publicación.

Qué devuelve

items, una matriz de publicaciones, y total, el número de coincidencias en todas las páginas.

Cada elemento incluye id, post_type, title, slug, status, date, modified, link y excerpt.

Los listados no incluyen el contenido. Para leer el cuerpo de una publicación, llama a wp_get_post para ella.

Leer el total

total cuenta las coincidencias de la consulta antes del filtrado de permisos por elemento; items es como mucho una página de ellas. Un asistente que lista una vez e informa sobre «todas las publicaciones» ha visto hasta cien.

Para un trabajo con muchos registros, obtén primero el total y trabaja en páginas explícitas:

Lista las publicaciones de esta categoría y dime el total; después, detente.

Los tipos de contenido no públicos son invisibles

Solo se puede acceder a los tipos de contenido públicos. Un tipo de contenido registrado como no público no aparece en wp_get_post_types y no se puede listar aquí: los tipos no admitidos devuelven un error. Los objetos de comercio usan las herramientas de WooCommerce y sus alcances y controles independientes.

Comprueba el post_type de los elementos devueltos si los resultados parecen incorrectos.

Filtrado

Por estado. Pasa status para ver borradores, pendientes o elementos privados. Recuerda el requisito de capacidad.

Por término de búsqueda. s ejecuta una búsqueda de WordPress en el tipo de contenido.

Por ID. ids restringe la consulta a un conjunto específico, que es la forma precisa de volver a leer un grupo conocido después de una operación por lotes.

Cómo usarlo bien

Lista las 10 publicaciones publicadas más recientes con sus IDs y títulos.

Lista las páginas en borrador y dime el total.

Lista las publicaciones 412, 415 y 418.

Antes de un trabajo por lotes:

Lista las publicaciones de la categoría Guides con los IDs, dime el total y detente. No cambies nada.

Qué no hace

  • No incluye contenido. Usa wp_get_post.
  • No hay argumento de filtrado por taxonomía. Filtra por término de búsqueda, o lee los términos por separado y usa ids.
  • No hay argumento de ordenación. Los resultados siguen el orden predeterminado de la consulta.
  • No hay metadatos. Consulta Herramientas de comentarios y metadatos.

Problemas comunes

Síntoma Causa
Menos elementos de los esperados per_page se limita a 100; lee total
Faltan borradores El estado predeterminado es publish; pasa status
pom_ai_mcp_forbidden Listar contenido no publicado sin la capacidad
Error de tipo no admitido Usa un tipo de contenido público o las herramientas de comercio dedicadas
No hay contenido en la respuesta Es lo esperado; los listados lo omiten
Referencia de las herramientas de contenido de WordPress
Anterior
`wp_get_post`: obtener una entrada
Siguiente