wp_delete_page: eliminar una página

Mueve una página a la papelera o la elimina de forma permanente. Es idéntico a wp_delete_post y es la escritura con consecuencias más amplias de este capítulo.

Argumentos

Argumento Obligatorio Significado
id Sí La página que se va a eliminar
force No Elimina de forma permanente en lugar de enviar a la papelera
dry_run No Informa sin eliminar

Permisos

Allow content writes abierto y delete_post en esa página concreta.

Considera despublicar en su lugar

Casi cualquier petición que suene como «elimina esta página» se resuelve mejor pasándola a borrador:

Pasa la página 88 a borrador.

Eso la retira del sitio, conserva el contenido, mantiene la URL reservada y es reversible en un solo paso. La eliminación no es ninguna de esas cosas.

Recurre a la eliminación solo cuando la página deba dejar de existir de verdad.

Mecánica

force, dry_run, papelera frente a permanente y la posición de recuperación se comportan exactamente como se describe en wp_delete_post. Envía a la papelera por defecto.

El resto de esta página trata de lo que hace distinta la eliminación de una página.

Eliminar una página rompe más que una entrada

Una página suele estar referenciada desde varios sitios, y la eliminación no actualiza ninguno de ellos:

Qué se rompe Por qué
Elementos del menú Una entrada del menú que apunta a una página eliminada
Enlaces internos Enlaces en el contenido de otras páginas
Páginas hijas Su página padre ya no existe
Enlaces de campaña y externos Cualquier cosa fuera del sitio
Resultados de búsqueda Hasta que los buscadores vuelvan a rastrear

Comprueba todo esto antes de eliminar. El caso de las páginas hijas es el que más se pasa por alto: eliminar una página padre deja a las hijas con una jerarquía rota y, según el tema, con URLs modificadas.

La simulación devuelve el registro incluido su link:

Usa una simulación y muéstrame la página que eliminarías, incluidos su título y su enlace.

Para una página, el enlace es la confirmación más útil de las dos. Los títulos se repiten en un sitio —varias páginas pueden llamarse «Servicios»—, mientras que la ruta de la URL es única y muestra dónde se sitúa la página en la jerarquía.

Antes de eliminar

  • [ ] Lee la página y confirma el título.
  • [ ] Busca enlaces internos hacia ella —consulta wp_search.
  • [ ] Revisa los menús de navegación.
  • [ ] Comprueba si tiene páginas hijas.
  • [ ] Decide si hace falta una redirección para la URL.
  • [ ] Confirma que despublicarla no serviría en su lugar.

Después de eliminar

  • Revisa el sitio en busca de enlaces rotos y elementos de menú huérfanos.
  • Configura una redirección si la URL tenía tráfico.
  • Purga la caché: una copia en caché de una página eliminada puede seguir sirviéndose.

Problemas habituales

Síntoma Causa
La escritura se rechaza La puerta de escritura de contenido está cerrada
pom_ai_mcp_post_not_found ID incorrecto
pom_ai_mcp_forbidden No hay delete_post en esa página
Desaparecida de forma permanente Se pasó force
El menú muestra una entrada muerta Los elementos del menú no se eliminan automáticamente
Las páginas hijas fallan Su página padre fue eliminada
La página sigue cargándose Está en caché
`wp_update_page`: actualizar una página
Anterior
Referencia de herramientas de medios de WordPress
Siguiente