Add info about invertedPermissions
authorjoshuaruesweg <ruesweg@woltlab.com>
Tue, 2 Nov 2021 09:40:06 +0000 (10:40 +0100)
committerjoshuaruesweg <ruesweg@woltlab.com>
Tue, 2 Nov 2021 09:40:06 +0000 (10:40 +0100)
docs/php/api/form_builder/form_fields.md

index e915acb47b274a4a395d584b48edd1de7bbd7f2c..f39d30d0f76dc484f698ea0663bad8e0f89ab4bd 100644 (file)
@@ -271,6 +271,9 @@ The default label of instances of this class is `wcf.form.field.option` and thei
 
 `SimpleAclFormField` objects register a [custom form field data processor](validation_data.md#customformfielddataprocessor) to add the relevant simple ACL data array into the `$parameters` array directly using the object property as the array key.
 
+!!! info "Since version 5.5, the field also supports inverted permissions, see [WoltLab/WCF#4570](https://github.com/WoltLab/WCF/pull/4570)."
+
+The `SimpleAclFormField` supports inverted permissions, allowing the administrator to grant access to all non-selected users and groups. If this behavior is desired, it needs to be enabled by calling `supportInvertedPermissions`. An `invertPermissions` key containing a boolean value with the users selection will be provided together with the ACL values when saving the field.
 
 ### `SingleMediaSelectionFormField`