dermalikmann / auto_groups

👥 Auto Groups app for Nextcloud

Nextcloud Auto Groups

Automatically add users to specified Auto Groups, except for those belonging to one of the specified Override Groups.

Test Status

Nextcloud Server Branch	Unit & Integration Tests	Code Coverage
stable22
stable23
stable24
stable25
stable26
stable27
stable28
master

Unit and Integration Tests are executed with PHP v7.4 as well as v8.0 and v8.1.

Usage

• Install and enable the App
• Go to "Settings > Administration > Additional settings" to configure the Auto Groups, Override Groups and further behavior.

Note that this app prevents group deletions for groups referenced as Auto Groups or Override Groups.

Manual Testing

To manually test the app, an automatic script is provided. You need to have Docker installed and running to execute it. Simply go for

$ ./tests/Docker/run-docker-test-instance.sh

and then access your test instance on http://localhost:8080. The auto_groups app is automatically available, but not activated - this needs to be done manually.

Comparison to similar Apps

• Everyone Group: The "Everyone Group" app adds a virtual Group Backend, always returning all users. In contrast, "Auto Groups" operates on "real" groups in your normal Group Backend. Additionally, it is possible to specify Override Groups which will prevent users from being added to the Auto Group(s).
• Default Group: "Auto Groups" is actually a modernized and maintaned fork of "Default Group", which seems to be abandoned since NC12 or so. In terms of functionality, they are almost identical.

In addition, I plan to add some more features over time, e.g., "Union Groups" - see the Milestone Plans for more details.

Issue Tracker / Contributions

Contributions are welcome on GitHub.

Acknowledgements

This app is based on the seemingly no-longer maintained defaultgroup app, which is only verified to work up to NC14 and uses the deprecated Hooks mechanism instead of the now recommended OCP Event Dispatcher.