rule system: add a small section about matching rules

this section explains how multiple object categories and multiple
objects interact with the rule matching.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
This commit is contained in:
Dominik Csapak 2024-02-09 13:54:37 +01:00 committed by Stoiko Ivanov
parent dc729b02a5
commit e807e3f14c

View File

@ -58,6 +58,23 @@ You can also disable a rule completely, which is mostly useful for
testing and debugging. The 'Factory Defaults' button allows you to testing and debugging. The 'Factory Defaults' button allows you to
reset the filter rules. reset the filter rules.
Application of Rules
--------------------
When there is more than one object category or multiple objects configured
within a single rule, the following logic is used to determine if the rule
should be applied:
* Within one category (WHAT/FROM/TO/WHEN), all objects are logical-or linked,
meaning that only one object of any one object group from the same category
has to match for the whole category to match.
* FROM/TO/WHAT/WHEN category match results are logical-and linked, so all
categories that have at least one object in them must match for the rule to
match.
When these conditions are met, all configured actions are executed.
[[pmg_mailfilter_action]] [[pmg_mailfilter_action]]
'Action' - objects 'Action' - objects