Skip to content

stjosh/auto_groups

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 Unit and Integration Tests  codecov
stable23 Unit and Integration Tests  codecov
stable24 Unit and Integration Tests  codecov
stable25 Unit and Integration Tests  codecov
stable26 Unit and Integration Tests  codecov
stable27 Unit and Integration Tests  codecov
stable28 Unit and Integration Tests  codecov
master Unit and Integration Tests  codecov

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.