======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>