Partial support for IMAP LOgin Referrals: tell the user what's going on
[squirrelmail.git] / plugins / filters / README
CommitLineData
7aa22276 1Filters Plugin
849bdf42 2
3IMPORTANT: I've noticed at least one version of PHP that has bugs in the
4checkdnsrr() function that the SPAM filtering code RELIES ON. In my case,
5the PHP server that comes with Mandrake 8.1 has this problem -- checkdnsrr()
6NEVER finds the inaddr records, even the ones that really exist. (sigh)
7
8NOTE!!! As of the time of this writing, there is a bug in sqimap_read_data()
9in functions/imap_general.php. I rewrote it (see sqimap_read_data.php) so
10if the SPAM filters aren't filtering, make a backup copy of
11functions/imap_general.php, remove the sqimap_read_data() function in there
12and replace it with the contents of sqimap_read_data.php. Hopefully, either
13my replacement will be blessed by squirrelmail-devel or some other version
14will come out soon. Now back to your regularly scheduled README... (grin)
15
16This is a poor alternative to procmail or Elm's filter programs. This is a
17pathetic replacement for good RBL mail scanning when you get the mail. This
18is more for systems that can't/won't offer that kind of functionality and
19you still require it.
20
21This is slow. Yep. Slow.
22
23
a01a96eb 24To configure, first you need to rename config.sample.php to config.php.
bd1927c9 25You should then just take a peek at config.php and set
849bdf42 26$SpamFilters_YourHop to some string if you want to avoid tons of false
27hits on the RSS and DUL and ORBS databases. It should also speed up the
28scan somewhat.
29
bd1927c9 30If you do not want to enable spam filters for all users, edit config.php and
849bdf42 31set the $AllowSpamFilters to false. Spam filters can take TONS of time, so
32if you don't want your users to complain and ask you tons of questions, this
33is a quick and easy method.
34
35If you use UW and if you encounter strange errors while using this plugin on
bd1927c9 36your system, edit config.php and set $UseSeparateImapConnection to true. This
849bdf42 37may not solve the problem. One problem it might fix is if you run UW 2001
38and if you don't see the number of unread messages in your left-hand folder
39pane, or if you see timeouts or IMAP server error messages. Turning on this
40feature may slow down the filters a bit more since it has to open a new
41connection.
42
43Lastly, if there are some IPs that you want to refuse email from or some IPs
44you want to accept email from REGARDLESS of what the DNS databases say, you
45can put in overrides in the SpamFilters_DNScache[] array. See the comments
bd1927c9 46in config.php for more info on this.