Differences

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

--- reference:white_black_lists [2013/03/04 17:36] – [Bulk Deletion of list entries] paul
+++ reference:white_black_lists [2018/11/14 10:45] (current) – external edit 127.0.0.1
@@ Line 8: / Line 8: @@
 Note that, by default, local email addresses on the whitelist will be ignored. This is by design, because it is a common spammer trick to pretend to be from a local email address. The **CheckLocalWhitelist** setting on the spam filter [[Spamfilter Script Configuration|Script Configuration]] tab can be used to alter this behaviour.
+=====White/Blacklist entries=====
+====Address entries====
+When you are adding whitelist or blacklist address entries, you can specify either a full email address, or use 'standard' wildcards (* and ?) or you can use a PCRE regular expression by surrounding the text with / ... / characters (with optional [[http://www.regular-expressions.info/modifiers.html|PCRE modifiers]] after the last /). Regular expressions give you the most control and flexibility over address matching, but can be complex if you are not used to them. There are many tutorials on the Internet about regular expressions, one we like is at http://regular-expressions.info.
+So, for instance, these are valid entries
+  * name@example.com
+  * *@example.com
+  * fred.*@example.com
+  * /^fred\.[a-z+]@example\.com/i
+====Word entries====
+When you are adding whitelist or blacklist word entries, you can specify either a simple substring to match or you can use a PCRE regular expression by surrounding the text with / ... / characters (with optional [[http://www.regular-expressions.info/modifiers.html|PCRE modifiers]] after the last /). Regular expressions give you the most control and flexibility over matching, but can be complex if you are not used to them. There are many tutorials on the Internet about regular expressions, one we like is at http://regular-expressions.info.
+So, for instance, these are valid entries
+  * sex
+  * /\bv[1i]agra/i
 ====Bulk Deletion of list entries====
 In v6.1 and later you can bulk delete whitelist & blacklist addresses based on conditions you specify. These are detailed below:
@@ Line 16: / Line 31: @@
   - **findcount** <comparator> <number> - compare the findcount to the specified value. //e.g. findcount<75//
   - **initiallyadded** <comparator> <age> - compare the initially added date to the specified age (whitelist only). //e.g. initiallyadded<5years//
-  - **lastadded** <comparator> <age> - compare the last added date to the specified age (whitelist only). //e.g. lastyadded>6months//
+  - **lastadded** <comparator> <age> - compare the last added date to the specified age (whitelist only). //e.g. lastadded>6months//
   - **lastfound** <comparator> <age> - compare the last found date to the specified age. //e.g. lastfound>=2days//
   - **addedby:**<name> - compare the user which initially added the entry to the specified value (using wildcards). //e.g. addedby:fred*//
   - **autoaddedby:**<name> - compare the address which automatically added the entry to the specified value (using wildcards) (whitelist only). //e.g. autoaddedby:*@yahoo.com//
-  - **matches:**regexp** - compare the entry address to the specified regular expression (case insensitive)
+  - **matches:**<regexp> - compare the entry address to the specified regular expression (case insensitive)
   - Any other value does a wildcard comparison of the value to the entry address
-All the specified conditions must match for the entry to be deleted. Once you have specified the conditions and pressed 'Delete', VPOP3 will tell you how many entries will be deleted, and will give you some examples of the entries which will be deleted. You can then confirm the deletion. If you find you have made a mistake, you can use the **Undo Last Bulk Delete** button to undo the latest bulk deletion (this only stores the deleted data for one day or until VPOP3 is restarted, whichever is the sooner).
+Do //not// put spaces around comparators, or after the colon character. Eg **addedby:fred* ** is valid, **addedby: fred* ** is not and will be treated as two separate conditions.
+For ages, VPOP3 recognises the periods: minutes, hours, days, months, years (the 's' at the end is optional).
+The comparators VPOP3 recognises are: %%<, =, > <=, >=, <>%%
+Separate multiple conditions with space characters. All the specified conditions must match for the entry to be deleted. Once you have specified the conditions and pressed 'Delete', VPOP3 will tell you how many entries will be deleted, and will give you some examples of the entries which will be deleted. You can then confirm the deletion. If you find you have made a mistake, you can use the **Undo Last Bulk Delete** button to undo the latest bulk deletion (this only stores the deleted data for one day or until VPOP3 is restarted, whichever is the sooner).

PSCS Wiki

User Tools

Site Tools

Differences

Page Tools