Group Actions
Proporciona acciones configurables para el módulo Group, permitiendo operaciones masivas sobre membresías de grupo y contenido de grupo.
group_action
Instalar
composer require 'drupal/group_action:^1.2'
composer require 'drupal/group_action:^1.1'
Overview
Group Actions es un módulo de Drupal que extiende el módulo Group proporcionando un conjunto de plugins de acción configurables. Estas acciones permiten a los administradores del sitio y desarrolladores realizar operaciones masivas sobre entidades relacionadas con grupos, como agregar o eliminar usuarios como miembros del grupo, y agregar, actualizar o eliminar contenido de los grupos.
El módulo está diseñado para usarse en conjunto con otros módulos que aprovechan el sistema de acciones de Drupal, como Views Bulk Operations (VBO) para realizar operaciones por lotes en listados de vistas, o ECA (Event - Condition - Action) para crear flujos de trabajo automatizados activados por eventos. Las acciones soportan reemplazo de tokens para configuración dinámica, haciéndolas altamente flexibles para escenarios de automatización complejos.
Group Actions es totalmente compatible con las versiones 1.x, 2.x y 3.x del módulo Group, detectando y adaptándose automáticamente a las diferencias de API de la versión instalada.
Features
- Agregar usuarios como miembros a grupos con roles de grupo configurables
- Eliminar usuarios de las membresías de grupo
- Actualizar membresías de grupo existentes con nuevos valores de campo o roles
- Agregar entidades de contenido (nodes, etc.) a grupos como contenido de grupo
- Eliminar contenido de los grupos
- Actualizar valores de campo del contenido de grupo
- Soporte de tokens para configuración dinámica de IDs de grupo, IDs de entidad y valores de campo
- Métodos de adición configurables: omitir si ya está agregado, agregar siempre, o actualizar existente
- Autocompletado de entidad para selección de grupo en formularios de configuración
- Compatibilidad total con las versiones 1.x, 2.x y 3.x del módulo Group
- Compatibilidad con el módulo ECA con manejo especial de umbral de recursión
Use Cases
Agregar usuarios a grupos masivamente vía Views
Crear una vista de usuarios y usar Views Bulk Operations para agregar la acción 'Group: agregar usuario como miembro'. Seleccionar múltiples usuarios de la vista y agregarlos todos a un grupo específico con roles asignados en una sola operación.
Gestión automatizada de membresías con ECA
Configurar un modelo ECA que se active cuando un usuario es creado o actualizado. Basándose en condiciones (como rol de usuario o valores de campo de perfil), agregar automáticamente al usuario a los grupos apropiados usando la acción 'Group: agregar usuario como miembro' con configuración basada en tokens.
Flujo de trabajo de organización de contenido
Cuando el contenido es publicado o actualizado, agregarlo automáticamente a los grupos relevantes basándose en términos de taxonomía u otros valores de campo. Usar ECA con la acción 'Group: agregar contenido' y tokens para determinar dinámicamente el grupo de destino.
Eliminación masiva de contenido de grupos
Usar VBO con la acción 'Group: eliminar contenido' para limpiar relaciones de contenido de grupo. Útil para reorganizar contenido entre grupos o eliminar contenido desactualizado de los listados de grupo.
Actualizar roles de grupo masivamente
Seleccionar usuarios que ya son miembros del grupo y usar la acción 'Group: actualizar membresía de usuario' con VBO para cambiar sus roles de grupo (ej., promover miembros a administradores) en una operación masiva.
Asignación dinámica de grupo basada en tokens
Configurar acciones con valores de token como [node:field_department:entity:id] para agregar dinámicamente contenido a grupos basándose en valores de campo de la entidad. Esto permite el enrutamiento automático de contenido a los grupos apropiados sin configuración manual.
Tips
- Usar el método de adición 'skip_existing' (predeterminado) para prevenir relaciones de grupo duplicadas al ejecutar acciones sobre conjuntos mixtos de entidades que pueden ya ser miembros del grupo.
- Configurar IDs de grupo basados en tokens para crear flujos de trabajo dinámicos donde el grupo de destino se determina por valores de campo de la entidad en lugar de estar codificado.
- Al establecer roles de grupo vía el campo 'values', usar el formato 'group_roles: grouptype-roleid' donde el ID del rol incluye el prefijo del tipo de grupo.
- El autocompletado de entidad para selección de grupo proporciona una forma amigable de seleccionar grupos durante la configuración, pero también puedes ingresar IDs numéricos o UUIDs directamente.
- Para modelos ECA, puedes usar tokens de cualquier tipo de entidad al reemplazar valores, haciendo posible buscar entidades relacionadas y usar sus propiedades en la configuración.
Technical Details
Troubleshooting 5
Asegurarse de que el módulo Group esté correctamente instalado y configurado con al menos un tipo de grupo. Los plugins de acción requieren que los gestores de plugins del módulo Group estén disponibles.
Las acciones verifican permisos contra el sistema de permisos del grupo. Asegurarse de que el usuario que ejecuta la acción tenga los permisos de grupo apropiados (ej., 'create group_membership content', 'delete group_membership content') para el tipo de grupo de destino.
El plugin de contenido (tipo de relación de grupo) debe estar instalado para el tipo de grupo. Configurar el tipo de grupo en Administración > Estructura > Tipos de grupo y asegurarse de que el plugin de contenido deseado esté habilitado.
Verificar que la sintaxis del token sea correcta (ej., [user:uid], [node:nid]). Asegurarse de que el módulo Token esté instalado si se usan tokens avanzados. Comprobar que la entidad siendo procesada proporcione el contexto de token esperado.
Esto puede ocurrir debido a la detección de recursión de ECA cuando las operaciones de grupo disparan guardados de entidad adicionales. El módulo incluye manejo automático para esto, pero si los problemas persisten, verificar la configuración del umbral de recursión de ECA.
Security Notes 3
- Las acciones respetan el sistema de permisos de grupo de Drupal. Los usuarios deben tener los permisos apropiados a nivel de grupo para ejecutar acciones sobre grupos específicos.
- Los usuarios administradores (usuario 1 y usuarios con roles de administrador) omiten las verificaciones de permisos de grupo para estas acciones.
- El reemplazo de tokens se realiza del lado del servidor con sanitización apropiada, pero asegurarse de que datos sensibles no se expongan a través de valores de token en logs o mensajes de error.