wp_delete_comment: eliminar un comentario
Elimina un comentario de forma permanente. No pasa a la papelera.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
comment_id |
Sí | El comentario |
dry_run |
No | Informar sin eliminar |
Permisos
Allow content writes abierto, y moderate_comments.
No hay paso por la papelera
A diferencia de la eliminación del administrador de WordPress, que normalmente primero envía a la papelera, esta herramienta elimina el comentario por completo. La recuperación implica una copia de seguridad de la base de datos.
wp_trash_comment es el equivalente reversible, y es la opción correcta para casi todo.
Cuándo la eliminación es realmente la acción correcta
Tres casos, y son muy concretos:
Una solicitud de borrado de datos. Alguien ha pedido que se eliminen sus datos personales y has decidido que la solicitud es válida. Enviar a la papelera no satisface esa petición; el contenido permanece en la base de datos.
Contenido que no debe permanecer en el servidor. Material ilegal, o algo que tus obligaciones legales exigen eliminar en lugar de ocultar.
Un comentario que creaste por error con wp_create_comment y que quieres que desaparezca por completo.
Todo lo demás —spam, fuera de tema, abusivo, duplicado— se atiende mejor con spam o papelera.
Las solicitudes de borrado no son una delegación
Si estás eliminando a causa de una solicitud de datos, esa es una decisión con peso legal. Tómala tú mismo, deja constancia de que la tomaste y sigue el procedimiento que tenga tu organización.
No lo formules como una instrucción que un asistente interpreta:
Elimina el comentario 4433.
No:
Elimina los comentarios que contienen datos personales.
La segunda pide al asistente que identifique datos personales en toda una sección de comentarios y actúe de forma irreversible basándose en su propio criterio.
Léelo antes de eliminar
La simulación informa del ID del comentario y de la acción —no del contenido—. Así que confirma que tienes el argumento correcto, no el comentario correcto.
Muéstrame el comentario 4433 completo. Después elimínalo.
En el caso de una solicitud de borrado en particular, querrás haber visto exactamente qué se está eliminando e, idealmente, haberlo dejado constancia en algún lugar apropiado antes de que desaparezca.
Qué devuelve
Si la eliminación se realizó correctamente.
Nunca delegues el criterio
La forma más contundente de la regla de este capítulo. Una eliminación de comentarios basada en criterios combina tres malas propiedades: es irreversible, se aplica a las palabras de otras personas y se basa en un juicio que el asistente no puede emitir.
Nombra un ID cada vez.
Después de eliminar
- El comentario desaparece de la entrada y de la base de datos.
- Purga la caché: una página en caché aún puede mostrarlo, lo que resulta confuso durante una solicitud de borrado.
- Comprueba el recuento de comentarios de la entrada si tu tema lo muestra.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura es rechazada | La puerta de escritura de contenido está cerrada |
pom_ai_mcp_forbidden |
Sin moderate_comments |
| No se puede recuperar | Correcto; no hay paso por la papelera |
| El comentario sigue apareciendo | En caché |
| Se eliminó más de lo previsto | Se delegó un criterio |
Relacionado
wp_trash_comment— la alternativa reversiblewp_spam_comment- Recuperarse de una escritura fallida