wp_delete_media: eliminar medios

Elimina un adjunto. La escritura menos recuperable de los grupos de WordPress y aquella con la que más conviene ser reacio.

Argumentos

Permisos

Allow content writes abierto y delete_post sobre el adjunto.

Eliminar medios no es como eliminar una entrada

Una entrada eliminada va a la papelera y puede restaurarse desde el administrador de WordPress. Los medios no se comportan igual en la práctica: WordPress solo envía los adjuntos a la papelera cuando la papelera de medios está habilitada explícitamente en el sitio, y la mayoría de las instalaciones no la habilitan.

En un sitio típico, eliminar un adjunto borra el registro y los archivos del disco: el original y todos los tamaños generados. No hay restauración, y recuperarlo exige una copia de seguridad tanto de la base de datos como del directorio de subidas.

Trata cada eliminación de medios como permanente salvo que hayas confirmado específicamente lo contrario en ese sitio.

Nada te dice dónde se usaba

Este es el riesgo real. WordPress no registra qué entradas, páginas, diseños del maquetador, ajustes del tema, widgets o galerías de productos referencian un adjunto, y esta herramienta tampoco.

Eliminar una imagen que está en uso produce imágenes rotas allá donde aparecía, descubiertas más tarde por un visitante y no de inmediato por ti.

Antes de eliminar, establece dónde se usa —y ninguna herramienta MCP puede hacerlo por ti—. Consulta los detalles del medio en el administrador de WordPress, busca el nombre de archivo en el contenido o usa un plugin diseñado para esa tarea.

Si no puedes establecer que un adjunto no se usa, no lo elimines.

Haz siempre una prueba en seco

dry_run devuelve el ID que eliminaría, y nada más; no el registro.

Eso es poco, así que acompáñalo de una lectura:

Lee el medio 1180 y muéstrame su título y su URL. Después usa una prueba en seco para la eliminación.

Confirmar la URL es lo que te dice qué imagen está a punto de desaparecer.

Qué devuelve

deleted y el id. No el registro: léelo primero si quieres que quede anotado en algún sitio.

Nunca delegues el criterio

Nombra los IDs:

Elimina los medios 1180 y 1181. Nada más.

No digas «elimina las imágenes no usadas». Un asistente no puede determinar qué no se usa, así que esa instrucción le pide adivinar, con una operación irreversible y sin forma de comprobar su trabajo.

Este es el caso más claro de la documentación en el que una instrucción plural basada en un criterio sencillamente debería rechazarse.

Alternativas que conviene preferir

• Déjalo. Un adjunto sin usar cuesta espacio en disco y nada más. El disco es más barato que una imagen de cabecera rota en una página de servicio.
• Sustituye en lugar de eliminar. Las propias herramientas de imagen de POM AI pueden sustituir un adjunto y reescribir las referencias en todo el sitio: una operación distinta con una historia de seguridad diferente. Consulta Sustituir una imagen allí donde aparece.
• Haz una auditoría real con un plugin que mapee el uso y luego elimina desde el administrador de WordPress, donde puedes ver las consecuencias.

Después de eliminar

• Revisa las páginas en las que estaba la imagen, si las conoces.
• Revisa las páginas de archivo y de listado.
• Purga la caché: una página en caché puede seguir mostrando una imagen cuyo archivo ya no existe, lo que retrasa el descubrimiento.

Problemas comunes

Relacionado

• wp_get_media_item — lee antes de eliminar
• Sustituir el original o crear un adjunto nuevo
• Recuperarse de una escritura fallida