User Tools

Site Tools


reference:spamrules_statement_bulkscan

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

reference:spamrules_statement_bulkscan [2018/11/14 10:45] (current)
Line 1: Line 1:
 +======Spam Filter Rules: BulkScan======
 +^Statement ​ |BulkScan |
 +^Version ​ |2.1.7+ |
 +^Purpose ​ |Allows you to specify lots of search strings in one section without needing the verbose [[spamrules_statement_if|If]] statement |
  
 +The **BulkScan** statement requires a variable name and a limitless number of search specifiers, in the format
 +  BulkScan <​variable name>
 +  <search specifier 1>
 +  <search specifier 2>
 +  #...
 +  EndBulkScan
 +
 +The <search specifier>​ requires a data parameter, a search value and a modification value, in the format
 +  <​data>​ <​search>​ <​modification value>
 +
 +VPOP3 goes through all of the search specifiers between the BulkScan and EndBulkScan statements. Where there is a match, the value of the specified variable is increased by the <​modification value> for that condition.
 +
 +  * The <​data>​ and <​search>​ parameters are defined in the documentation for [[spamrules_statement_ifmatch|IfMatch]]
 +  * The **BulkScan** statement must be terminated with **EndBulkScan**
 +  * No statements may be included between **BulkScan** and **EndBulkScan**,​ with the exception of [[spamrules_statement_include|Include]] which can only be used to include <search specifier>​ lines
 +
 +
 +=====Example=====
 +The following example will make a BulkScan sequence which will modify the ${Score} variable, and has a name of '​LoadsADosh'​.\\
 +It will scan the subject of the message for '​friend',​ and if it contains it, it will add 10 to the ${Score} variable, with any appropriate [[spamrules_rule_names_and_weights|rule weighting]] taking place.\\
 +Then, it will scan any text parts of the message for a dollar sign followed by one more more digits, then optional spaces, then the text '​million'​. If that exists, it will add 50 to the ${Score} variable.
 +<​code>​
 +BulkScan Score [LoadsADosh]
 + ​Subject /​.*friend.*/​i 10
 + Body /​.*\$[0-9\.]+\s*million.*/​i 50
 +EndBulkScan
 +</​code>​
reference/spamrules_statement_bulkscan.txt ยท Last modified: 2018/11/14 10:45 (external edit)