Content Moderation Notifications
Envía notificaciones por correo electrónico a los usuarios cuando el contenido cambia entre estados de moderación a través del módulo Content Moderation de Drupal.
content_moderation_notifications
Install
composer require 'drupal/content_moderation_notifications:8.x-3.8'
composer require 'drupal/content_moderation_notifications:8.x-3.4'
Overview
El módulo Content Moderation Notifications extiende la funcionalidad del Content Moderation del núcleo de Drupal habilitando notificaciones automáticas por correo electrónico cuando el contenido experimenta transiciones de estado en el flujo de trabajo. Esto es esencial para los flujos de trabajo editoriales donde los miembros del equipo necesitan ser informados sobre los cambios de estado del contenido.
El módulo permite a los administradores del sitio crear múltiples reglas de notificación, cada una dirigida a transiciones específicas del flujo de trabajo. Las notificaciones pueden enviarse a usuarios con roles específicos (con verificación de acceso), al autor del contenido, a direcciones de correo electrónico personalizadas o a usuarios referenciados en campos de referencia de entidad. El módulo soporta plantillas Twig en el asunto del correo, el cuerpo y los campos de correo ad hoc, proporcionando opciones de personalización potentes que incluyen lógica condicional y acceso a campos de entidad.
Todos los destinatarios, excepto los correos ad hoc, son verificados para permisos de acceso antes del envío, asegurando que los usuarios solo reciban notificaciones del contenido que pueden ver. Los correos se envían utilizando encabezados BCC para proteger la privacidad de los destinatarios, con el correo del sitio opcionalmente incluido como destinatario principal.
Features
- Crear múltiples reglas de notificación para diferentes transiciones del flujo de trabajo
- Enviar notificaciones a todos los usuarios con roles especificados (con verificación de acceso de visualización de entidad)
- Enviar notificaciones al autor del contenido
- Enviar notificaciones a direcciones de correo electrónico personalizadas/ad hoc
- Enviar notificaciones a usuarios referenciados en campos de referencia de entidad en el contenido
- Soporte de plantillas Twig en el asunto del correo, cuerpo y campos de direcciones de correo ad hoc
- Soporte de reemplazo de Token en el contenido del correo (mejorado cuando el módulo Token está instalado)
- Habilitar/deshabilitar notificaciones individuales sin eliminarlas
- Acceso a variables de contexto de entidad y usuario en plantillas Twig (título de entidad, bundle, información del propietario, información del usuario actual)
- Selección de formato de texto para el contenido del cuerpo del correo
- Soporta todos los flujos de trabajo de Content Moderation definidos en el núcleo de Drupal
- Entrega de correo basada en BCC para privacidad de los destinatarios
- Omitir notificaciones durante la sincronización de entidades (ej. migraciones)
- Hook alter para personalizar los datos de notificación antes del envío
Use Cases
Notificaciones de flujo de trabajo de revisión editorial
Configure notificaciones para alertar a los editores cuando se envía contenido para revisión. Cree una notificación para la transición 'Enviar para revisión', asigne roles de editor como destinatarios e incluya detalles de la entidad como título, autor y enlace directo al contenido en el cuerpo del correo usando variables Twig.
Notificación al autor sobre publicación
Notifique a los autores de contenido cuando su contenido ha sido publicado. Cree una notificación para la transición 'Publicar', habilite la opción 'Enviar correo al autor' y redacte un mensaje de felicitación que incluya la URL publicada usando plantillas Twig.
Notificaciones específicas por departamento
Envíe notificaciones a los gerentes de departamento referenciados en un campo de contenido. Añada un campo de referencia de entidad de usuario (ej. field_department_manager) a su tipo de contenido, luego seleccione este campo en la sección 'Campos de referencia de entidad de usuario'. Los gerentes recibirán automáticamente notificaciones para las transiciones de contenido de su departamento.
Listas dinámicas de destinatarios vía Twig
Use plantillas Twig en el campo de direcciones de correo ad hoc para determinar dinámicamente los destinatarios basándose en valores de campos del contenido. Por ejemplo, acceda al campo de correo de una entidad referenciada: {{ entity.field_department.entity.field_manager_email.0.value }}
Contenido de correo condicional
Use condicionales Twig en el cuerpo del correo para personalizar mensajes basándose en propiedades del contenido. Por ejemplo, añada instrucciones especiales para contenido urgente o incluya información diferente según el tipo de contenido.
Flujo de trabajo de aprobación multi-paso
Cree notificaciones separadas para cada paso en un flujo de trabajo de aprobación complejo. Configure notificaciones distintas para las transiciones Borrador a Revisión, Revisión a Legal, Legal a Aprobación Final y Aprobación Final a Publicado, cada una dirigida a los miembros apropiados del equipo.
Tips
- Use el módulo Token para navegar e insertar fácilmente los tokens disponibles en sus plantillas de notificación
- Al enviar a roles, solo los usuarios que pueden ver el contenido recibirán notificaciones - esto previene la fuga de información
- La dirección de correo del sitio se usa como destinatario principal por defecto. Marque 'Deshabilitar la dirección de correo del sitio' si desea que las notificaciones se envíen solo a destinatarios BCC
- Las variables Twig disponibles incluyen: entity (el contenido), user (usuario actual), además de propiedades abreviadas como entity.title, entity.bundle, entity.owner.email
- Combine condicionales Twig con campos de entidad para crear contenido de notificación dinámico y sensible al contexto
- Pruebe las notificaciones en un entorno de desarrollo antes de desplegar a producción para asegurar que las plantillas se rendericen correctamente
- Las notificaciones no se envían durante migraciones o cuando las entidades están sincronizando - esto es intencional para prevenir avalanchas de notificaciones
Technical Details
Admin Pages 6
/admin/config/workflow/notifications
Lista todas las notificaciones de moderación de contenido configuradas en formato tabular. Cada fila muestra la etiqueta de la notificación, el flujo de trabajo asociado, el estado (habilitado/deshabilitado), las transiciones que la activan, los roles que la reciben, si se envía correo al autor y cualquier dirección de correo ad hoc. Proporciona operaciones para editar, eliminar, habilitar o deshabilitar cada notificación.
/admin/config/workflow/notifications/add
Formulario para crear una nueva regla de notificación de moderación de contenido. Configure qué transiciones del flujo de trabajo activan la notificación, quién debe recibirla y redacte el contenido del correo con plantillas Twig opcionales.
/admin/config/workflow/notifications/manage/{content_moderation_notification}
Formulario para modificar una regla de notificación de moderación de contenido existente. Todos los campos del formulario de añadir están disponibles para edición.
/admin/config/workflow/notifications/manage/{content_moderation_notification}/delete
Formulario de confirmación para eliminar permanentemente una regla de notificación de moderación de contenido.
/admin/config/workflow/notifications/manage/{content_moderation_notification}/enable
Formulario de confirmación para habilitar una regla de notificación deshabilitada. Una vez habilitada, se enviarán correos cuando ocurran las transiciones configuradas.
/admin/config/workflow/notifications/manage/{content_moderation_notification}/disable
Formulario de confirmación para deshabilitar una regla de notificación activa. Las notificaciones deshabilitadas no enviarán correos hasta que se vuelvan a habilitar.
Permissions 1
Hooks 1
hook_content_moderation_notification_mail_data_alter
Permite a los módulos modificar los datos del correo antes de que se envíe una notificación. Este hook se invoca después de que se han recopilado todos los destinatarios y antes de que se envíe el correo.
Security Notes 4
- Las direcciones de correo ad hoc no pasan por verificación de acceso - use con precaución e incluya solo direcciones de confianza
- Los destinatarios basados en rol son verificados para acceso de visualización de entidad antes de recibir notificaciones
- Los correos se envían vía BCC para proteger la privacidad de los destinatarios y prevenir problemas de responder a todos
- El módulo respeta la seguridad de formato de texto de Drupal - elija formatos apropiados para el contenido del cuerpo del correo