Download the PHP package fromholdio/silverstripe-configured-groups without Composer
On this page you can find all versions of the php package fromholdio/silverstripe-configured-groups. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fromholdio/silverstripe-configured-groups
More information about fromholdio/silverstripe-configured-groups
Files in fromholdio/silverstripe-configured-groups
Package silverstripe-configured-groups
Short Description Use configuration to define security groups
License BSD-3-Clause
Homepage https://github.com/fromholdio/silverstripe-configured-groups
Informations about the package silverstripe-configured-groups
silverstripe-configured-groups
Silverstripe module that provides mechanism to configure security groups via yml config.
Requirements
- 2.x branch currently supports both SilverStripe 4 & 5.
Rationale
For many sites, the core security groups and their key permissions should not be changed by CMS users.
It leaves open the possibility of users breaking permission configurations, deletion of groups that would have consequential impacts throughout the site, and so forth.
Having these managed via CMS also means that developers moving & deploying between environments must port group configurations manually.
Instead, this module provides yml config:
- Configuration of groups, and their assigned permissions, initialised on dev/build
- If no ADMIN group is configured, the default 'administrators' group will remain in place
- Can force only configured groups as root groups (ie. CMS user cannot add new top-level groups)
- On per configured group basis, dis/allow CMS users adding new sub-groups (by extension, allowing or preventing CMS users adding new groups at all)
- Can force only configured permissions per group (ie. any permissions set via CMS checkbox, that are not in yml config, are deleted on dev/build)
- For configured groups, title, description and parent cms fields are read-only
- Where a configured group's permissions are set to only a configured set, the permissions checkbox set is read-only
- A configured group can be marked as hidden, and will not be displayed to users who are not direct members of that group (used to obfuscate the administrators group when only utilised by developers, for instance)
Installation
Install the module using composer:
Then apply your own group configuration (see below) and run dev/build.
Config examples
- Out of the box, no configuration is applied, only the extension itself. You need to compose your groups configuration per example below:
License
BSD 3-Clause License, see License