Referencia de herramientas de WordPress para comentarios y metadatos
Diez herramientas que cubren dos cosas sin relación entre sí, pero que comparten capítulo: la moderación de comentarios y los campos personalizados de las entradas.
Herramientas de comentarios
| Herramienta | Función | Escribe |
|---|---|---|
wp_get_comments |
Lista los comentarios | |
wp_get_pending_comments |
Lista la cola de moderación | |
wp_approve_comment |
Aprueba uno | Sí |
wp_spam_comment |
Marca como spam | Sí |
wp_trash_comment |
Mueve a la papelera | Sí |
wp_delete_comment |
Elimina de forma permanente | Sí |
wp_create_comment |
Crea un comentario | Sí |
Herramientas de metadatos de entradas
| Herramienta | Función | Escribe |
|---|---|---|
wp_get_post_meta |
Lee los metadatos de la entrada | |
wp_update_post_meta |
Escribe los metadatos de la entrada | Sí |
wp_delete_post_meta |
Elimina los metadatos de la entrada | Sí |
Permisos
Toda herramienta de comentarios — incluida la lectura — requiere moderate_comments. No hay una vista de comentarios sin autenticación, ni siquiera de los aprobados.
Toda herramienta de metadatos requiere edit_post sobre la entrada concreta. Leer los campos personalizados de una entrada se trata como editar esa entrada, lo cual es más estricto que leer la propia entrada.
Todas las escrituras necesitan además Allow content writes abierto. Los ámbitos en todo momento son mcp:read y wp:content:read, más el par de escritura para las operaciones de escritura.
Las cuatro acciones de moderación no son equivalentes
| Acción | Reversible | Alimenta el filtro de spam |
|---|---|---|
| Aprobar | Sí | No |
| Spam | Sí | Sí |
| Papelera | Sí | No |
| Eliminar | No | No |
Usa spam para el spam, de modo que el filtro aprenda. Usa papelera para todo lo demás que quieras que desaparezca. Reserva eliminar para el contenido que no deba permanecer en el servidor.
Los comentarios los escriben personas reales
Un asistente que decide qué publicar o eliminar está tomando una decisión editorial en tu nombre, sobre un texto que alguien te escribió.
La división productiva es que el asistente agrupe y resuma, y que tú decidas. Nombra los IDs de comentario en lugar de delegar un criterio. Consulta Review and moderate comments.
Los comentarios también pueden contener datos personales — un número de teléfono, una dirección, detalles del pedido. Leerlos transmite esos datos al cliente conectado.
Los metadatos de las entradas son territorio de los plugins
Las claves de metadatos pertenecen a cualquier plugin o tema que las haya creado. Nada en estas herramientas valida que una clave exista, que un valor tenga la forma correcta o que algo espere lo que escribes.
Los fallos no son errores. Son una página que se muestra de forma extraña, un campo que deja de aparecer o un ajuste que vuelve a un valor por defecto — descubiertos más tarde y difíciles de atribuir.
Si no puedes decir qué plugin posee una clave y qué formato espera, no escribas en ella.
Las claves tipo secreto se rechazan
Las claves de metadatos cuyos nombres coinciden con un patrón de credenciales — que contengan secret, password, credential, salt, auth key, nonce key, license key, api key, auth token, private key, session token, refresh token, access token o recovery key — se rechazan con pom_ai_mcp_meta_denied, tanto para lecturas como para escrituras.
La protección actúa sobre el nombre de la clave, de modo que es una coincidencia de patrón y no una garantía sobre el contenido.
No hay deshacer para los metadatos
Los metadatos de las entradas no tienen historial de revisiones. Un valor sobrescrito o eliminado se pierde salvo que lo hayas anotado o restaures una copia de seguridad.
Lee antes de escribir, siempre:
Muéstrame el valor actual de esa clave y luego cámbialo.
Relacionado
- Review and moderate comments
- Content tools
- Taxonomy tools para los metadatos de términos