Moderation Note
Permite anotaciones de texto en línea sobre entidades de contenido moderado para colaboración editorial y retroalimentación.
moderation_note
Overview
El módulo Moderation Note proporciona un potente sistema de anotaciones para el flujo de trabajo de Content Moderation de Drupal. Permite a los editores y revisores seleccionar texto específico dentro de los campos de entidad y adjuntar notas directamente a esas selecciones, creando un sistema de retroalimentación contextual.
Al visualizar la última revisión de una entidad moderada, los usuarios con los permisos apropiados pueden resaltar texto en los tipos de campo compatibles y agregar notas con asignados opcionales. Las notas aparecen como resaltados amarillos en el contenido, con tooltips para una visualización fácil. El módulo soporta conversaciones encadenadas a través de respuestas, permitiendo discusiones colaborativas directamente sobre el contenido.
Las notas pueden resolverse cuando la retroalimentación ha sido atendida, con la posibilidad de reabrirlas si es necesario. El módulo se integra con la barra de herramientas de Drupal para mostrar a los usuarios el conteo de sus notas asignadas, y agrega una pestaña "Ver Notas" a las entidades moderadas mostrando el conteo total de notas.
Las notificaciones por correo electrónico mantienen informados a los interesados cuando las notas son creadas, asignadas, resueltas, reabiertas o respondidas. El módulo también proporciona integración con Views para construir interfaces personalizadas de gestión de notas.
Features
- Anotación con selección de texto en línea - selecciona texto dentro de los campos de entidad y adjunta notas directamente al contenido resaltado
- Sistema de asignación de notas - asigna notas a usuarios específicos que tienen permiso para acceder a las notas de moderación
- Conversaciones encadenadas - responde a notas existentes para facilitar discusiones colaborativas
- Gestión del ciclo de vida de notas - resuelve notas cuando la retroalimentación ha sido atendida, reabre si es necesario, o elimina permanentemente
- Notificaciones por correo electrónico - correos automáticos enviados cuando las notas son creadas, asignadas, resueltas, reabiertas o respondidas
- Integración con la barra de herramientas - muestra el conteo de notas asignadas en la barra de herramientas de administración para acceso rápido
- Integración con tareas locales - agrega la pestaña "Ver Notas" a las entidades moderadas mostrando el conteo total de notas activas
- Soporte multilingüe - las notas están vinculadas a traducciones de idiomas específicos, permitiendo revisión concurrente entre idiomas
- Integración con Views - expone los datos de notas de moderación para Views personalizados con relación al contenido anotado
- Tipos de campo soportados: text, text_long, text_with_summary, string, string_long, entity_reference, entity_reference_revisions, boolean, datetime, list_string
- Interfaz impulsada por AJAX - crea, edita, responde, resuelve y elimina notas sin recargar la página usando diálogos off-canvas
- Compatibilidad con Quick Edit - las notas de moderación se ocultan durante las sesiones de Quick Edit y se restauran después de guardar
Use Cases
Flujo de trabajo de revisión editorial
Los revisores de contenido pueden seleccionar pasajes específicos en contenido borrador y agregar notas solicitando cambios o haciendo preguntas. El autor del contenido recibe notificaciones por correo electrónico y ve las áreas resaltadas que requieren atención. Una vez que se realizan los cambios, el revisor puede resolver la nota. Esto crea un rastro de auditoría claro del proceso de revisión.
Colaboración de múltiples revisores
Múltiples editores pueden agregar notas al mismo contenido simultáneamente. Cada nota puede asignarse a un miembro específico del equipo responsable de atender esa retroalimentación. La barra de herramientas muestra a cada usuario su conteo de notas asignadas, facilitando el seguimiento de tareas pendientes.
Revisión de traducciones
Cuando el contenido es traducido, los revisores pueden agregar notas a versiones de idiomas específicos de forma independiente. Esto permite la revisión concurrente de traducciones sin interferencia, ya que las notas están vinculadas al código de idioma del contenido.
Recopilación de retroalimentación de clientes
Para agencias, los usuarios clientes pueden recibir permiso de creación de notas sin acceso de edición. Los clientes pueden resaltar texto y agregar notas de retroalimentación, que el equipo de contenido puede luego atender. El flujo de trabajo resolver/reabrir rastrea qué elementos de retroalimentación han sido manejados.
Proceso de QA de contenido
Los equipos de aseguramiento de calidad pueden usar notas para señalar problemas durante auditorías de contenido. La integración con Views permite construir paneles que muestran todas las notas abiertas en el sitio, filtrables por asignado, tipo de contenido o fecha de creación.
Tips
- Otorga el permiso 'ver última versión' a los usuarios de notas para que puedan acceder al contenido borrador que está siendo revisado
- Usa el permiso 'resolve moderation notes on editable entities' para permitir que los propietarios de contenido gestionen las notas en su contenido
- Personaliza las notificaciones por correo electrónico sobrescribiendo templates/mail-moderation-note.html.twig en tu tema
- Construye vistas personalizadas de gestión de notas usando la integración con Views proporcionada para rastrear notas en todo tu sitio
- Las notas soportan saltos de línea - presiona Enter en el texto de la nota para crear retroalimentación multilínea
Technical Details
Admin Pages 1
/admin/config/moderation-note
Configura los ajustes globales para el módulo Moderation Note, incluyendo las preferencias de notificación por correo electrónico.
Permissions 7
Hooks 2
hook_moderation_note_insert
Se activa cuando se crea una nueva nota de moderación. Se usa internamente para enviar notificaciones por correo electrónico e invalidar cache tags.
hook_moderation_note_update
Se activa cuando se actualiza una nota de moderación. Se usa internamente para manejar cambios de asignado y cambios de estado de publicación para notificaciones.
Troubleshooting 5
Asegúrate de que el tipo de entidad tiene Content Moderation habilitado, estás viendo la última revisión, el usuario tiene el permiso 'access moderation notes' y el tipo de campo es uno de los tipos soportados (text, string, entity_reference, etc.).
Verifica que el usuario tiene el permiso 'create moderation notes'. Si no pueden editar el contenido, también necesitan el permiso 'create moderation notes on uneditable entities'.
Verifica que el envío de correo electrónico esté habilitado en /admin/config/moderation-note. También verifica que el sistema de correo de tu sitio esté correctamente configurado y que los usuarios destinatarios tengan direcciones de correo electrónico válidas.
Esto puede suceder si el contenido se modifica significativamente después de que se crean las notas. El módulo usa coincidencia difusa para encontrar texto, pero cambios grandes pueden causar desalineación. En tales casos, el contexto de la cita se muestra en la nota para clarificar lo que fue seleccionado originalmente.
Asegúrate de que el usuario puede acceder a la barra de herramientas y tiene el permiso 'access moderation notes'. El enlace de la barra de herramientas solo aparece para usuarios con este permiso.
Security Notes 4
- El permiso 'administer moderation notes' otorga acceso completo a todas las notas y debe restringirse a administradores de confianza
- El texto de las notas se almacena como texto plano y se muestra con sanitización básica - evita permitir que usuarios no confiables creen notas si XSS es una preocupación
- Las notificaciones por correo electrónico incluyen contenido de notas - ten en cuenta que retroalimentación sensible puede ser enviada por correo electrónico
- El autocompletado de asignado solo muestra usuarios con el permiso 'access moderation notes' para prevenir divulgación de información