Next: The Folder Filters dialog
Up: The Filters Module
Previous: The Filters Dialog
  Contents
This dialog allows you to set up or edit an individual filtering rule, it contains
of the following components:
- The rule name, in the text entry field at the very top. This name is only to
help you remember what the rule does and will appear in the list of rules in
the main Filters Dialog, but is without any further significance.
- Underneath the name, you find the text ``If Message...'' followed by at least
one row of conditioncontrols.
- Under the condition controls you find the text ``Then do this:`` followed
by some action controls.
You can add more pattern matching controls by pressing the [More] button,
and you can delete the last pattern matching rule by pressing the [Less]
button. The number of actions to execute is fixed to one.
You can use several condition and connect them via logical AND and OR, optionally
negating them by ticking the [Not] box. The following conditions can be
tested for at present:
- Always - this rule will always be executed
- Contains - check if the text next to it is contained in the message component
selected
- Match - check if the message component selected is exactly this text (case independent)
- Match Case - check if the message compent selected is exactly this text (case
dependent)
- Match RegExp - check if the message compent selected matches the regular expression
specified
- Larger Than - check if the message is larger than this in KByte
- Smaller Than - check if the message is smaller than this in KByte
- Older Than - check if the message is older than this many days
- Newer Than - check if the message is newer than this many days
- Is SPAM - check if the message originates from a system blacklisted as sending
unsolicited emails (SPAM).
- Python - execute the text in the box in the built-in Python interpreter and
proceed if it returns a non-0 result.
The possible actions which can be performed, are:
- Delete - deletes the message
- Copy to - copies the message to the folder specified
- Move to - moves the message to the folder specified
- Expunge - expunge all messages in this folder
- MessageBox - open a message box dialog with the text specified
- LogEntry - add the text specified to the log window
- Python - execute the text specified in the built-in Python interpreter
If you are not using a Trash folder, it is a good idea to add a rule at the
end of the list of filtering rules, that always expunges all messages. For testing
filters, you can leave that rule disabled, an all messages will get treated
and marked as deleted, but stay around. Only when expunge is executed, will
they really disappear in the original mailbox. Notice, if you are using a Trash
folder, this does not apply, as messages won't be marked as deleted but moved
straight to Trash.
Next: The Folder Filters dialog
Up: The Filters Module
Previous: The Filters Dialog
  Contents
Charlie &
2001-04-19