wp_update_page: actualizar una página
Actualiza una página. Idéntica a wp_update_post, y la herramienta con más probabilidades de cambiar algo que un visitante ve en cuestión de segundos.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
id |
Sí | La página que actualizar |
title |
No | Nuevo título |
content |
No | Nuevo cuerpo |
excerpt |
No | Nuevo extracto |
slug |
No | Nuevo slug |
status |
No | Nuevo estado |
dry_run |
No | Informar sin escribir |
Permisos
Allow content writes abierto, y edit_post en esa página concreta.
Mecánica
La gestión de campos, la ejecución en seco y las reglas de estado son exactamente como en wp_update_post: solo se modifican los campos que pasas, y un status omitido deja la página tal como está.
El resto de esta página trata sobre lo que hace diferente actualizar una página.
Por qué las páginas merecen más cuidado que las entradas
Tres razones, y se acumulan:
Las páginas casi siempre están publicadas. Una entrada puede ser un borrador; una página de servicios está activa.
Las páginas son estructurales. Aparecen en la navegación, en los sitemaps y en los resultados de búsqueda, y otras páginas enlazan a ellas.
Las páginas suelen ser contenido de maquetador. El campo content contiene una estructura de shortcodes, y sustituirla por completo destruye el diseño — el error más caro disponible en este capítulo.
Lee la página antes de escribir
No es opcional para el contenido de maquetador:
Lee la página 88 y muéstrame su estructura. Cambia solo la sección hero. Conserva exactamente todas las demás secciones, sus shortcodes y sus parámetros.
Un asistente que no ha leído la estructura no puede conservarla. El prompt publicado update_pom_builder_page_preserving_structure existe exactamente para este trabajo y es más fiable que describir tú mismo la restricción. Consulta Recetas de prompts.
Cambiar el slug cambia una URL pública
Un cambio de título por sí solo no mueve la página. Pasarlo slug sí lo hace, y eso rompe enlaces entrantes, marcadores, URLs de campaña y resultados de búsqueda.
Si una página está anidada, cambiar el slug de una página padre mueve también la URL de cada página hija.
Planifica las redirecciones antes de la escritura, no después de que alguien informe de un 404.
Despublicar
Para retirar una página del sitio sin eliminarla:
Pon la página 88 en estado borrador.
Esa es casi siempre la respuesta correcta a «elimina esta página» — es reversible, conserva el contenido y evita los enlaces rotos que deja una eliminación. Consulta wp_delete_page.
Después de escribir
- Lee de nuevo la página.
- Ábrela en el front end, con ancho de escritorio y de móvil.
- Comprueba que la navegación sigue mostrando lo que esperas.
- Purga la caché.
El paso 2 importa específicamente en las páginas de maquetador: un registro almacenado puede ser correcto y el diseño renderizado seguir estando mal.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Puerta de escritura de contenido cerrada |
pom_ai_mcp_forbidden |
No hay edit_post en esa página |
| El diseño se rompió | Contenido de maquetador sustituido en lugar de editado |
| La URL cambió | Se pasó slug |
| Las páginas hijas se movieron | Cambió el slug de una página padre |
| El sitio muestra la versión antigua | Caché no purgada |
Relacionado
wp_get_page— llama siempre a esto primerowp_update_post- Actualizar una página de forma segura