Problem/Motivation

Currently, the Admin Audit Trail module does not track changes made to Group entities provided by the Group
module.
Administrators need visibility into when groups are created, updated, or deleted for compliance, accountability, and troubleshooting purposes.

Without this functionality:

  • Group creation, update, and deletion events are not logged.
  • Audit reports lack visibility into structural and permission-related changes within the Group system.

Proposed resolution

Create a new submodule named Admin Audit Trail Group (admin_audit_trail_group) that integrates with the Admin Audit Trail and Group modules to log all CRUD operations on Group entities.

Implementation details

  • Log group_insert, group_update, and group_delete hook events.
  • Store each event with:
    • Type: group
    • Operation: insert, update, or delete
    • Description: a human-readable string (e.g., “Group Engineering created”)
    • Reference (numeric): group entity ID
    • Reference (char): group title
  • Integrate seamlessly with the Admin Audit Trail logging system.
  • Group Creation Tracking – Logs every new group added to the site
  • Group Update Tracking – Logs changes to existing groups
  • Group Deletion Tracking – Logs when a group is removed
  • Human-readable audit messages
  • Automatic integration with Admin Audit Trail reports

Remaining tasks

  • ✅ File an issue
  • ✅ Addition/Change/Update/Fix
  • ✅ Testing to ensure no regression
  • ➖ Automated unit testing coverage
  • ➖ Automated functional testing coverage
  • ➖ UX/UI designer responsibilities
  • ➖ Readability
  • ➖ Accessibility
  • ➖ Performance
  • ➖ Security
  • ➖ Documentation
  • ✅ Code review by maintainers
  • ✅ Full testing and approval
  • ✅ Credit contributors
  • ✅ Review with the product owner
  • ✅ Release notes snippet
  • ✅ Release admin_audit_trail-1.0.6

API changes

  • N/A

Data model changes

  • N/A

Release notes snippet

  • feat: #3461358 Added Admin Audit Trail Group sub module to support trail changes on group entity By: @YazanMajadba
Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

YazanMajadba created an issue. See original summary.

yazanmajadba’s picture

Priority: Normal » Major

rajab natshah made their first commit to this issue’s fork.

rajab natshah’s picture

Assigned: Unassigned » s.halawani
Issue summary: View changes
Issue tags: +admin_audit_trail-1.0.5
rajab natshah’s picture

Assigned: s.halawani » Unassigned
Status: Needs review » Fixed

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

rajab natshah’s picture

Issue summary: View changes
rajab natshah’s picture

Issue summary: View changes
rajab natshah’s picture

Issue summary: View changes

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.