wp_trash_comment: mueve un comentario a la papelera
Mueve un comentario fuera de la vista sin destruirlo.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
comment_id |
Sí | El comentario |
dry_run |
No | Informa sin escribir |
Permisos
Allow content writes abierto, y moderate_comments.
La herramienta adecuada para lo no deseado pero genuino
Usa esta opción cuando un comentario no debería estar en el sitio pero no es spam:
- fuera de tema, pero escrito de buena fe;
- abusivo u ofensivo;
- contiene datos personales que el autor no debería haber publicado públicamente;
- es un duplicado;
- es una queja genuina que quieres gestionar en privado.
Para el spam real, usa wp_spam_comment en su lugar, para que el filtro aprenda algo.
La distinción importa en ambos sentidos. Marcar el mensaje de una persona real como spam puede afectarle más allá de tu sitio; enviar spam a la papelera no le enseña nada a tu filtro.
Es reversible
El comentario se mueve a Comments → Trash y puede restaurarse desde el administrador de WordPress hasta que se vacíe la papelera.
Eso lo convierte en el valor por defecto apropiado siempre que quieras que algo desaparezca y no estés seguro de que deba destruirse. Entre la papelera y wp_delete_comment, prefiere esta opción.
Los datos personales son un caso para la eliminación, no para la papelera
Vale la pena señalar una excepción: si un comentario debe eliminarse porque contiene datos personales que alguien te ha pedido borrar, enviarlo a la papelera no basta. El contenido permanece en la base de datos.
Se trata de una decisión deliberada y documentada que debes tomar según tu propio procedimiento — no es algo que debas delegar. Consulta wp_delete_comment.
Enviar a la papelera por ID
Envía a la papelera los comentarios 4430 y 4431.
Como con toda acción sobre comentarios, indica IDs en lugar de un criterio. \"Envía a la papelera los que están fuera de tema\" le pide al asistente que juzgue qué está dentro del tema para tu sitio.
Qué devuelve
El ID del comentario y su nuevo estado.
La ejecución de prueba
Informa del ID y de la acción. No devuelve el contenido del comentario, así que lee primero el comentario si estás actuando sobre el resumen que otra persona ha hecho de él.
Después de enviar a la papelera
- El comentario desaparece de la entrada inmediatamente.
- Purga la caché si en el sitio aparecen recuentos de comentarios.
- La papelera se acumula hasta que se vacíe desde el administrador de WordPress.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Compuerta de escritura de contenido cerrada |
pom_ai_mcp_forbidden |
No hay moderate_comments |
| El comentario sigue apareciendo | La caché no se ha purgado |
| En realidad era spam | Nada se rompe, pero tu filtro no aprendió nada |
| El contenido sigue en la base de datos | Correcto; la papelera no es eliminación |
Relacionado
wp_spam_comment— para spamwp_delete_comment— cuando debe desaparecer- Revisar y moderar comentarios