>
+ */
+ public function getFilters(): array
+ {
+ return \array_values($this->filters);
+ }
+}
diff --git a/wcfsetup/install/files/lib/event/user/group/assignment/UserGroupAssignmentUpdated.class.php b/wcfsetup/install/files/lib/event/user/group/assignment/UserGroupAssignmentUpdated.class.php
new file mode 100644
index 00000000000..7b7e1660cc7
--- /dev/null
+++ b/wcfsetup/install/files/lib/event/user/group/assignment/UserGroupAssignmentUpdated.class.php
@@ -0,0 +1,23 @@
+
+ * @since 6.3
+ */
+final class UserGroupAssignmentUpdated implements IPsr14Event
+{
+ public function __construct(
+ public readonly UserGroupAssignment $assignment,
+ public readonly UserGroupAssignmentBuilder $builder,
+ ) {}
+}
diff --git a/wcfsetup/install/files/lib/form/AbstractFormBuilderForm.class.php b/wcfsetup/install/files/lib/form/AbstractFormBuilderForm.class.php
index a52b933ada1..94f5b310eca 100644
--- a/wcfsetup/install/files/lib/form/AbstractFormBuilderForm.class.php
+++ b/wcfsetup/install/files/lib/form/AbstractFormBuilderForm.class.php
@@ -179,7 +179,6 @@ public function save()
$formData['data'] = [];
}
$formData['data'] = \array_merge($this->additionalFields, $formData['data']);
-
$this->objectAction = new $this->objectActionClass(
\array_filter([$this->formObject]),
$action,
diff --git a/wcfsetup/install/files/lib/system/ad/AdHandler.class.php b/wcfsetup/install/files/lib/system/ad/AdHandler.class.php
index f0a975b94f0..1c5587fa8ec 100644
--- a/wcfsetup/install/files/lib/system/ad/AdHandler.class.php
+++ b/wcfsetup/install/files/lib/system/ad/AdHandler.class.php
@@ -7,6 +7,7 @@
use wcf\data\object\type\ObjectTypeCache;
use wcf\system\cache\builder\AdCacheBuilder;
use wcf\system\exception\SystemException;
+use wcf\system\object\filter\builder\AdObjectFilterBuilder;
use wcf\system\SingletonFactory;
use wcf\system\WCF;
@@ -31,6 +32,11 @@ class AdHandler extends SingletonFactory
*/
protected $objectTypes = [];
+ /**
+ * filter builder shared by all ad locations
+ */
+ private ?AdObjectFilterBuilder $filterBuilder = null;
+
/**
* Returns the ad output for the given ad location.
*
@@ -57,13 +63,12 @@ public function getAds(string $adLocation)
\shuffle($ads);
}
+ $this->filterBuilder ??= new AdObjectFilterBuilder();
+
$output = '';
foreach ($ads as $ad) {
- $conditions = $ad->getConditions();
- foreach ($conditions as $condition) {
- if (!$condition->getObjectType()->getProcessor()->showContent($condition)) {
- continue 2;
- }
+ if (!$this->filterBuilder->testUser($ad, WCF::getUser())) {
+ continue;
}
$output .= '' . $ad->getHtmlCode() . '
';
diff --git a/wcfsetup/install/files/lib/system/condition/DaysOfWeekCondition.class.php b/wcfsetup/install/files/lib/system/condition/DaysOfWeekCondition.class.php
index 2964e649782..86964ebb2e5 100644
--- a/wcfsetup/install/files/lib/system/condition/DaysOfWeekCondition.class.php
+++ b/wcfsetup/install/files/lib/system/condition/DaysOfWeekCondition.class.php
@@ -12,6 +12,7 @@
* @author Matthias Schmidt
* @copyright 2001-2019 WoltLab GmbH
* @license GNU Lesser General Public License
+ * @deprecated 6.3 Use `wcf\system\object\filter\user\DaysOfWeekObjectFilter` instead.
*/
class DaysOfWeekCondition extends AbstractMultiSelectCondition implements IContentCondition
{
diff --git a/wcfsetup/install/files/lib/system/condition/TimeCondition.class.php b/wcfsetup/install/files/lib/system/condition/TimeCondition.class.php
index e5029cd5d04..636369e8fed 100644
--- a/wcfsetup/install/files/lib/system/condition/TimeCondition.class.php
+++ b/wcfsetup/install/files/lib/system/condition/TimeCondition.class.php
@@ -14,6 +14,7 @@
* @author Matthias Schmidt
* @copyright 2001-2019 WoltLab GmbH
* @license GNU Lesser General Public License
+ * @deprecated 6.3 The time of day is no longer supported as a condition.
*/
class TimeCondition extends AbstractMultipleFieldsCondition implements IContentCondition
{
diff --git a/wcfsetup/install/files/lib/system/condition/UserBirthdayCondition.class.php b/wcfsetup/install/files/lib/system/condition/UserBirthdayCondition.class.php
index 15dc5584e8c..0ecb4e85ce9 100644
--- a/wcfsetup/install/files/lib/system/condition/UserBirthdayCondition.class.php
+++ b/wcfsetup/install/files/lib/system/condition/UserBirthdayCondition.class.php
@@ -12,6 +12,7 @@
* @author Matthias Schmidt
* @copyright 2001-2019 WoltLab GmbH
* @license GNU Lesser General Public License
+ * @deprecated 6.3 Use `wcf\system\object\filter\user\UserBirthdayObjectFilter` instead.
*/
class UserBirthdayCondition extends AbstractCondition implements IContentCondition
{
diff --git a/wcfsetup/install/files/lib/system/condition/UserMobileBrowserCondition.class.php b/wcfsetup/install/files/lib/system/condition/UserMobileBrowserCondition.class.php
index 3dd7ad6deff..acc6ed2772b 100644
--- a/wcfsetup/install/files/lib/system/condition/UserMobileBrowserCondition.class.php
+++ b/wcfsetup/install/files/lib/system/condition/UserMobileBrowserCondition.class.php
@@ -13,6 +13,7 @@
* @author Joshua Ruesweg, Matthias Schmidt
* @copyright 2001-2019 WoltLab GmbH
* @license GNU Lesser General Public License
+ * @deprecated 6.3 Use `wcf\system\object\filter\user\UserMobileBrowserObjectFilter` instead.
*/
class UserMobileBrowserCondition extends AbstractSingleFieldCondition implements IContentCondition
{
diff --git a/wcfsetup/install/files/lib/system/condition/page/MultiPageCondition.class.php b/wcfsetup/install/files/lib/system/condition/page/MultiPageCondition.class.php
index 06c491f2f42..6f4fc1a0aac 100644
--- a/wcfsetup/install/files/lib/system/condition/page/MultiPageCondition.class.php
+++ b/wcfsetup/install/files/lib/system/condition/page/MultiPageCondition.class.php
@@ -18,6 +18,7 @@
* @author Matthias Schmidt
* @copyright 2001-2019 WoltLab GmbH
* @license GNU Lesser General Public License
+ * @deprecated 6.3 Use `wcf\system\object\filter\RequestedPageObjectFilter` or `wcf\system\object\filter\NotRequestedPageObjectFilter` instead.
*/
class MultiPageCondition extends AbstractMultiSelectCondition implements IContentCondition
{
diff --git a/wcfsetup/install/files/lib/system/endpoint/controller/core/ads/DeleteAd.class.php b/wcfsetup/install/files/lib/system/endpoint/controller/core/ads/DeleteAd.class.php
index 0dc81ff9ffb..267ff24509c 100644
--- a/wcfsetup/install/files/lib/system/endpoint/controller/core/ads/DeleteAd.class.php
+++ b/wcfsetup/install/files/lib/system/endpoint/controller/core/ads/DeleteAd.class.php
@@ -5,8 +5,8 @@
use Laminas\Diactoros\Response\JsonResponse;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
+use wcf\command\ad\DeleteAd as DeleteAdCommand;
use wcf\data\ad\Ad;
-use wcf\data\ad\AdAction;
use wcf\http\Helper;
use wcf\system\endpoint\DeleteRequest;
use wcf\system\endpoint\IController;
@@ -31,7 +31,7 @@ public function __invoke(ServerRequestInterface $request, array $variables): Res
$this->assertAdCanBeDeleted();
- (new AdAction([$ad], 'delete'))->executeAction();
+ new DeleteAdCommand($ad)();
return new JsonResponse([]);
}
diff --git a/wcfsetup/install/files/lib/system/endpoint/controller/core/notices/DeleteNotice.class.php b/wcfsetup/install/files/lib/system/endpoint/controller/core/notices/DeleteNotice.class.php
index e5edb1ee862..8e90bf33583 100644
--- a/wcfsetup/install/files/lib/system/endpoint/controller/core/notices/DeleteNotice.class.php
+++ b/wcfsetup/install/files/lib/system/endpoint/controller/core/notices/DeleteNotice.class.php
@@ -6,7 +6,7 @@
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use wcf\data\notice\Notice;
-use wcf\data\notice\NoticeAction;
+use wcf\command\notice\DeleteNotice as DeleteNoticeCommand;
use wcf\http\Helper;
use wcf\system\endpoint\DeleteRequest;
use wcf\system\endpoint\IController;
@@ -30,7 +30,7 @@ public function __invoke(ServerRequestInterface $request, array $variables): Res
$notice = Helper::fetchObjectFromRequestParameter($variables['id'], Notice::class);
- (new NoticeAction([$notice], 'delete'))->executeAction();
+ new DeleteNoticeCommand($notice)();
return new JsonResponse([]);
}
diff --git a/wcfsetup/install/files/lib/system/endpoint/controller/core/users/groups/assignments/DeleteAssignment.class.php b/wcfsetup/install/files/lib/system/endpoint/controller/core/users/groups/assignments/DeleteAssignment.class.php
index 947ea3f6605..a531b52da51 100644
--- a/wcfsetup/install/files/lib/system/endpoint/controller/core/users/groups/assignments/DeleteAssignment.class.php
+++ b/wcfsetup/install/files/lib/system/endpoint/controller/core/users/groups/assignments/DeleteAssignment.class.php
@@ -5,8 +5,8 @@
use Laminas\Diactoros\Response\JsonResponse;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
+use wcf\command\user\group\assignment\DeleteUserGroupAssignment;
use wcf\data\user\group\assignment\UserGroupAssignment;
-use wcf\data\user\group\assignment\UserGroupAssignmentAction;
use wcf\http\Helper;
use wcf\system\endpoint\DeleteRequest;
use wcf\system\endpoint\IController;
@@ -30,7 +30,7 @@ public function __invoke(ServerRequestInterface $request, array $variables): Res
$assignment = Helper::fetchObjectFromRequestParameter($variables['id'], UserGroupAssignment::class);
- (new UserGroupAssignmentAction([$assignment], 'delete'))->executeAction();
+ new DeleteUserGroupAssignment($assignment)();
return new JsonResponse([]);
}
diff --git a/wcfsetup/install/files/lib/system/form/builder/TemplateFormNode.class.php b/wcfsetup/install/files/lib/system/form/builder/TemplateFormNode.class.php
index 9b6a9d66846..343cf454677 100644
--- a/wcfsetup/install/files/lib/system/form/builder/TemplateFormNode.class.php
+++ b/wcfsetup/install/files/lib/system/form/builder/TemplateFormNode.class.php
@@ -77,11 +77,21 @@ public function getApplication()
#[\Override]
public function getHtml()
{
- return WCF::getTPL()->render(
+ $html = WCF::getTPL()->render(
$this->getApplication(),
$this->getTemplateName(),
$this->getVariables(),
);
+
+ if ($this->getDependencies() === []) {
+ return $html;
+ }
+
+ // Wraps the contents to allow the dependencies to toggle them on the client.
+ return WCF::getTPL()->render('wcf', 'shared_templateFormNode', [
+ 'node' => $this,
+ 'html' => $html,
+ ]);
}
/**
diff --git a/wcfsetup/install/files/lib/system/form/builder/field/NumericRangeFormField.class.php b/wcfsetup/install/files/lib/system/form/builder/field/NumericRangeFormField.class.php
index 40d19489974..131389a4ab7 100644
--- a/wcfsetup/install/files/lib/system/form/builder/field/NumericRangeFormField.class.php
+++ b/wcfsetup/install/files/lib/system/form/builder/field/NumericRangeFormField.class.php
@@ -80,7 +80,55 @@ public function validate()
{
if ($this->isRequired() && ($this->getFromValue() === '' || $this->getToValue() === '')) {
$this->addValidationError(new FormFieldValidationError('empty'));
+
+ return;
+ }
+
+ foreach ([$this->getFromValue(), $this->getToValue()] as $value) {
+ if ($value === '') {
+ continue;
+ }
+
+ $error = $this->validateBound($value);
+ if ($error !== null) {
+ $this->addValidationError($error);
+
+ return;
+ }
+ }
+ }
+
+ /**
+ * Returns the validation error for the given lower or upper bound or `null`
+ * if the bound is a valid number within the minimum and maximum.
+ */
+ private function validateBound(string $value): ?FormFieldValidationError
+ {
+ $isValid = $this->integerValues ? \preg_match('~^-?\d+$~', $value) === 1 : \is_numeric($value);
+ if (!$isValid) {
+ return new FormFieldValidationError(
+ 'invalid',
+ 'wcf.form.field.numeric.error.invalid'
+ );
+ }
+
+ if ($this->getMinimum() !== null && $value < $this->getMinimum()) {
+ return new FormFieldValidationError(
+ 'minimum',
+ 'wcf.form.field.numeric.error.minimum',
+ ['minimum' => $this->getMinimum()]
+ );
}
+
+ if ($this->getMaximum() !== null && $value > $this->getMaximum()) {
+ return new FormFieldValidationError(
+ 'maximum',
+ 'wcf.form.field.numeric.error.maximum',
+ ['maximum' => $this->getMaximum()]
+ );
+ }
+
+ return null;
}
#[\Override]
@@ -94,13 +142,25 @@ public function value(mixed $value)
}
$this->value = [
- 'from' => $this->integerValues ? \intval($values[0]) : \floatval($values[0]),
- 'to' => $this->integerValues ? \intval($values[1]) : \floatval($values[1]),
+ 'from' => $this->castValue($values[0]),
+ 'to' => $this->castValue($values[1]),
];
return $this;
}
+ /**
+ * Casts a bound of the range to its numeric type, empty bounds are preserved.
+ */
+ private function castValue(string $value): int|float|string
+ {
+ if ($value === '') {
+ return '';
+ }
+
+ return $this->integerValues ? (int)$value : (float)$value;
+ }
+
public function getFromValue(): string
{
return $this->value['from'] ?? '';
diff --git a/wcfsetup/install/files/lib/system/form/builder/field/ObjectFilterFormField.class.php b/wcfsetup/install/files/lib/system/form/builder/field/ObjectFilterFormField.class.php
new file mode 100644
index 00000000000..fd23364de89
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/form/builder/field/ObjectFilterFormField.class.php
@@ -0,0 +1,190 @@
+
+ * @since 6.3
+ */
+final class ObjectFilterFormField extends AbstractFormField
+{
+ protected $templateName = 'shared_objectFilterFormField';
+
+ /**
+ * @var IObjectFilterBuilder<*>
+ */
+ private IObjectFilterBuilder $builder;
+
+ /**
+ * Sets the builder that provides the available filters.
+ *
+ * @param IObjectFilterBuilder<*> $builder
+ */
+ public function builder(IObjectFilterBuilder $builder): static
+ {
+ $this->builder = $builder;
+
+ return $this;
+ }
+
+ /**
+ * Returns the builder that provides the available filters.
+ *
+ * @return IObjectFilterBuilder<*>
+ * @throws \BadMethodCallException if no builder has been set
+ */
+ public function getBuilder(): IObjectFilterBuilder
+ {
+ if (!isset($this->builder)) {
+ throw new \BadMethodCallException("Builder has not been set for field '{$this->getId()}'.");
+ }
+
+ return $this->builder;
+ }
+
+ #[\Override]
+ public function readValue(): ObjectFilterFormField
+ {
+ if ($this->getDocument()->hasRequestData($this->getPrefixedId())) {
+ $this->value = $this->getDocument()->getRequestData($this->getPrefixedId());
+ }
+
+ return $this;
+ }
+
+ #[\Override]
+ public function validate(): void
+ {
+ try {
+ $values = $this->unserializeFilters($this->getValue());
+ } catch (MappingError) {
+ $this->addValidationError(
+ new FormFieldValidationError('malformedJson')
+ );
+
+ return;
+ }
+
+ if ($this->isRequired() && $values === []) {
+ $this->addValidationError(
+ new FormFieldValidationError('empty')
+ );
+ }
+
+ $filters = [];
+ foreach ($this->getBuilder()->getFilters() as $filter) {
+ $filters[$filter->getIdentifier()] = $filter;
+ }
+
+ $counts = \array_count_values(\array_column($values, 'identifier'));
+ foreach ($counts as $identifier => $count) {
+ $filter = $filters[$identifier];
+ if ($count > 1 && !$filter->isRepeatable()) {
+ $this->addValidationError(
+ new FormFieldValidationError(
+ 'notRepeatable',
+ 'wcf.objectFilter.error.notRepeatable',
+ ['title' => $filter->getTitle()]
+ )
+ );
+ }
+ }
+ }
+
+ /**
+ * Returns the configured filters as JSON for the client-side filter builder.
+ * Each filter consists of its identifier, a human-readable summary and the
+ * serialized value.
+ *
+ * @throws MappingError if the value of this field is malformed
+ */
+ public function toJson(): string
+ {
+ return \json_encode(
+ $this->unserializeFilters($this->getValue()),
+ \JSON_THROW_ON_ERROR,
+ );
+ }
+
+ /**
+ * Returns the URL of the dialog that is used to add a new filter.
+ */
+ public function getEndpoint(): string
+ {
+ return LinkHandler::getInstance()->getControllerLink(
+ ObjectFilterBuilderAction::class,
+ [
+ 'identifier' => $this->getBuilder()->getIdentifier(),
+ ],
+ );
+ }
+
+ /**
+ * Decodes the given value and enriches each filter with a human-readable
+ * summary. Values of unknown filters are ignored.
+ *
+ * @return list
+ * @throws MappingError if the given value is malformed
+ */
+ private function unserializeFilters(?string $json): array
+ {
+ if ($json === null) {
+ return [];
+ }
+
+ /** @var list $values */
+ $values = (new MapperBuilder())->mapper()->map(
+ <<<'EOT'
+ list
+ EOT,
+ Source::json($json)
+ );
+
+ if ($values === []) {
+ return $values;
+ }
+
+ $filters = [];
+ foreach ($this->getBuilder()->getFilters() as $filter) {
+ $filters[$filter->getIdentifier()] = $filter;
+ }
+
+ return \array_map(
+ function (array $value) use ($filters): array {
+ [$identifier, $serializedValue] = $value;
+ $filter = $filters[$identifier];
+
+ return [
+ 'identifier' => $identifier,
+ 'summary' => $filter->summarizeValue(
+ $filter->unserializeValue($serializedValue),
+ ),
+ 'value' => $serializedValue,
+ ];
+ },
+ \array_values(\array_filter(
+ $values,
+ static fn($value) => isset($filters[$value[0]]),
+ )),
+ );
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/gridView/admin/UserGroupAssignmentGridView.class.php b/wcfsetup/install/files/lib/system/gridView/admin/UserGroupAssignmentGridView.class.php
index cd5201f48bd..5b4bca0cbf1 100644
--- a/wcfsetup/install/files/lib/system/gridView/admin/UserGroupAssignmentGridView.class.php
+++ b/wcfsetup/install/files/lib/system/gridView/admin/UserGroupAssignmentGridView.class.php
@@ -47,7 +47,7 @@ public function __construct()
->filter(TextFilter::class)
->sortable(),
GridViewColumn::for("groupID")
- ->label("wcf.acp.group.assignment.userGroup")
+ ->label("wcf.user.group")
->filter(new SelectFilter(
UserGroup::getSortedGroupsByType([], [
UserGroup::EVERYONE,
@@ -56,7 +56,7 @@ public function __construct()
UserGroup::USERS,
]),
'groupID',
- 'wcf.acp.group.assignment.userGroup'
+ 'wcf.user.group'
))
->sortable()
->renderer(
diff --git a/wcfsetup/install/files/lib/system/notice/NoticeHandler.class.php b/wcfsetup/install/files/lib/system/notice/NoticeHandler.class.php
index cf80798b72c..020707f1093 100644
--- a/wcfsetup/install/files/lib/system/notice/NoticeHandler.class.php
+++ b/wcfsetup/install/files/lib/system/notice/NoticeHandler.class.php
@@ -4,7 +4,9 @@
use wcf\data\notice\Notice;
use wcf\system\cache\builder\NoticeCacheBuilder;
+use wcf\system\object\filter\builder\NoticeObjectFilterBuilder;
use wcf\system\SingletonFactory;
+use wcf\system\WCF;
/**
* Handles notice-related matters.
@@ -44,17 +46,16 @@ public function getVisibleNotices()
return [];
}
+ $filterBuilder = new NoticeObjectFilterBuilder();
+
$notices = [];
foreach ($this->notices as $notice) {
if ($notice->isDismissed()) {
continue;
}
- $conditions = $notice->getConditions();
- foreach ($conditions as $condition) {
- if (!$condition->getObjectType()->getProcessor()->showContent($condition)) {
- continue 2;
- }
+ if (!$filterBuilder->testUser($notice, WCF::getUser())) {
+ continue;
}
$notices[$notice->noticeID] = $notice;
diff --git a/wcfsetup/install/files/lib/system/object/filter/AbstractBooleanObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/AbstractBooleanObjectFilter.class.php
new file mode 100644
index 00000000000..96a67f1f284
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/AbstractBooleanObjectFilter.class.php
@@ -0,0 +1,84 @@
+.summary.yes` and `.summary.no`.
+ *
+ * @author Marcel Werk
+ * @copyright 2001-2026 WoltLab GmbH
+ * @license GNU Lesser General Public License
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @implements IObjectFilter
+ */
+abstract class AbstractBooleanObjectFilter implements IObjectFilter
+{
+ /**
+ * Returns the language item of the title of this filter.
+ */
+ abstract protected function getLanguageItem(): string;
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function getFormField(): BooleanFormField
+ {
+ return BooleanFormField::create(\str_replace('.', '_', $this->getIdentifier()))
+ ->label($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return false;
+ }
+
+ /**
+ * @param bool|int $value
+ */
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return $value ? '1' : '0';
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): bool
+ {
+ return (bool)$serializedValue;
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): bool
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->get(
+ $this->getLanguageItem() . ($value ? '.summary.yes' : '.summary.no')
+ );
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/AbstractMultipleSelectionObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/AbstractMultipleSelectionObjectFilter.class.php
new file mode 100644
index 00000000000..6716e4381f3
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/AbstractMultipleSelectionObjectFilter.class.php
@@ -0,0 +1,92 @@
+.summary` that receives
+ * the comma-separated labels of the selected objects as `$values`.
+ *
+ * @author Marcel Werk
+ * @copyright 2001-2026 WoltLab GmbH
+ * @license GNU Lesser General Public License
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @implements IObjectFilter>
+ */
+abstract class AbstractMultipleSelectionObjectFilter implements IObjectFilter
+{
+ /**
+ * Returns the language item of the title of this filter.
+ */
+ abstract protected function getLanguageItem(): string;
+
+ /**
+ * Returns the labels of the objects with the given ids, ids of unknown
+ * objects are skipped.
+ *
+ * @param list $objectIDs
+ * @return list
+ */
+ abstract protected function getLabels(array $objectIDs): array;
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ /**
+ * Multiple values are selected in a single filter instead.
+ */
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return false;
+ }
+
+ /**
+ * @param list $value
+ */
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return \implode(',', \array_map(static fn($objectID) => (int)$objectID, $value));
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): array
+ {
+ return \array_map(static fn($objectID) => (int)$objectID, \explode(',', $serializedValue));
+ }
+
+ /**
+ * @return list
+ */
+ #[\Override]
+ public function toFormFieldValue(mixed $value): array
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->getDynamicVariable($this->getLanguageItem() . '.summary', [
+ 'values' => \implode(', ', $this->getLabels($value)),
+ ]);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/AbstractRangeObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/AbstractRangeObjectFilter.class.php
new file mode 100644
index 00000000000..34466f1588d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/AbstractRangeObjectFilter.class.php
@@ -0,0 +1,134 @@
+.summary` that receives
+ * the bounds as `$from` and `$to`, missing bounds are `null`.
+ *
+ * @author Marcel Werk
+ * @copyright 2001-2026 WoltLab GmbH
+ * @license GNU Lesser General Public License
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @template TBound of int|string
+ * @implements IObjectFilter
+ */
+abstract class AbstractRangeObjectFilter implements IObjectFilter
+{
+ /**
+ * Returns the language item of the title of this filter.
+ */
+ abstract protected function getLanguageItem(): string;
+
+ /**
+ * Creates the form field to enter the range, the validation of the bounds
+ * is added by `getFormField()`.
+ */
+ abstract protected function createFormField(): DateRangeFormField|NumericRangeFormField;
+
+ /**
+ * Converts a non-empty bound into its native type.
+ *
+ * @return TBound
+ */
+ abstract protected function unserializeBound(string $bound): int|string;
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function getFormField(): DateRangeFormField|NumericRangeFormField
+ {
+ return $this->createFormField()
+ ->addValidator(new FormFieldValidator(
+ 'range',
+ static function (IFormField $field) {
+ \assert($field instanceof DateRangeFormField || $field instanceof NumericRangeFormField);
+ $from = $field->getFromValue();
+ $to = $field->getToValue();
+
+ if ($from === '' && $to === '') {
+ $field->addValidationError(
+ new FormFieldValidationError('empty')
+ );
+ } elseif ($from !== '' && $to !== '' && $from > $to) {
+ $field->addValidationError(
+ new FormFieldValidationError(
+ 'endBeforeStart',
+ 'wcf.objectFilter.range.error.endBeforeStart'
+ )
+ );
+ }
+ }
+ ));
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return false;
+ }
+
+ /**
+ * @param string|array{0: ?TBound, 1: ?TBound} $value
+ */
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ [$from, $to] = \is_string($value) ? $this->unserializeValue($value) : $value;
+
+ return $from . ';' . $to;
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): array
+ {
+ [$from, $to] = \explode(';', $serializedValue, 2) + [1 => ''];
+
+ return [
+ $from === '' ? null : $this->unserializeBound($from),
+ $to === '' ? null : $this->unserializeBound($to),
+ ];
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): string
+ {
+ return $this->serializeValue($value);
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ [$from, $to] = $value;
+
+ return WCF::getLanguage()->getDynamicVariable($this->getLanguageItem() . '.summary', [
+ 'from' => $from,
+ 'to' => $to,
+ ]);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/AbstractSelectionObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/AbstractSelectionObjectFilter.class.php
new file mode 100644
index 00000000000..5bb65ffa938
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/AbstractSelectionObjectFilter.class.php
@@ -0,0 +1,121 @@
+.summary` that receives the label of the selected object as
+ * `$value`.
+ *
+ * @author Marcel Werk
+ * @copyright 2001-2026 WoltLab GmbH
+ * @license GNU Lesser General Public License
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @implements IObjectFilter
+ */
+abstract class AbstractSelectionObjectFilter implements IObjectFilter
+{
+ /**
+ * @var array
+ */
+ private array $options;
+
+ /**
+ * Returns the language item of the title of this filter.
+ */
+ abstract protected function getLanguageItem(): string;
+
+ /**
+ * Returns the labels of the selectable objects, indexed by their id and
+ * sorted in the order they are offered.
+ *
+ * @return array
+ */
+ abstract protected function createOptions(): array;
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function getFormField(): SelectFormField
+ {
+ return SelectFormField::create(\str_replace('.', '_', $this->getIdentifier()))
+ ->label($this->getLanguageItem())
+ ->options($this->getOptions(), labelLanguageItems: false)
+ ->required();
+ }
+
+ /**
+ * Returns false if there are no objects to choose from.
+ */
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return $this->getOptions() !== [];
+ }
+
+ /**
+ * Selecting multiple objects requires the filter to be repeated.
+ */
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return true;
+ }
+
+ /**
+ * @param int|string $value
+ */
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return (string)$value;
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): int
+ {
+ return (int)$serializedValue;
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): int
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->getDynamicVariable($this->getLanguageItem() . '.summary', [
+ 'value' => $this->getOptions()[$value] ?? $value,
+ ]);
+ }
+
+ /**
+ * Returns the labels of the selectable objects, indexed by their id.
+ *
+ * @return array
+ */
+ protected function getOptions(): array
+ {
+ if (!isset($this->options)) {
+ $this->options = $this->createOptions();
+ }
+
+ return $this->options;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/AbstractTimestampObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/AbstractTimestampObjectFilter.class.php
new file mode 100644
index 00000000000..7d9c872972c
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/AbstractTimestampObjectFilter.class.php
@@ -0,0 +1,87 @@
+.summary` that receives the timestamp as `$value`.
+ *
+ * @author Marcel Werk
+ * @copyright 2001-2026 WoltLab GmbH
+ * @license GNU Lesser General Public License
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @implements IObjectFilter
+ */
+abstract class AbstractTimestampObjectFilter implements IObjectFilter
+{
+ /**
+ * Returns the language item of the title of this filter.
+ */
+ abstract protected function getLanguageItem(): string;
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get($this->getLanguageItem());
+ }
+
+ #[\Override]
+ public function getFormField(): DateFormField
+ {
+ return DateFormField::create(\str_replace('.', '_', $this->getIdentifier()))
+ ->label($this->getLanguageItem())
+ ->supportTime()
+ ->required();
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return false;
+ }
+
+ /**
+ * @param int|string $value
+ */
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return (string)(int)$value;
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): int
+ {
+ return (int)$serializedValue;
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): string
+ {
+ return (string)$value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->getDynamicVariable($this->getLanguageItem() . '.summary', [
+ 'value' => $value,
+ ]);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/EndDateObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/EndDateObjectFilter.class.php
new file mode 100644
index 00000000000..60d959ab9a2
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/EndDateObjectFilter.class.php
@@ -0,0 +1,36 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractTimestampObjectFilter
+ */
+final class EndDateObjectFilter extends AbstractTimestampObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.endDate';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.endDate';
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return \TIME_NOW < $configuredValue;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/IObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/IObjectFilter.class.php
new file mode 100644
index 00000000000..7207489b965
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/IObjectFilter.class.php
@@ -0,0 +1,95 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @phpstan-template-contravariant TDatabaseObject of DatabaseObject
+ * @template TValueType of mixed
+ */
+interface IObjectFilter
+{
+ /**
+ * Returns the unique identifier of this filter, e.g. `com.woltlab.wcf.username`.
+ */
+ public function getIdentifier(): string;
+
+ /**
+ * Returns the title of this filter that is shown when selecting a filter.
+ */
+ public function getTitle(): string;
+
+ /**
+ * Returns the form field that the user interacts with when entering a value.
+ */
+ public function getFormField(): AbstractFormField;
+
+ /**
+ * Returns true if this filter can be selected when configuring a filter,
+ * e.g. false if there are no objects to choose from. Stored values of an
+ * unavailable filter are still evaluated.
+ */
+ public function isAvailable(): bool;
+
+ /**
+ * Returns true if this filter can be configured more than once for the
+ * same object. Filters whose repeated use is redundant or contradictory,
+ * e.g. a yes/no choice, return false.
+ */
+ public function isRepeatable(): bool;
+
+ /**
+ * Converts the given value into its string representation for storage.
+ *
+ * When a filter is configured, the given value is the value of the form
+ * field returned by `getFormField()`, which may differ from `TValueType`.
+ *
+ * @param TValueType $value
+ */
+ public function serializeValue(mixed $value): string;
+
+ /**
+ * Restores the value from its string representation created by `serializeValue()`.
+ *
+ * @return TValueType
+ */
+ public function unserializeValue(string $serializedValue): mixed;
+
+ /**
+ * Converts the given value into the value of the form field returned by
+ * `getFormField()`, used to prefill the form field when editing the filter.
+ *
+ * @param TValueType $value
+ */
+ public function toFormFieldValue(mixed $value): mixed;
+
+ /**
+ * Returns a human-readable summary of the configured value,
+ * e.g. "In user group %s".
+ *
+ * @param TValueType $value
+ */
+ public function summarizeValue(mixed $value): string;
+
+ /**
+ * Returns whether the given object matches the configured value.
+ *
+ * @param TDatabaseObject $object
+ * @param TValueType $configuredValue
+ */
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool;
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/IObjectListFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/IObjectListFilter.class.php
new file mode 100644
index 00000000000..db2c81fdea6
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/IObjectListFilter.class.php
@@ -0,0 +1,30 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @template TValueType of mixed
+ * @extends IObjectFilter
+ */
+interface IObjectListFilter extends IObjectFilter
+{
+ /**
+ * Adds the SQL condition that matches the objects satisfying the given
+ * value to the conditions of an object list.
+ *
+ * @param TValueType $value
+ */
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void;
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/NotRequestedPageObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/NotRequestedPageObjectFilter.class.php
new file mode 100644
index 00000000000..d24e0a39fb1
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/NotRequestedPageObjectFilter.class.php
@@ -0,0 +1,58 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractMultipleSelectionObjectFilter
+ */
+final class NotRequestedPageObjectFilter extends AbstractMultipleSelectionObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.notRequestedPage';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.notRequestedPage';
+ }
+
+ #[\Override]
+ protected function getLabels(array $objectIDs): array
+ {
+ return RequestedPageObjectFilter::getPageTitles($objectIDs);
+ }
+
+ #[\Override]
+ public function getFormField(): PagesFormField
+ {
+ return PagesFormField::create('notRequestedPage')
+ ->label('wcf.page.requestedPage')
+ ->required();
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ $pageID = RequestHandler::getInstance()->getActivePageID();
+ if ($pageID === null) {
+ return false;
+ }
+
+ return !\in_array($pageID, $configuredValue, true);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/ObjectFilterHandler.class.php b/wcfsetup/install/files/lib/system/object/filter/ObjectFilterHandler.class.php
new file mode 100644
index 00000000000..cfcecd02f3d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/ObjectFilterHandler.class.php
@@ -0,0 +1,107 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ */
+class ObjectFilterHandler
+{
+ /**
+ * @param list> $filters
+ */
+ public function __construct(
+ private readonly array $filters,
+ ) {}
+
+ /**
+ * Returns whether the given object satisfies all stored filter values.
+ * Values of unknown filters are ignored.
+ *
+ * Returns false if there are no active filters.
+ *
+ * @param TDatabaseObject $object
+ * @throws MappingError if the stored filter values are malformed
+ */
+ public function testObject(DatabaseObject $object, ?string $json): bool
+ {
+ $values = $this->unserializeValues($json);
+ if ($values === []) {
+ return false;
+ }
+
+ $filters = $this->getFiltersByIdentifier();
+
+ $hasActiveFilters = false;
+ foreach ($values as [$identifier, $serializedValue]) {
+ $filter = $filters[$identifier] ?? null;
+ if ($filter === null) {
+ continue;
+ }
+
+ $hasActiveFilters = true;
+ if (!$filter->testObject($object, $filter->unserializeValue($serializedValue))) {
+ return false;
+ }
+ }
+
+ // Returns true if there are active filters because any negative test
+ // would have returned early.
+ return $hasActiveFilters;
+ }
+
+ /**
+ * Returns the available filters indexed by their identifier.
+ *
+ * @return array>
+ */
+ protected function getFiltersByIdentifier(): array
+ {
+ $filters = [];
+ foreach ($this->filters as $filter) {
+ $filters[$filter->getIdentifier()] = $filter;
+ }
+
+ return $filters;
+ }
+
+ /**
+ * Decodes the stored filter values into a list of
+ * `[filterIdentifier, serializedValue]` pairs.
+ *
+ * @return list
+ * @throws MappingError if the stored filter values are malformed
+ */
+ protected function unserializeValues(?string $json): array
+ {
+ if ($json === null) {
+ return [];
+ }
+
+ /** @var list $values */
+ $values = (new MapperBuilder())->mapper()->map(
+ <<<'EOT'
+ list
+ EOT,
+ Source::json($json)
+ );
+
+ return $values;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/ObjectListFilterHandler.class.php b/wcfsetup/install/files/lib/system/object/filter/ObjectListFilterHandler.class.php
new file mode 100644
index 00000000000..11bc4d04067
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/ObjectListFilterHandler.class.php
@@ -0,0 +1,72 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @extends ObjectFilterHandler
+ */
+final class ObjectListFilterHandler extends ObjectFilterHandler
+{
+ /**
+ * @param list> $filters
+ */
+ public function __construct(
+ array $filters,
+ ) {
+ parent::__construct($filters);
+ }
+
+ /**
+ * Adds the SQL conditions of all stored filter values to the given
+ * conditions of an object list. Values of unknown filters are ignored.
+ *
+ * Adds a condition that matches no objects if there are no active filters.
+ *
+ * @throws MappingError if the stored filter values are malformed
+ */
+ public function applyFilters(PreparedStatementConditionBuilder $conditions, ?string $json): void
+ {
+ $values = $this->unserializeValues($json);
+ if ($values === []) {
+ $conditions->add('1=0');
+
+ return;
+ }
+
+ $filters = $this->getFiltersByIdentifier();
+
+ $hasActiveFilters = false;
+ foreach ($values as [$identifier, $serializedValue]) {
+ $filter = $filters[$identifier] ?? null;
+ if ($filter === null) {
+ continue;
+ }
+
+ \assert($filter instanceof IObjectListFilter);
+
+ $filter->applyFilter(
+ $conditions,
+ $filter->unserializeValue($serializedValue),
+ );
+ $hasActiveFilters = true;
+ }
+
+ if (!$hasActiveFilters) {
+ $conditions->add('1=0');
+ }
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/RequestedPageObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/RequestedPageObjectFilter.class.php
new file mode 100644
index 00000000000..bf8b495005d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/RequestedPageObjectFilter.class.php
@@ -0,0 +1,79 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractMultipleSelectionObjectFilter
+ */
+final class RequestedPageObjectFilter extends AbstractMultipleSelectionObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.requestedPage';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.requestedPage';
+ }
+
+ #[\Override]
+ protected function getLabels(array $objectIDs): array
+ {
+ return RequestedPageObjectFilter::getPageTitles($objectIDs);
+ }
+
+ #[\Override]
+ public function getFormField(): PagesFormField
+ {
+ return PagesFormField::create('requestedPage')
+ ->label('wcf.page.requestedPage')
+ ->required();
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ $pageID = RequestHandler::getInstance()->getActivePageID();
+ if ($pageID === null) {
+ return false;
+ }
+
+ return \in_array($pageID, $configuredValue, true);
+ }
+
+ /**
+ * Returns the titles of the pages with the given ids, unknown pages are skipped.
+ *
+ * @param list $pageIDs
+ * @return list
+ * @internal
+ */
+ public static function getPageTitles(array $pageIDs): array
+ {
+ $titles = [];
+ foreach ($pageIDs as $pageID) {
+ $page = PageCache::getInstance()->getPage($pageID);
+ if ($page !== null) {
+ $titles[] = $page->getTitle();
+ }
+ }
+
+ return $titles;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/StartDateObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/StartDateObjectFilter.class.php
new file mode 100644
index 00000000000..8a7e0e8237f
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/StartDateObjectFilter.class.php
@@ -0,0 +1,36 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractTimestampObjectFilter
+ */
+final class StartDateObjectFilter extends AbstractTimestampObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.startDate';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.startDate';
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return \TIME_NOW >= $configuredValue;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/builder/AbstractObjectFilterBuilder.class.php b/wcfsetup/install/files/lib/system/object/filter/builder/AbstractObjectFilterBuilder.class.php
new file mode 100644
index 00000000000..f20e5b4289e
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/builder/AbstractObjectFilterBuilder.class.php
@@ -0,0 +1,79 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ * @template TFilter of IObjectFilter
+ * @template THandler of ObjectFilterHandler
+ * @implements IObjectFilterBuilder
+ */
+abstract class AbstractObjectFilterBuilder implements IObjectFilterBuilder
+{
+ /**
+ * @var list
+ */
+ private array $filters;
+
+ /**
+ * @var THandler
+ */
+ private ObjectFilterHandler $handler;
+
+ /**
+ * Creates the filters that are available for this builder. This method is
+ * called at most once, the result is cached by `getFilters()`.
+ *
+ * @return list
+ */
+ abstract protected function createFilters(): array;
+
+ /**
+ * Creates the handler that evaluates the stored filter values using the
+ * given filters. This method is called at most once, the result is cached
+ * by `getHandler()`.
+ *
+ * @param list $filters
+ * @return THandler
+ */
+ abstract protected function createHandler(array $filters): ObjectFilterHandler;
+
+ /**
+ * @return list
+ */
+ #[\Override]
+ public function getFilters(): array
+ {
+ if (!isset($this->filters)) {
+ $this->filters = $this->createFilters();
+ }
+
+ return $this->filters;
+ }
+
+ /**
+ * Returns the handler that evaluates the stored filter values.
+ *
+ * @return THandler
+ */
+ protected function getHandler(): ObjectFilterHandler
+ {
+ if (!isset($this->handler)) {
+ $this->handler = $this->createHandler($this->getFilters());
+ }
+
+ return $this->handler;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/builder/AdObjectFilterBuilder.class.php b/wcfsetup/install/files/lib/system/object/filter/builder/AdObjectFilterBuilder.class.php
new file mode 100644
index 00000000000..5440e48262d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/builder/AdObjectFilterBuilder.class.php
@@ -0,0 +1,117 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractObjectFilterBuilder, ObjectFilterHandler>
+ */
+final class AdObjectFilterBuilder extends AbstractObjectFilterBuilder
+{
+ #[\Override]
+ protected function createFilters(): array
+ {
+ $event = new AdObjectFilterCollecting();
+ $event->register(new RequestedPageObjectFilter());
+ $event->register(new NotRequestedPageObjectFilter());
+ $event->register(new DaysOfWeekObjectFilter());
+ $event->register(new StartDateObjectFilter());
+ $event->register(new EndDateObjectFilter());
+ $event->register(new UserUsernameObjectFilter());
+ $event->register(new UserEmailObjectFilter());
+ $event->register(new UserGroupObjectFilter(includeGuests: true));
+ $event->register(new UserNotInGroupObjectFilter(includeGuests: true));
+ $event->register(new UserLanguageObjectFilter());
+ $event->register(new UserRegistrationDateObjectFilter());
+ $event->register(new UserRegistrationDaysObjectFilter());
+ $event->register(new UserAvatarObjectFilter());
+ $event->register(new UserSignatureObjectFilter());
+ $event->register(new UserCoverPhotoObjectFilter());
+ $event->register(new UserBannedObjectFilter());
+ $event->register(new UserActivatedObjectFilter());
+ $event->register(new UserEmailConfirmedObjectFilter());
+ $event->register(new UserMultifactorObjectFilter());
+ $event->register(new UserBirthdayObjectFilter());
+ $event->register(new UserMobileBrowserObjectFilter());
+ $event->register(new UserIntegerPropertyObjectFilter('activityPoints', 'wcf.user.condition.activityPoints'));
+ $event->register(new UserIntegerPropertyObjectFilter('likesReceived', 'wcf.user.condition.likesReceived'));
+ $event->register(new UserIntegerPropertyObjectFilter('trophyPoints', 'wcf.user.condition.trophyPoints'));
+ $event->register(new UserTrophyObjectFilter());
+ $event->register(new UserNoTrophyObjectFilter());
+
+ EventHandler::getInstance()->fire($event);
+
+ return $event->getFilters();
+ }
+
+ #[\Override]
+ protected function createHandler(array $filters): ObjectFilterHandler
+ {
+ return new ObjectFilterHandler($filters);
+ }
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.ad';
+ }
+
+ #[\Override]
+ public function isAccessible(): bool
+ {
+ return WCF::getSession()->hasPermission('admin.ad.canManageAd');
+ }
+
+ /**
+ * Returns whether the given user matches the filters of the ad.
+ *
+ * An ad without any filters is visible to everyone.
+ */
+ public function testUser(Ad $ad, User $user): bool
+ {
+ if ($ad->conditions === null) {
+ return true;
+ }
+
+ return $this->getHandler()->testObject($user, $ad->conditions);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/builder/IObjectFilterBuilder.class.php b/wcfsetup/install/files/lib/system/object/filter/builder/IObjectFilterBuilder.class.php
new file mode 100644
index 00000000000..5647d89c18d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/builder/IObjectFilterBuilder.class.php
@@ -0,0 +1,40 @@
+
+ * @since 6.3
+ *
+ * @template TDatabaseObject of DatabaseObject
+ */
+interface IObjectFilterBuilder
+{
+ /**
+ * Returns the filters that are available for this builder.
+ *
+ * @return list>
+ */
+ public function getFilters(): array;
+
+ /**
+ * Returns the unique identifier of this builder, e.g. `com.woltlab.wcf.userGroupAssignment`.
+ */
+ public function getIdentifier(): string;
+
+ /**
+ * Returns true if this builder is accessible for the active user.
+ */
+ public function isAccessible(): bool;
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/builder/NoticeObjectFilterBuilder.class.php b/wcfsetup/install/files/lib/system/object/filter/builder/NoticeObjectFilterBuilder.class.php
new file mode 100644
index 00000000000..2f807f3c441
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/builder/NoticeObjectFilterBuilder.class.php
@@ -0,0 +1,117 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractObjectFilterBuilder, ObjectFilterHandler>
+ */
+final class NoticeObjectFilterBuilder extends AbstractObjectFilterBuilder
+{
+ #[\Override]
+ protected function createFilters(): array
+ {
+ $event = new NoticeObjectFilterCollecting();
+ $event->register(new RequestedPageObjectFilter());
+ $event->register(new NotRequestedPageObjectFilter());
+ $event->register(new DaysOfWeekObjectFilter());
+ $event->register(new StartDateObjectFilter());
+ $event->register(new EndDateObjectFilter());
+ $event->register(new UserUsernameObjectFilter());
+ $event->register(new UserEmailObjectFilter());
+ $event->register(new UserGroupObjectFilter(includeGuests: true));
+ $event->register(new UserNotInGroupObjectFilter(includeGuests: true));
+ $event->register(new UserLanguageObjectFilter());
+ $event->register(new UserRegistrationDateObjectFilter());
+ $event->register(new UserRegistrationDaysObjectFilter());
+ $event->register(new UserAvatarObjectFilter());
+ $event->register(new UserSignatureObjectFilter());
+ $event->register(new UserCoverPhotoObjectFilter());
+ $event->register(new UserBannedObjectFilter());
+ $event->register(new UserActivatedObjectFilter());
+ $event->register(new UserEmailConfirmedObjectFilter());
+ $event->register(new UserMultifactorObjectFilter());
+ $event->register(new UserBirthdayObjectFilter());
+ $event->register(new UserMobileBrowserObjectFilter());
+ $event->register(new UserIntegerPropertyObjectFilter('activityPoints', 'wcf.user.condition.activityPoints'));
+ $event->register(new UserIntegerPropertyObjectFilter('likesReceived', 'wcf.user.condition.likesReceived'));
+ $event->register(new UserIntegerPropertyObjectFilter('trophyPoints', 'wcf.user.condition.trophyPoints'));
+ $event->register(new UserTrophyObjectFilter());
+ $event->register(new UserNoTrophyObjectFilter());
+
+ EventHandler::getInstance()->fire($event);
+
+ return $event->getFilters();
+ }
+
+ #[\Override]
+ protected function createHandler(array $filters): ObjectFilterHandler
+ {
+ return new ObjectFilterHandler($filters);
+ }
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.notice';
+ }
+
+ #[\Override]
+ public function isAccessible(): bool
+ {
+ return WCF::getSession()->hasPermission('admin.notice.canManageNotice');
+ }
+
+ /**
+ * Returns whether the given user matches the filters of the notice.
+ *
+ * A notice without any filters is visible to everyone.
+ */
+ public function testUser(Notice $notice, User $user): bool
+ {
+ if ($notice->conditions === null) {
+ return true;
+ }
+
+ return $this->getHandler()->testObject($user, $notice->conditions);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/builder/UserGroupAssignmentObjectFilterBuilder.class.php b/wcfsetup/install/files/lib/system/object/filter/builder/UserGroupAssignmentObjectFilterBuilder.class.php
new file mode 100644
index 00000000000..c8a22c6ac8c
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/builder/UserGroupAssignmentObjectFilterBuilder.class.php
@@ -0,0 +1,117 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractObjectFilterBuilder, ObjectListFilterHandler>
+ */
+final class UserGroupAssignmentObjectFilterBuilder extends AbstractObjectFilterBuilder
+{
+ #[\Override]
+ protected function createFilters(): array
+ {
+ $event = new UserGroupAssignmentObjectFilterCollecting();
+ $event->register(new UserUsernameObjectFilter());
+ $event->register(new UserEmailObjectFilter());
+ $event->register(new UserGroupObjectFilter());
+ $event->register(new UserNotInGroupObjectFilter());
+ $event->register(new UserLanguageObjectFilter());
+ $event->register(new UserRegistrationDateObjectFilter());
+ $event->register(new UserRegistrationDaysObjectFilter());
+ $event->register(new UserAvatarObjectFilter());
+ $event->register(new UserSignatureObjectFilter());
+ $event->register(new UserCoverPhotoObjectFilter());
+ $event->register(new UserBannedObjectFilter());
+ $event->register(new UserActivatedObjectFilter());
+ $event->register(new UserEmailConfirmedObjectFilter());
+ $event->register(new UserIntegerPropertyObjectFilter('activityPoints', 'wcf.user.condition.activityPoints'));
+ $event->register(new UserIntegerPropertyObjectFilter('likesReceived', 'wcf.user.condition.likesReceived'));
+ $event->register(new UserIntegerPropertyObjectFilter('trophyPoints', 'wcf.user.condition.trophyPoints'));
+ $event->register(new UserTrophyObjectFilter());
+ $event->register(new UserNoTrophyObjectFilter());
+
+ EventHandler::getInstance()->fire($event);
+
+ return $event->getFilters();
+ }
+
+ #[\Override]
+ protected function createHandler(array $filters): ObjectFilterHandler
+ {
+ return new ObjectListFilterHandler($filters);
+ }
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userGroupAssignment';
+ }
+
+ #[\Override]
+ public function isAccessible(): bool
+ {
+ return WCF::getSession()->hasPermission('admin.user.canManageGroupAssignment');
+ }
+
+ /**
+ * Adds the filters of the assignment to the given conditions of a user list.
+ *
+ * An assignment without any active filters matches no users.
+ */
+ public function applyFilters(UserGroupAssignment $assignment, PreparedStatementConditionBuilder $conditions): void
+ {
+ $this->getHandler()->applyFilters(
+ $conditions,
+ $assignment->conditions,
+ );
+ }
+
+ /**
+ * Returns whether the given user matches the filters of the assignment.
+ *
+ * An assignment without any active filters matches no users.
+ */
+ public function testUser(UserGroupAssignment $assignment, User $user): bool
+ {
+ return $this->getHandler()->testObject(
+ $user,
+ $assignment->conditions,
+ );
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/migration/LegacyConditionMigration.class.php b/wcfsetup/install/files/lib/system/object/filter/migration/LegacyConditionMigration.class.php
new file mode 100644
index 00000000000..eb3e3d55e1a
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/migration/LegacyConditionMigration.class.php
@@ -0,0 +1,316 @@
+
+ * @since 6.3
+ * @deprecated 6.3 Only intended for the update to 6.3, will be removed with the next major version.
+ */
+final class LegacyConditionMigration
+{
+ /**
+ * @param string $definitionName name of the object type definition of the conditions, e.g. `com.woltlab.wcf.condition.notice`
+ * @param string $tableName name of the table of the objects, must have the columns `conditions` and `isDisabled`
+ * @param string $idColumn name of the id column of the table
+ */
+ public function __construct(
+ private readonly string $definitionName,
+ private readonly string $tableName,
+ private readonly string $idColumn,
+ ) {}
+
+ /**
+ * Migrates the conditions using the given converters, indexed by the class
+ * name of the condition object type.
+ *
+ * A converter receives the unserialized condition data and the object type
+ * and returns the list of `[filterIdentifier, serializedValue]` pairs that
+ * replace the condition, or `null` if the condition cannot be converted.
+ *
+ * @param array, ObjectType): ?list> $converters
+ */
+ public function migrate(array $converters): void
+ {
+ $objectTypes = $this->getObjectTypes();
+ if ($objectTypes === []) {
+ return;
+ }
+
+ $disabledObjectIDs = $this->getDisabledObjectIDs();
+
+ foreach ($this->getConditionsByObject(\array_keys($objectTypes)) as $objectID => $object) {
+ ['isDisabled' => $isDisabled, 'conditions' => $conditions] = $object;
+
+ $filters = [];
+ $convertedConditionIDs = [];
+ $hasUnconvertedConditions = false;
+
+ foreach ($conditions as $condition) {
+ $objectType = $objectTypes[$condition['objectTypeID']];
+ $converter = $converters[$objectType->className] ?? null;
+
+ $result = null;
+ $conditionData = @\unserialize($condition['conditionData']);
+ if ($converter !== null && \is_array($conditionData)) {
+ try {
+ $result = $converter($conditionData, $objectType);
+ } catch (\Throwable) {
+ // Malformed legacy data must not break the update,
+ // the condition is treated as not convertible.
+ $result = null;
+ }
+ }
+
+ if ($result === null) {
+ $hasUnconvertedConditions = true;
+ } else {
+ \array_push($filters, ...$result);
+ $convertedConditionIDs[] = $condition['conditionID'];
+ }
+ }
+
+ $newIsDisabled = null;
+ if ($hasUnconvertedConditions) {
+ if (!$isDisabled) {
+ $newIsDisabled = true;
+ }
+ } elseif (\in_array($objectID, $disabledObjectIDs, true)) {
+ // All remaining conditions have been converted by this run.
+ $newIsDisabled = false;
+ }
+
+ $this->updateObject($objectID, $filters, $convertedConditionIDs, $newIsDisabled);
+
+ // Remembered after each object to keep the list in sync with the
+ // committed changes if a later object fails.
+ if ($newIsDisabled === true) {
+ $disabledObjectIDs[] = $objectID;
+ $this->setDisabledObjectIDs($disabledObjectIDs);
+ } elseif ($newIsDisabled === false) {
+ $disabledObjectIDs = \array_values(\array_diff($disabledObjectIDs, [$objectID]));
+ $this->setDisabledObjectIDs($disabledObjectIDs);
+ }
+ }
+ }
+
+ /**
+ * Returns a converter for conditions of `UserIntegerPropertyCondition`
+ * that handles the given properties. Conditions of other properties are
+ * left for the packages that provide them.
+ *
+ * The matching filter is `UserIntegerPropertyObjectFilter`, its bounds are
+ * inclusive while the legacy bounds are exclusive.
+ *
+ * @param list $propertyNames
+ * @return \Closure(array, ObjectType): ?list
+ */
+ public static function getUserIntegerPropertyConverter(array $propertyNames): \Closure
+ {
+ return static function (array $data, ObjectType $objectType) use ($propertyNames): ?array {
+ $propertyName = $objectType->propertyname;
+ if (!\in_array($propertyName, $propertyNames, true)) {
+ return null;
+ }
+
+ $from = isset($data['greaterThan']) ? (string)((int)$data['greaterThan'] + 1) : '';
+ $to = isset($data['lessThan']) ? (string)((int)$data['lessThan'] - 1) : '';
+ if ($from === '' && $to === '') {
+ return null;
+ }
+
+ return [['com.woltlab.wcf.user' . \ucfirst($propertyName), $from . ';' . $to]];
+ };
+ }
+
+ /**
+ * Returns the ids of the objects that have been disabled by the migration.
+ *
+ * @return list
+ */
+ private function getDisabledObjectIDs(): array
+ {
+ $value = RegistryHandler::getInstance()->get('com.woltlab.wcf', $this->getRegistryField());
+ if ($value === null) {
+ return [];
+ }
+
+ $objectIDs = \json_decode($value, true);
+ if (!\is_array($objectIDs)) {
+ return [];
+ }
+
+ return \array_values(\array_map(static fn($objectID) => (int)$objectID, $objectIDs));
+ }
+
+ /**
+ * Stores the ids of the objects that have been disabled by the migration.
+ *
+ * @param list $objectIDs
+ */
+ private function setDisabledObjectIDs(array $objectIDs): void
+ {
+ RegistryHandler::getInstance()->set(
+ 'com.woltlab.wcf',
+ $this->getRegistryField(),
+ \json_encode(\array_values(\array_unique($objectIDs)), \JSON_THROW_ON_ERROR)
+ );
+ }
+
+ private function getRegistryField(): string
+ {
+ return 'legacyConditionMigration.' . $this->definitionName;
+ }
+
+ /**
+ * Returns the condition object types of the definition, indexed by their id.
+ *
+ * @return array
+ */
+ private function getObjectTypes(): array
+ {
+ $sql = "SELECT object_type.*
+ FROM wcf1_object_type object_type
+ INNER JOIN wcf1_object_type_definition definition
+ ON definition.definitionID = object_type.definitionID
+ WHERE definition.definitionName = ?";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute([$this->definitionName]);
+
+ $objectTypes = [];
+ while ($row = $statement->fetchArray()) {
+ $objectTypes[$row['objectTypeID']] = new ObjectType(null, $row);
+ }
+
+ return $objectTypes;
+ }
+
+ /**
+ * Returns the conditions of existing objects and whether the objects are
+ * disabled, grouped by the id of the object.
+ *
+ * @param list $objectTypeIDs
+ * @return array,
+ * }>
+ */
+ private function getConditionsByObject(array $objectTypeIDs): array
+ {
+ $conditionBuilder = new PreparedStatementConditionBuilder();
+ $conditionBuilder->add('condition_table.objectTypeID IN (?)', [$objectTypeIDs]);
+
+ // Conditions of deleted objects are skipped.
+ $sql = "SELECT condition_table.conditionID, condition_table.objectTypeID,
+ condition_table.objectID, condition_table.conditionData,
+ object_table.isDisabled
+ FROM wcf1_condition condition_table
+ INNER JOIN {$this->tableName} object_table
+ ON object_table.{$this->idColumn} = condition_table.objectID
+ {$conditionBuilder}
+ ORDER BY condition_table.objectID, condition_table.conditionID";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute($conditionBuilder->getParameters());
+
+ $objects = [];
+ while ($row = $statement->fetchArray()) {
+ $objects[$row['objectID']] ??= [
+ 'isDisabled' => (bool)$row['isDisabled'],
+ 'conditions' => [],
+ ];
+ $objects[$row['objectID']]['conditions'][] = [
+ 'conditionID' => $row['conditionID'],
+ 'objectTypeID' => $row['objectTypeID'],
+ 'conditionData' => $row['conditionData'],
+ ];
+ }
+
+ return $objects;
+ }
+
+ /**
+ * Appends the given filters to the object, deletes the converted legacy
+ * conditions and updates the disabled state unless it is `null`.
+ *
+ * @param list $filters
+ * @param list $convertedConditionIDs
+ */
+ private function updateObject(
+ int $objectID,
+ array $filters,
+ array $convertedConditionIDs,
+ ?bool $isDisabled
+ ): void {
+ WCF::getDB()->beginTransaction();
+ try {
+ if ($filters !== []) {
+ $sql = "SELECT conditions
+ FROM {$this->tableName}
+ WHERE {$this->idColumn} = ?
+ FOR UPDATE";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute([$objectID]);
+ $existingFilters = \json_decode((string)$statement->fetchSingleColumn(), true);
+
+ // Keeps filters that were migrated by an earlier run, e.g. by another package.
+ if (\is_array($existingFilters)) {
+ $filters = [...$existingFilters, ...$filters];
+ }
+
+ $sql = "UPDATE {$this->tableName}
+ SET conditions = ?
+ WHERE {$this->idColumn} = ?";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute([
+ \json_encode($filters, \JSON_THROW_ON_ERROR),
+ $objectID,
+ ]);
+ }
+
+ if ($convertedConditionIDs !== []) {
+ $conditionBuilder = new PreparedStatementConditionBuilder();
+ $conditionBuilder->add('conditionID IN (?)', [$convertedConditionIDs]);
+
+ $sql = "DELETE FROM wcf1_condition
+ {$conditionBuilder}";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute($conditionBuilder->getParameters());
+ }
+
+ if ($isDisabled !== null) {
+ $sql = "UPDATE {$this->tableName}
+ SET isDisabled = ?
+ WHERE {$this->idColumn} = ?";
+ $statement = WCF::getDB()->prepare($sql);
+ $statement->execute([(int)$isDisabled, $objectID]);
+ }
+
+ WCF::getDB()->commitTransaction();
+ } catch (\Throwable $e) {
+ WCF::getDB()->rollBackTransaction();
+
+ throw $e;
+ }
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/DaysOfWeekObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/DaysOfWeekObjectFilter.class.php
new file mode 100644
index 00000000000..86935c9d6ec
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/DaysOfWeekObjectFilter.class.php
@@ -0,0 +1,77 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractMultipleSelectionObjectFilter
+ */
+final class DaysOfWeekObjectFilter extends AbstractMultipleSelectionObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.daysOfWeek';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.daysOfWeek';
+ }
+
+ #[\Override]
+ protected function getLabels(array $objectIDs): array
+ {
+ return \array_values(\array_map(
+ static fn(string $day) => WCF::getLanguage()->get($day),
+ \array_intersect_key($this->getDays(), \array_flip($objectIDs)),
+ ));
+ }
+
+ #[\Override]
+ public function getFormField(): MultipleSelectionFormField
+ {
+ return MultipleSelectionFormField::create('daysOfWeek')
+ ->label('wcf.date.daysOfWeek')
+ ->options($this->getDays())
+ ->required();
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ $now = new \DateTimeImmutable('now', $object->getTimeZone());
+
+ return \in_array((int)$now->format('w'), $configuredValue, true);
+ }
+
+ /**
+ * Returns the language items of the days of the week, indexed by their
+ * number and sorted by the first day of the week.
+ *
+ * @return array
+ */
+ private function getDays(): array
+ {
+ return \array_map(
+ static fn(string $day) => 'wcf.date.day.' . $day,
+ DateUtil::getWeekDays(),
+ );
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserActivatedObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserActivatedObjectFilter.class.php
new file mode 100644
index 00000000000..8b3f374a2f8
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserActivatedObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserActivatedObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userActivated';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.activated';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add('activationCode = 0');
+ } else {
+ $conditions->add('activationCode <> 0');
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === !$object->pendingActivation();
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserAvatarObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserAvatarObjectFilter.class.php
new file mode 100644
index 00000000000..d381259b25b
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserAvatarObjectFilter.class.php
@@ -0,0 +1,58 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserAvatarObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userAvatar';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.avatar';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add("avatarFileID IS NOT NULL");
+ } else {
+ $conditions->add("avatarFileID IS NULL");
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return match ($configuredValue) {
+ true => $object->avatarFileID !== null,
+ false => $object->avatarFileID === null,
+ };
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserBannedObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserBannedObjectFilter.class.php
new file mode 100644
index 00000000000..2845beb63b3
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserBannedObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserBannedObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userBanned';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.banned';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add('banned = 1');
+ } else {
+ $conditions->add('banned = 0');
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === ($object->banned !== 0);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserBirthdayObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserBirthdayObjectFilter.class.php
new file mode 100644
index 00000000000..75975468b15
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserBirthdayObjectFilter.class.php
@@ -0,0 +1,50 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ */
+final class UserBirthdayObjectFilter extends AbstractBooleanObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userBirthday';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.birthday';
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ $today = new \DateTimeImmutable('now', $object->getTimeZone());
+ $userIDs = UserBirthdayCache::getInstance()->getBirthdays(
+ (int)$today->format('n'),
+ (int)$today->format('j'),
+ );
+
+ return $configuredValue === \in_array($object->userID, $userIDs, true);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserCoverPhotoObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserCoverPhotoObjectFilter.class.php
new file mode 100644
index 00000000000..2618f36d48f
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserCoverPhotoObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserCoverPhotoObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userCoverPhoto';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.coverPhoto';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add("coverPhotoFileID IS NOT NULL");
+ } else {
+ $conditions->add("coverPhotoFileID IS NULL");
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === ($object->coverPhotoFileID !== null);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserEmailConfirmedObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserEmailConfirmedObjectFilter.class.php
new file mode 100644
index 00000000000..3f6ea29c493
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserEmailConfirmedObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserEmailConfirmedObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userEmailConfirmed';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.emailConfirmed';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add('emailConfirmed IS NULL');
+ } else {
+ $conditions->add('emailConfirmed IS NOT NULL');
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === $object->isEmailConfirmed();
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserEmailObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserEmailObjectFilter.class.php
new file mode 100644
index 00000000000..d55b2b709d7
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserEmailObjectFilter.class.php
@@ -0,0 +1,100 @@
+
+ * @since 6.3
+ *
+ * @implements IObjectListFilter
+ */
+final class UserEmailObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userEmail';
+ }
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get('wcf.objectFilter.user.email');
+ }
+
+ #[\Override]
+ public function getFormField(): TextFormField
+ {
+ return TextFormField::create('userEmail')
+ ->label('wcf.user.email')
+ ->maximumLength(255)
+ ->required();
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): string
+ {
+ return $serializedValue;
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): string
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->getDynamicVariable('wcf.objectFilter.user.email.summary', [
+ 'value' => $value,
+ ]);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add('email LIKE ?', ['%' . WCF::getDB()->escapeLikeValue($value) . '%']);
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ // Must match the case-insensitive `LIKE` in `applyFilter()`.
+ return \mb_stripos($object->email, $configuredValue) !== false;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserGroupObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserGroupObjectFilter.class.php
new file mode 100644
index 00000000000..e7e6f623d6b
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserGroupObjectFilter.class.php
@@ -0,0 +1,90 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractSelectionObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserGroupObjectFilter extends AbstractSelectionObjectFilter implements IObjectListFilter
+{
+ /**
+ * @param bool $includeGuests offers the guest group for selection, only useful if guests are tested
+ */
+ public function __construct(
+ private readonly bool $includeGuests = false,
+ ) {}
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userGroup';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.group';
+ }
+
+ #[\Override]
+ protected function createOptions(): array
+ {
+ return UserGroupObjectFilter::getSelectableGroups($this->includeGuests);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add(
+ 'user_table.userID IN (
+ SELECT userID
+ FROM wcf1_user_to_group
+ WHERE groupID = ?
+ )',
+ [$value]
+ );
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return \in_array($configuredValue, $object->getGroupIDs(), true);
+ }
+
+ /**
+ * Returns the names of the user groups that can be selected, indexed by their id.
+ *
+ * @return array
+ * @internal
+ */
+ public static function getSelectableGroups(bool $includeGuests): array
+ {
+ $invalidGroupTypes = [
+ UserGroup::EVERYONE,
+ UserGroup::USERS,
+ ];
+ if (!$includeGuests) {
+ $invalidGroupTypes[] = UserGroup::GUESTS;
+ }
+
+ return \array_map(
+ static fn(UserGroup $group) => $group->getName(),
+ UserGroup::getSortedAccessibleGroups([], $invalidGroupTypes),
+ );
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserIntegerPropertyObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserIntegerPropertyObjectFilter.class.php
new file mode 100644
index 00000000000..e3518808221
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserIntegerPropertyObjectFilter.class.php
@@ -0,0 +1,116 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractRangeObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserIntegerPropertyObjectFilter extends AbstractRangeObjectFilter implements IObjectListFilter
+{
+ /**
+ * @param string $propertyName name of the integer column in `wcf1_user`
+ * @param string $languageItem language item of the title of the property
+ * @param array $languageItemVariables variables of the language item of the title
+ */
+ public function __construct(
+ private readonly string $propertyName,
+ private readonly string $languageItem,
+ private readonly array $languageItemVariables = [],
+ ) {}
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.user' . \ucfirst($this->propertyName);
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return $this->languageItem;
+ }
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->getDynamicVariable($this->languageItem, $this->languageItemVariables);
+ }
+
+ #[\Override]
+ protected function createFormField(): NumericRangeFormField
+ {
+ return NumericRangeFormField::create('user' . \ucfirst($this->propertyName))
+ ->label($this->languageItem, $this->languageItemVariables)
+ ->integerValues()
+ ->minimum(0);
+ }
+
+ #[\Override]
+ protected function unserializeBound(string $bound): int
+ {
+ return (int)$bound;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ [$from, $to] = $value;
+
+ return WCF::getLanguage()->getDynamicVariable('wcf.objectFilter.user.integerProperty.summary', [
+ 'title' => $this->getTitle(),
+ 'from' => $from,
+ 'to' => $to,
+ ]);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ [$from, $to] = $value;
+
+ if ($from !== null) {
+ $conditions->add($this->propertyName . ' >= ?', [$from]);
+ }
+ if ($to !== null) {
+ $conditions->add($this->propertyName . ' <= ?', [$to]);
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ [$from, $to] = $configuredValue;
+ $value = $object->{$this->propertyName};
+
+ if ($from !== null && $value < $from) {
+ return false;
+ }
+ if ($to !== null && $value > $to) {
+ return false;
+ }
+
+ return true;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserLanguageObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserLanguageObjectFilter.class.php
new file mode 100644
index 00000000000..e8d4d652322
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserLanguageObjectFilter.class.php
@@ -0,0 +1,80 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractMultipleSelectionObjectFilter
+ * @implements IObjectListFilter>
+ */
+final class UserLanguageObjectFilter extends AbstractMultipleSelectionObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userLanguage';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.language';
+ }
+
+ #[\Override]
+ protected function getLabels(array $objectIDs): array
+ {
+ $labels = [];
+ foreach ($objectIDs as $languageID) {
+ $language = LanguageFactory::getInstance()->getLanguage($languageID);
+ if ($language !== null) {
+ $labels[] = $language->__toString();
+ }
+ }
+
+ return $labels;
+ }
+
+ #[\Override]
+ public function getFormField(): MultipleSelectionFormField
+ {
+ return MultipleSelectionFormField::create('userLanguage')
+ ->label('wcf.user.condition.languages')
+ ->options(LanguageFactory::getInstance()->getLanguages())
+ ->required();
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add('languageID IN (?)', [$value]);
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return \in_array(WCF::getLanguage()->languageID, $configuredValue, true);
+ }
+
+ return \in_array($object->languageID, $configuredValue, true);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserMobileBrowserObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserMobileBrowserObjectFilter.class.php
new file mode 100644
index 00000000000..2e193d1eead
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserMobileBrowserObjectFilter.class.php
@@ -0,0 +1,42 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ */
+final class UserMobileBrowserObjectFilter extends AbstractBooleanObjectFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userMobileBrowser';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.mobileBrowser';
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return $configuredValue === UserUtil::usesMobileBrowser();
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserMultifactorObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserMultifactorObjectFilter.class.php
new file mode 100644
index 00000000000..c8849510fe0
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserMultifactorObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserMultifactorObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userMultifactor';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.multifactor';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add('multifactorActive = 1');
+ } else {
+ $conditions->add('multifactorActive = 0');
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === ($object->multifactorActive !== 0);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserNoTrophyObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserNoTrophyObjectFilter.class.php
new file mode 100644
index 00000000000..43572e1920d
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserNoTrophyObjectFilter.class.php
@@ -0,0 +1,60 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractSelectionObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserNoTrophyObjectFilter extends AbstractSelectionObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userNoTrophy';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.noTrophy';
+ }
+
+ #[\Override]
+ protected function createOptions(): array
+ {
+ return UserTrophyObjectFilter::getSelectableTrophies();
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add(
+ 'user_table.userID NOT IN (
+ SELECT userID
+ FROM wcf1_user_trophy
+ WHERE trophyID = ?
+ )',
+ [$value]
+ );
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return !\in_array($configuredValue, UserTrophyObjectFilter::getTrophyIDs($object), true);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserNotInGroupObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserNotInGroupObjectFilter.class.php
new file mode 100644
index 00000000000..aa90489c801
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserNotInGroupObjectFilter.class.php
@@ -0,0 +1,67 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractSelectionObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserNotInGroupObjectFilter extends AbstractSelectionObjectFilter implements IObjectListFilter
+{
+ /**
+ * @param bool $includeGuests offers the guest group for selection, only useful if guests are tested
+ */
+ public function __construct(
+ private readonly bool $includeGuests = false,
+ ) {}
+
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userNotInGroup';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.notInGroup';
+ }
+
+ #[\Override]
+ protected function createOptions(): array
+ {
+ return UserGroupObjectFilter::getSelectableGroups($this->includeGuests);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add(
+ 'user_table.userID NOT IN (
+ SELECT userID
+ FROM wcf1_user_to_group
+ WHERE groupID = ?
+ )',
+ [$value]
+ );
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return !\in_array($configuredValue, $object->getGroupIDs(), true);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDateObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDateObjectFilter.class.php
new file mode 100644
index 00000000000..44f9c73e2a0
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDateObjectFilter.class.php
@@ -0,0 +1,145 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractRangeObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserRegistrationDateObjectFilter extends AbstractRangeObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userRegistrationDate';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.registrationDate';
+ }
+
+ #[\Override]
+ protected function createFormField(): DateRangeFormField
+ {
+ return DateRangeFormField::create('userRegistrationDate')
+ ->label('wcf.user.condition.registrationDate');
+ }
+
+ #[\Override]
+ protected function unserializeBound(string $bound): string
+ {
+ return $bound;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ [$from, $to] = $value;
+
+ $formatter = new \IntlDateFormatter(
+ WCF::getLanguage()->getLocale(),
+ \IntlDateFormatter::LONG,
+ \IntlDateFormatter::NONE,
+ 'UTC',
+ );
+ $format = static function (?string $date) use ($formatter): ?string {
+ if ($date === null) {
+ return null;
+ }
+
+ $dateTime = \DateTimeImmutable::createFromFormat('!Y-m-d', $date, new \DateTimeZone('UTC'));
+ if ($dateTime === false) {
+ return $date;
+ }
+
+ return $formatter->format($dateTime);
+ };
+
+ return WCF::getLanguage()->getDynamicVariable('wcf.objectFilter.user.registrationDate.summary', [
+ 'from' => $format($from),
+ 'to' => $format($to),
+ ]);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ [$start, $end] = $this->getBoundaries($value);
+
+ if ($start !== null) {
+ $conditions->add('registrationDate >= ?', [$start]);
+ }
+ if ($end !== null) {
+ $conditions->add('registrationDate < ?', [$end]);
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ [$start, $end] = $this->getBoundaries($configuredValue);
+
+ if ($start !== null && $object->registrationDate < $start) {
+ return false;
+ }
+ if ($end !== null && $object->registrationDate >= $end) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Returns the timestamp of the start of the first day and the timestamp
+ * of the start of the day after the last day.
+ *
+ * @param array{0: ?string, 1: ?string} $value
+ * @return array{0: ?int, 1: ?int}
+ */
+ private function getBoundaries(array $value): array
+ {
+ [$from, $to] = $value;
+ $timezone = new \DateTimeZone(\TIMEZONE);
+
+ $start = null;
+ if ($from !== null) {
+ $dateTime = \DateTimeImmutable::createFromFormat('!Y-m-d', $from, $timezone);
+ if ($dateTime !== false) {
+ $start = $dateTime->getTimestamp();
+ }
+ }
+
+ $end = null;
+ if ($to !== null) {
+ $dateTime = \DateTimeImmutable::createFromFormat('!Y-m-d', $to, $timezone);
+ if ($dateTime !== false) {
+ $end = $dateTime->modify('+1 day')->getTimestamp();
+ }
+ }
+
+ return [$start, $end];
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDaysObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDaysObjectFilter.class.php
new file mode 100644
index 00000000000..8305c0d639e
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserRegistrationDaysObjectFilter.class.php
@@ -0,0 +1,85 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractRangeObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserRegistrationDaysObjectFilter extends AbstractRangeObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userRegistrationDays';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.registrationDays';
+ }
+
+ #[\Override]
+ protected function createFormField(): NumericRangeFormField
+ {
+ return NumericRangeFormField::create('userRegistrationDays')
+ ->label('wcf.user.condition.registrationDateInterval')
+ ->integerValues()
+ ->minimum(0);
+ }
+
+ #[\Override]
+ protected function unserializeBound(string $bound): int
+ {
+ return (int)$bound;
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ [$from, $to] = $value;
+
+ if ($from !== null) {
+ $conditions->add('registrationDate <= ?', [\TIME_NOW - $from * 86400]);
+ }
+ if ($to !== null) {
+ $conditions->add('registrationDate >= ?', [\TIME_NOW - $to * 86400]);
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ [$from, $to] = $configuredValue;
+
+ if ($from !== null && $object->registrationDate > \TIME_NOW - $from * 86400) {
+ return false;
+ }
+ if ($to !== null && $object->registrationDate < \TIME_NOW - $to * 86400) {
+ return false;
+ }
+
+ return true;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserSignatureObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserSignatureObjectFilter.class.php
new file mode 100644
index 00000000000..e70731f2e8a
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserSignatureObjectFilter.class.php
@@ -0,0 +1,55 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractBooleanObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserSignatureObjectFilter extends AbstractBooleanObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userSignature';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.signature';
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ if ($value) {
+ $conditions->add("(signature <> '' AND signature IS NOT NULL)");
+ } else {
+ $conditions->add("(signature = '' OR signature IS NULL)");
+ }
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ return $configuredValue === ($object->signature !== '' && $object->signature !== null);
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserTrophyObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserTrophyObjectFilter.class.php
new file mode 100644
index 00000000000..51a1f9c4477
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserTrophyObjectFilter.class.php
@@ -0,0 +1,106 @@
+
+ * @since 6.3
+ *
+ * @extends AbstractSelectionObjectFilter
+ * @implements IObjectListFilter
+ */
+final class UserTrophyObjectFilter extends AbstractSelectionObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userTrophy';
+ }
+
+ #[\Override]
+ protected function getLanguageItem(): string
+ {
+ return 'wcf.objectFilter.user.trophy';
+ }
+
+ #[\Override]
+ protected function createOptions(): array
+ {
+ return UserTrophyObjectFilter::getSelectableTrophies();
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add(
+ 'user_table.userID IN (
+ SELECT userID
+ FROM wcf1_user_trophy
+ WHERE trophyID = ?
+ )',
+ [$value]
+ );
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ return \in_array($configuredValue, UserTrophyObjectFilter::getTrophyIDs($object), true);
+ }
+
+ /**
+ * Returns the titles of the trophies that can be selected, indexed by their id.
+ *
+ * @return array
+ * @internal
+ */
+ public static function getSelectableTrophies(): array
+ {
+ $trophies = \array_map(
+ static fn(Trophy $trophy) => $trophy->getTitle(),
+ TrophyCache::getInstance()->getTrophies(),
+ );
+
+ $collator = new \Collator(WCF::getLanguage()->getLocale());
+ \uasort(
+ $trophies,
+ static fn(string $a, string $b) => $collator->compare($a, $b)
+ );
+
+ return $trophies;
+ }
+
+ /**
+ * Returns the ids of the enabled trophies the given user has received.
+ *
+ * @return list
+ * @internal
+ */
+ public static function getTrophyIDs(User $user): array
+ {
+ if ($user->isGuest()) {
+ return [];
+ }
+
+ $userTrophies = UserTrophyList::getUserTrophies([$user->userID])[$user->userID];
+
+ return \array_values(\array_map(
+ static fn($userTrophy) => $userTrophy->trophyID,
+ $userTrophies,
+ ));
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/object/filter/user/UserUsernameObjectFilter.class.php b/wcfsetup/install/files/lib/system/object/filter/user/UserUsernameObjectFilter.class.php
new file mode 100644
index 00000000000..c2234135c25
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/object/filter/user/UserUsernameObjectFilter.class.php
@@ -0,0 +1,100 @@
+
+ * @since 6.3
+ *
+ * @implements IObjectListFilter
+ */
+final class UserUsernameObjectFilter implements IObjectListFilter
+{
+ #[\Override]
+ public function getIdentifier(): string
+ {
+ return 'com.woltlab.wcf.userUsername';
+ }
+
+ #[\Override]
+ public function getTitle(): string
+ {
+ return WCF::getLanguage()->get('wcf.objectFilter.user.username');
+ }
+
+ #[\Override]
+ public function getFormField(): TextFormField
+ {
+ return TextFormField::create('userUsername')
+ ->label('wcf.user.username')
+ ->maximumLength(255)
+ ->required();
+ }
+
+ #[\Override]
+ public function isAvailable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function isRepeatable(): bool
+ {
+ return true;
+ }
+
+ #[\Override]
+ public function serializeValue(mixed $value): string
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function unserializeValue(string $serializedValue): string
+ {
+ return $serializedValue;
+ }
+
+ #[\Override]
+ public function toFormFieldValue(mixed $value): string
+ {
+ return $value;
+ }
+
+ #[\Override]
+ public function summarizeValue(mixed $value): string
+ {
+ return WCF::getLanguage()->getDynamicVariable('wcf.objectFilter.user.username.summary', [
+ 'value' => $value,
+ ]);
+ }
+
+ #[\Override]
+ public function applyFilter(PreparedStatementConditionBuilder $conditions, mixed $value): void
+ {
+ $conditions->add('username LIKE ?', ['%' . WCF::getDB()->escapeLikeValue($value) . '%']);
+ }
+
+ #[\Override]
+ public function testObject(DatabaseObject $object, mixed $configuredValue): bool
+ {
+ if ($object->isGuest()) {
+ return false;
+ }
+
+ // Must match the case-insensitive `LIKE` in `applyFilter()`.
+ return \mb_stripos($object->username, $configuredValue) !== false;
+ }
+}
diff --git a/wcfsetup/install/files/lib/system/user/group/assignment/UserGroupAssignmentHandler.class.php b/wcfsetup/install/files/lib/system/user/group/assignment/UserGroupAssignmentHandler.class.php
index 396395078b3..a6548f3cf08 100644
--- a/wcfsetup/install/files/lib/system/user/group/assignment/UserGroupAssignmentHandler.class.php
+++ b/wcfsetup/install/files/lib/system/user/group/assignment/UserGroupAssignmentHandler.class.php
@@ -9,6 +9,7 @@
use wcf\data\user\UserAction;
use wcf\data\user\UserList;
use wcf\system\cache\builder\UserGroupAssignmentCacheBuilder;
+use wcf\system\object\filter\builder\UserGroupAssignmentObjectFilterBuilder;
use wcf\system\SingletonFactory;
/**
@@ -48,25 +49,21 @@ public function checkUsers(array $userIDs)
/** @var UserGroupAssignment[] $assignments */
$assignments = UserGroupAssignmentCacheBuilder::getInstance()->getData();
+ $builder = new UserGroupAssignmentObjectFilterBuilder();
+
foreach ($userList as $user) {
$groupIDs = $user->getGroupIDs();
$newGroupIDs = [];
foreach ($assignments as $assignment) {
- if (\in_array($assignment->groupID, $groupIDs, true) || \in_array($assignment->groupID, $newGroupIDs, true)) {
+ if (
+ \in_array($assignment->groupID, $groupIDs, true)
+ || \in_array($assignment->groupID, $newGroupIDs, true)
+ ) {
continue;
}
- $checkFailed = false;
- $conditions = $assignment->getConditions();
- foreach ($conditions as $condition) {
- if (!$condition->getObjectType()->getProcessor()->checkUser($condition, $user)) {
- $checkFailed = true;
- break;
- }
- }
-
- if (!$checkFailed) {
+ if ($builder->testUser($assignment, $user)) {
$newGroupIDs[] = $assignment->groupID;
}
}
@@ -114,10 +111,8 @@ public function getUsers(UserGroupAssignment $assignment, ?int $maxUsers = null)
$userList->sqlLimit = $maxUsers;
}
- $conditions = $assignment->getConditions();
- foreach ($conditions as $condition) {
- $condition->getObjectType()->getProcessor()->addUserCondition($condition, $userList);
- }
+ (new UserGroupAssignmentObjectFilterBuilder())->applyFilters($assignment, $userList->getConditionBuilder());
+
$userList->readObjects();
return $userList->getObjects();
diff --git a/wcfsetup/install/files/style/layout/form.scss b/wcfsetup/install/files/style/layout/form.scss
index b3f78cfd927..1be981df295 100644
--- a/wcfsetup/install/files/style/layout/form.scss
+++ b/wcfsetup/install/files/style/layout/form.scss
@@ -409,3 +409,48 @@ html[data-color-scheme="dark"] .passwordStrengthScore {
grid-column: 1 / 3;
}
}
+
+.objectFilter__container {
+ display: flex;
+ flex-direction: column;
+ gap: 5px;
+}
+
+.objectFilter__container:not(:empty) {
+ margin-bottom: 10px;
+}
+
+.objectFilter__item {
+ align-items: center;
+ background: var(--wcfContentBackground);
+ border: 1px solid var(--wcfContentBorderInner);
+ border-radius: var(--wcfBorderRadiusContainer);
+ display: flex;
+ gap: 10px;
+ justify-content: space-between;
+ padding: 12px;
+}
+
+.objectFilter__item__buttons {
+ display: flex;
+ flex-direction: row;
+ gap: 5px;
+}
+
+.objectFilter__joiner {
+ align-items: center;
+ color: var(--wcfContentDimmedText);
+ display: flex;
+ gap: 10px;
+ padding-left: 20px;
+
+ @include wcfFontSmall;
+}
+
+.objectFilter__joiner::before {
+ background: var(--wcfContentBorderInner);
+ content: "";
+ height: 16px;
+ margin-left: -8px;
+ width: 1px;
+}
diff --git a/wcfsetup/install/lang/de.xml b/wcfsetup/install/lang/de.xml
index a1ea5a5e502..cb3ad482d90 100644
--- a/wcfsetup/install/lang/de.xml
+++ b/wcfsetup/install/lang/de.xml
@@ -28,17 +28,11 @@
-
- {literal}{$username}{/literal} durch den Namen des aktiven Benutzers oder durch „Gast“
+ {literal}{$username}{/literal} durch den Namen des aktiven Benutzers oder durch „Gast“
]]>
- CSS-Klasse nutzen.]]>
+ - {$parentClass}.]]>
-
- {literal}{$username}{/literal} with the name of the active user or “Guest”
+ {literal}{$username}{/literal} with the name of the active user or “Guest”
]]>
- CSS class name.]]>
+ - {$parentClass}.]]>