From: Matthias Schmidt <gravatronics@live.com>
Date: Fri, 2 Jul 2021 08:45:37 +0000 (+0200)
Subject: Document new wildcard category filtering for `AclFormField`
X-Git-Tag: 5.6.final~208
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=81646f6e612de9f7c57c2f795b521c67c806c03c;p=GitHub%2FWoltLab%2Fwoltlab.github.io.git

Document new wildcard category filtering for `AclFormField`

See WoltLab/WCF#4355
---

diff --git a/docs/php/api/form_builder/form_fields.md b/docs/php/api/form_builder/form_fields.md
index 3f60deaa..4d22d08b 100644
--- a/docs/php/api/form_builder/form_fields.md
+++ b/docs/php/api/form_builder/form_fields.md
@@ -203,6 +203,8 @@ The class implements `IObjectTypeFormField` and requires an object type of the o
 Additionally, the class provides the methods `categoryName($categoryName)` and `getCategoryName()` that allow setting a specific name or filter for the acl option categories whose acl options are shown.
 A category name of `null` signals that no category filter is used.
 
+!!! info "Since version 5.5, the category name also supports filtering using a wildcard like `user.*`, see [WoltLab/WCF#4355](https://github.com/WoltLab/WCF/pull/4355)."
+
 `AclFormField` objects register a [custom form field data processor](validation_data.md#customformfielddataprocessor) to add the relevant ACL object type id into the `$parameters` array directly using `{$objectProperty}_aclObjectTypeID` as the array key.
 The relevant database object action method is expected, based on the given ACL object type id, to save the ACL option values appropriately.