Referencia de las herramientas de contenido de WordPress

Trece herramientas para entradas, páginas y tipos de contenido personalizados públicos. Son el grupo más usado del servidor y aquel cuyas escrituras resultan más visibles.

Las herramientas

Lectura

Herramienta Hace
wp_get_posts Lista entradas y tipos de contenido personalizados públicos
wp_get_post Lee una entrada
wp_get_pages Lista páginas
wp_get_page Lee una página
wp_count_posts Cuenta por estado
wp_get_post_types Lista tipos de contenido públicos
wp_search Busca contenido público

Escritura

Herramienta Hace
wp_create_post Crea una entrada
wp_update_post Actualiza una entrada
wp_delete_post Envía a la papelera o elimina una entrada
wp_create_page Crea una página
wp_update_page Actualiza una página
wp_delete_page Envía a la papelera o elimina una página

Las páginas son entradas

Las seis herramientas de páginas son contenedores ligeros alrededor de las herramientas de entradas con post_type fijado a page. Mismos argumentos, mismo comportamiento, mismas respuestas.

Existen para que un cliente pueda expresar la intención con claridad. Donde esta referencia describe wp_get_posts, la equivalente de páginas se comporta de forma idéntica.

Qué pueden alcanzar

Solo tipos de contenido públicos. Un tipo de contenido registrado como no público se rechaza con pom_ai_mcp_post_type_denied y no aparece en wp_get_post_types.

Leer un elemento publicado no necesita ninguna capacidad más allá de la autenticación. Leer cualquier otra cosa — borradores, privados, pendientes — requiere edit_post sobre ese elemento, o edit_posts/edit_pages para un listado.

Esa asimetría merece conocerse: un token de solo lectura puede listar contenido publicado, pero no borradores.

Permisos para las escrituras

Todas las escrituras necesitan Allow content writes abierto, además de:

Herramienta Capacidad
Crear edit_posts, o edit_pages para páginas
Actualizar edit_post sobre ese elemento concreto
Eliminar delete_post sobre ese elemento concreto

Ámbitos: mcp:read, mcp:write, wp:content:read, wp:content:write.

La forma de la respuesta

Toda herramienta que devuelve una entrada devuelve los mismos campos: id, post_type, title, slug, status, date, modified, link y excerpt.

Las lecturas de un solo elemento y las respuestas de escritura también incluyen content. Los listados no — una decisión de diseño que mantiene manejable una página de resultados, y algo que recordar cuando un asistente afirme haber leído el contenido de veinte entradas a partir de una sola llamada de listado.

Pruebas en seco

wp_create_post, wp_update_post y wp_delete_post admiten dry_run, junto con sus equivalentes de páginas:

  • crear devuelve would_create con la carga útil;
  • actualizar devuelve before y after;
  • eliminar devuelve would_delete con el registro.

La comparación de actualización es la más útil de las tres. Úsala para cualquier cosa publicada.

Comportamiento del estado

Crear sin un estado produce un borrador. Es el valor predeterminado seguro y significa que un asistente no puede publicar por omisión.

Actualizar sin un estado deja el estado almacenado sin cambios. Cambiar el estado es un acto explícito — pasa status cuando pretendas publicar o despublicar.

Paginación

Los listados aceptan page y per_page. per_page se limita entre 1 y 100, con 20 como valor predeterminado, de modo que una solicitud de todo devuelve como máximo cien elementos con un total que te indica el tamaño real.

Lee el total. Un asistente que procesó «todas las entradas» a partir de una llamada procesó como máximo cien.

Crea páginas con el editor de bloques instalado
Anterior
`wp_get_posts`: listar publicaciones
Siguiente