wp_get_pages: listar páginas
Lista páginas. Idéntico a wp_get_posts con post_type fijado a page.
Argumentos
| Argumento | Predeterminado | Significado |
|---|---|---|
status |
publish |
Estado de la entrada a listar |
page |
1 | Número de página |
per_page |
20 | Elementos por página, limitados a 1–100 |
s |
— | Término de búsqueda |
ids |
— | Restringir a IDs específicos |
Pasar post_type no tiene efecto; se sobrescribe.
Permisos
mcp:read y wp:content:read.
Listar páginas publicadas no requiere ninguna capacidad adicional. Listar borradores u otros estados requiere edit_pages — ten en cuenta que es la capacidad de páginas, no edit_posts. Un rol que puede editar entradas no puede necesariamente listar páginas no publicadas.
Qué devuelve
items y total, cada elemento con id, post_type, title, slug, status, date, modified, link y excerpt.
Sin content, como en todo listado.
Por qué las páginas necesitan listarse más que las entradas
Un sitio suele tener decenas de páginas y cientos de entradas, así que un listado de páginas normalmente cabe en una sola llamada — el total suele ser el conjunto completo.
Eso hace que sea una llamada de orientación verdaderamente útil:
Lista todas las páginas con sus IDs y títulos, y detente.
El resultado es un mapa de la estructura del sitio, que es exactamente lo que un asistente necesita antes de editar nada. También permite comprobar los IDs antes de una escritura, que es la salvaguarda más eficaz contra la edición de la página equivocada.
Sin jerarquía en la respuesta
Las páginas se anidan, pero la respuesta no informa de un padre ni produce un árbol. El listado es plano.
Para entender la estructura, mira los valores de link — la ruta de la URL refleja la jerarquía. O lee el menú de navegación, que normalmente la refleja de forma más útil. Consulta Site and menu tools.
Encontrar una página para editar
Dos formas, y la ruta del ID es más segura:
Lista las páginas y dime el ID de la titulada "Services".
Busca "warranty" en las páginas y muéstrame cuáles la contienen.
Luego limita la escritura a ese ID. Consulta Update a page safely.
Usarlo bien
Lista las páginas publicadas con IDs y enlaces.
Lista las páginas en borrador y dime el total.
Muéstrame las páginas 88, 92 y 104.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Faltan borradores | El estado predeterminado es publish |
pom_ai_mcp_forbidden |
Listar páginas no publicadas sin edit_pages |
| Menos de lo esperado | per_page se limita a 100; lee total |
| Sin contenido en la respuesta | Esperado; usa wp_get_page |
| No se muestra padre ni jerarquía | No forma parte de la respuesta; infiérelo de link |