New Rules Filter Description Proposal

For all users, who don't speak German!

Moderator: Forum-Team

New Rules Filter Description Proposal

Beitragvon boat_broker » 28. Mär 2010, 01:55

I haven't found any description of the new Rules Filter (Wizard) so I put together a brief description of the steps that I used to make a new Rule. I hope that this is helpful. If someone finds some errors please leave a note and I'll try to correct it or remove the post.

Mike
*********************

Spamihilator Rules Wizard Information

To create a new “Rule” open Spami’s Settings Window (right click the Spami Quick Launch envelope icon and select Settings). In the left panel you should see a Rules folder, select that.

Bild


That will open the Rules main window with two tabs. Select the Add button in the Rules tab to bring up the “Add Rule” window.

Bild


You define your new rule in this Add Rule window. First assign a unique name for the rule. Next, you can select from two actions for Spami to do: 1) “Move message to the Recycle Bin” (this is the Spamihilator Recycle Bin) or 2) “Send message to the email client (Such as Outlook).

Determine the number of conditions that you want your rule to have and whether the rule will apply if one of the conditions is met or if all of the conditions are met and click off the appropriate check box.

Click the “+” symbol for each condition that you want to include and a formula line will appear for each click. If you click too many there is an “X” next to each one which will delete it.

Bild


Each condition includes two description drop boxes and an expression field. The first drop box identifies the area in the message that the condition will apply to. The second drop box describes the property that the condition checks for and identifies the expression field as a “Regular Expression” or not. The expression field can be either characters (and maybe some non-characters but these will likely be dealt with as Regular Expressions) or a Regular Expression (see Chactory’s RegEx Description. http://wiki.spamihilator.com/doku.php?id=en:tutorials:regex)

Bild


At the bottom of the Add Rule screen is an “Advanced” button for advanced settings. By default these are inactive. Advanced Settings allow you to enable one or two rule specific settings”. 1) “Don’t save mails classified by the rule filter in the Training Area.” and/or 2) “Automatically learn from those mails.” These two settings are specific for this particular rule. There is a “Settings” tab on the main screen that allows you to set these same two options for the combined rules overall.

Bild


Once you have set your conditions click “OK” at the bottom and either select to “Add”/”Edit”/”Delete” a rule or “Apply” the rule and click out with “OK”

You may wish to elevate or reduce the priority of the Rule Filter in the Priority section of the Filter Properties folder in the Main Settings Window.

Bild
boat_broker
Spam-Jäger
Spam-Jäger
 
Beiträge: 18
Registriert: 16. Mär 2006, 22:24

Re: New Rules Filter Description Proposal

Beitragvon Chactory » 28. Mär 2010, 23:20

Hello Mike!

Very well done! :) Thank you very much! 8)

At the same time, I have tried to translate Michels guide to the Rule Filter into English:

====== Rules ======

{{ de:configrules_de.png?200!direct|Liste der Regeln}}

The settings described here are belonging to the [[rulefilter|Rule Filter]].

The Rule Filter checks mails with configurable **Rules**.

You can add new Rules by clicking on "**New**".

You can configure existing Rules by clicking on "**Change**".

You can naturally remove particular Rules from the list. Just click on "**Delete**".

===== Add a New Rule =====

{{ de:addrule_de.png?200!direct|Regel hinzufügen}}

Every Rule is named by an unmistakable name, in that you can find it easily in the list of the rules. If the Rule Filter has processed an e-mail, the name of the Rule will be shown in the [[recycle|Recycle Bin]], respectively, in the [[trainingarea|Training Area]] (in the filter reason section).

Moreover, you can set for every Rule, what you want to happen, if it fits to an e-mail. With **Action** you can choose the concerned e-mail to be moved into the Recycle Bin (this fits to spam-messages) or to be conveyed to your e-mail client (non-spam).

==== Conditions ====

All Rules contain one ore more **Conditions**, which can turn to be true or false. While adding a Rule, you can specify, whether all Conditions have to be true (logical AND), or at least one (logical OR), to let the action defined be executed.

A Condition consists of a **Subject**, a **Relation** and an **Argument**.

With the **Subject**, you are declaring, which part of an e-mail received you want to be examined. The following Subjects are available:

* Subject (of the mail)
* Sender
* Addressee
* CC
* Date
* Size (KB)
* Message text
* Message (with HTML)
* Others ...

Choosing the entry **Others**, you can add further message header lines you want to be checked by the Rule Filter.

You can choose one of the following **Relations**:

* contains (german "enthält")
* contains not (german "enthält nicht")
* is (german "ist")
* is not (german "ist nicht")
* begins with (german "beginnt mit")
* ends with (german "endet mit")
* is larger than (german "ist größer als")
* is smaller than (german "ist kleiner als")
* contains (RegEx) (german "enthält (RegEx)")
* contains not (RegEx) (german "enthält nicht (RegEx)")
* fits to (RegEx) (german "passt zu (RegEx)")
* fits not to (RegEx) (german "passt nicht zu (RegEx)")

As **Argument** you can put in any text you want to be compared by the chosen Relation with the Subject. If you use "is larger than (german "ist größer als")", respectively "is smaller than (german "ist kleiner als")", Spamihilator will try to interpret the Argument as a number. With the Relations tagged with "(RegEx)", you can specify the Argument with regular expressions (read more about [[en:tutorials:regex|Regular Expressions]]).

===== Examples =====

The following Rule will move an e-mail into the Recycle Bin, which has been already labeled as spam by the mail server:

**Name**: Already Labeled as Spam by the Mail Server\\
**Action**: Move Message to the Recycle Bin\\
**Condition**: "''X-Spam-Flag''" begins with "''YES''"

With the following Rule, all e-mails larger than 1 MB will be transferred to you mail client automatically:

**Name**: Large Non-Spam Message\\
**Action**: Send Message to the E-Mail Client\\
**Condition**: "Size (KB)" is larger than "''1024''"

===== Advanced Settings =====

Click on **Advanced** to enable [[configrulessettings|Rule Specific Settings]] of handling within the Training Area for a particular Rule.


Please read it with critical eyes an give me a feedback about English language translation faults within. :)

Perhaps we can add some information from this text to Mike's brilliant explanation, discuss it, and take it for the online help, if Mike would allow?

Regards, Chactory
HilfeHelp «en»TippsAnbuva's FAQBob's FAQ «en»SpamwortlisteRegelfilterScreenshotsSSL/TLSSpami 1.6.0
Vostro 3450, Intel Core i5 2410M 2,3 GHz, 4 GB DDR3 SDRAM 1333 MHz, Windows 7 Pro 64 Bit SP1

Bild
Benutzeravatar
Chactory
Administrator
Administrator
 
Administration
Beta-Tester
Forum-Team
 
Beiträge: 9593
Registriert: 9. Jan 2004, 23:19
Wohnort: Kiel (D)

Re: New Rules Filter Description Proposal

Beitragvon boat_broker » 30. Mär 2010, 17:18

Thanks Chactory,

Here is my proposed copy of the translation of Michel's guide that you provided. I have also emailed you a copy with my changes and comments highlighted.

Mike

====== Rule Filter Instructions ======

The settings described here belong to the Rule Filter

The Rule Filter checks e-mails using configurable **Rules**.

You can add new Rules by clicking on "**New**".

You can configure existing Rules by clicking on "**Change**".

You can naturally remove particular Rules from the list. Just click on "**Delete**".

===== Add a New Rule =====

Every Rule is named by an unmistakable name, so that you can find it easily in the list of the rules. If the Rule Filter has processed an e-mail, the name of the Rule will be shown in the Recycle Bin and in the Training Area (in the filter reason section).

Moreover, for every Rule, you can set what you want to happen, if the rule applies to an e-mail. With **Action** you can choose the selected e-mail to be moved into the Recycle Bin (in the case of spam-messages) or to be conveyed to your e-mail client (non-spam).

==== Conditions ====

All Rules contain one ore more **Conditions**, which can turn to be true or false. When adding a Rule, you can specify, whether all (logical “AND”) Conditions have to be true, or at least one (logical “OR”) condition has to be true, to let the action for the defined rule to be executed.

A “Condition” consists of a **Subject**, a **Relation** and an **Argument**.

With the **Subject**, you are declaring, which part of an e-mail received you want to be examined. The following Subjects are available:

* Subject (of the mail)
* Sender
* Addressee
* CC
* Date
* Size (KB)
* Message text
* Message (with HTML)
* Others ...

Choosing the entry **Others**, you can add further message header lines you want to be checked by the Rule Filter.

You can choose one of the following **Relations**:

* contains
* contains not
* is
* is not
* starts with
* ends with
* is less than
*is greater than
* contains (RegEx)
* contains not (RegEx)
* matches (RegEx)
* matches not (RegEx)

For an **Argument** you can put in any text that you want to be evaluated by the selected **Relation** within the selected **Subject**. If you use "is larger than” or "is smaller than", Spamihilator will try to interpret the **Argument** as a number. When you select one of the **Relations** tagged with "(RegEx)", you can create the **Argument** with regular expressions (read more about regular expressions in the RegEX/Regular Expressions tutorial).

===== Examples =====

The following Rule will move an e-mail into the Recycle Bin, which has been already labelled as spam by the mail server:

**Name**: Already Labelled as Spam by the Mail Server\\
**Action**: Move Message to the Recycle Bin\\
**Condition**: "''X-Spam-Flag''" begins with "''YES''"

With the following Rule, all e-mails larger than 1 MB will be transferred to you mail client automatically:

**Name**: Large Non-Spam Message\\
**Action**: Send Message to the E-Mail Client\\
**Condition**: "Size (KB)" is larger than "''1024''"

===== Advanced Settings =====

Click on **Advanced** to establish how the Training Area will handle emails identified by this particular Rule.
boat_broker
Spam-Jäger
Spam-Jäger
 
Beiträge: 18
Registriert: 16. Mär 2006, 22:24

Re: New Rules Filter Description Proposal

Beitragvon Chactory » 31. Mär 2010, 21:55

Hello boat_broker!

Thank you very much! :) Michel has read the discussion and has fitted in the text into the wiki (see here), which contains the online help. Please leave to him a little more time, for he will be back in the forum in the easter holidays. Perhaps we can discuss again, if we can take your very helpful guidance with Michel's description, or create a wiki page for it, or perhaps place a hyperlink in the online help to your guidance.

Gruß, Chactory
HilfeHelp «en»TippsAnbuva's FAQBob's FAQ «en»SpamwortlisteRegelfilterScreenshotsSSL/TLSSpami 1.6.0
Vostro 3450, Intel Core i5 2410M 2,3 GHz, 4 GB DDR3 SDRAM 1333 MHz, Windows 7 Pro 64 Bit SP1

Bild
Benutzeravatar
Chactory
Administrator
Administrator
 
Administration
Beta-Tester
Forum-Team
 
Beiträge: 9593
Registriert: 9. Jan 2004, 23:19
Wohnort: Kiel (D)

Re: New Rules Filter Description Proposal

Beitragvon michel » 9. Apr 2010, 16:39

Hi boat_broker!

Thank you very much for your details tutorial about the rule filter. I would really like to see that in the Wiki. Would you like to have a wiki account to put the tutorial there yourself?

Regards
michel
Chuck Norris doesn't kill Spam. He uses Spamihilator! ;-)
Benutzeravatar
michel
Administrator
Administrator
 
Administration
Beta-Tester
Forum-Team
Plugin-Programmierer
 
Beiträge: 4335
Registriert: 22. Mär 2003, 01:16
Wohnort: Buseck

Re: New Rules Filter Description Proposal

Beitragvon boat_broker » 11. Apr 2010, 04:00

Hi Michael,

I would be pleased to put it on wiki but you'll need to give me instructions on getting a wiki account.

Mike
boat_broker
Spam-Jäger
Spam-Jäger
 
Beiträge: 18
Registriert: 16. Mär 2006, 22:24

Re: New Rules Filter Description Proposal

Beitragvon michel » 11. Apr 2010, 09:31

Hi Mike!

I created a user account for you. An email with details should be sent to you.

Bye,
Michel
Chuck Norris doesn't kill Spam. He uses Spamihilator! ;-)
Benutzeravatar
michel
Administrator
Administrator
 
Administration
Beta-Tester
Forum-Team
Plugin-Programmierer
 
Beiträge: 4335
Registriert: 22. Mär 2003, 01:16
Wohnort: Buseck

Re: New Rules Filter Description Proposal

Beitragvon anbuva » 11. Apr 2010, 11:47

Hallo boat_broker!

Great! :D

Regards
anbuva
Benutzeravatar
anbuva
Administrator
Administrator
 
Administration
Beta-Tester
Forum-Team
 
Beiträge: 8403
Registriert: 1. Sep 2004, 12:58
Wohnort: Zuhause


Zurück zu English Forum

Wer ist online?

Mitglieder in diesem Forum: 0 Mitglieder und 1 Gast

cron

 industrious-southeast