diff --git a/FAQ.md b/FAQ.md index 24ff0683b3..de731bb6d3 100644 --- a/FAQ.md +++ b/FAQ.md @@ -2692,6 +2692,10 @@ If a rule is part of a group, stop processing means stop processing the group. Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx. +
+ +**Conditions** + The following rule conditions are available: * Sender (from, reply-to) contains or sender is contact @@ -2702,6 +2706,7 @@ The following rule conditions are available: * Text contains (since version 1.1785) * Absolute time (received) between (since version 1.1540) * Relative time (received) between +* Expression (since version 1.2174) All the conditions of a rule need to be true for the rule action to be executed. All conditions are optional, but there needs to be at least one condition, to prevent matching all messages. @@ -2744,6 +2749,31 @@ Note that a regular expression supports an *or* operator, so if you want to matc Note that [dot all mode](https://developer.android.com/reference/java/util/regex/Pattern#DOTALL) is enabled to be able to match [unfolded headers](https://tools.ietf.org/html/rfc2822#section-3.2.3). +Since version 1.2174 it is possible to use expression conditions, which is [experimental](#faq125) for now. + +Please [see here](https://ezylang.github.io/EvalEx/references/references.html) about which constants, operators and functions are available. + +The following extra variables are available: + +* from (array) +* to (array) +* subject (array) +* text (array) +* hasAttachments (boolean) + +The following extra operators are available: + +* (array) contains +* (array) matches (=regex) + +The following extra functions are available: + +* header(name) + +
+ +**Actions** + You can select one of these actions to apply to matching messages: * No action (useful for *not*) @@ -4044,6 +4074,12 @@ Composing messages using [Markdown](https://en.wikipedia.org/wiki/Markdown) can
+*Rule expression condition (1.2174+)* + +See [this FAQ](#faq71) + +
+ **(126) Can message previews be sent to my smartwatch?** diff --git a/index.html b/index.html index 409a772386..0b9de9efc9 100644 --- a/index.html +++ b/index.html @@ -1468,6 +1468,8 @@ X-Google-Original-From: Somebody <somebody+extra@example.org>

You can disable a rule and you can stop processing other rules after a rule has been executed, which can be used to create a not condition.

Since version 1.2061 rules can be part of a named group. Group names will be displayed in the list of rules. If a rule is part of a group, stop processing means stop processing the group.

Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx.

+


+

Conditions

The following rule conditions are available:

All the conditions of a rule need to be true for the rule action to be executed. All conditions are optional, but there needs to be at least one condition, to prevent matching all messages.

If you want to match all senders or all recipients, you can just use the @ character as condition because all email addresses will contain this character. If you want to match a domain name, you can use as a condition something like @example.org

@@ -1492,6 +1495,27 @@ X-Google-Original-From: Somebody <somebody+extra@example.org>

Note that a regular expression supports an or operator, so if you want to match multiple senders, you can do this:

.*alice@example\.org.*|.*bob@example\.org.*|.*carol@example\.org.*

Note that dot all mode is enabled to be able to match unfolded headers.

+

Since version 1.2174 it is possible to use expression conditions, which is experimental for now.

+

Please see here about which constants, operators and functions are available.

+

The following extra variables are available:

+ +

The following extra operators are available:

+ +

The following extra functions are available:

+ +


+

Actions

You can select one of these actions to apply to matching messages: