claws-mail/src/plugins/spamassassin
Colin Leroy 8942ef06ae 2006-08-27 [colin] 2.4.0cvs97
* src/msgcache.c
		Disable mmaped caches - huge metadata loss
		here after a power failure.
	* src/summaryview.c
		Add quicksearch timing
	* src/common/plugin.c
	* src/common/plugin.h
		Implement an interface to tell what plugins
		provide. Prevent loading of similar plugins.
	* src/plugins/clamav/clamav_plugin.c
	* src/plugins/demo/demo.c
	* src/plugins/dillo_viewer/dillo_viewer.c
	* src/plugins/pgpcore/plugin.c
	* src/plugins/pgpinline/pgpinline.c
	* src/plugins/pgpmime/pgpmime.c
	* src/plugins/spamassassin/spamassassin.c
	* src/plugins/trayicon/trayicon.c
		Implement plugin_provides()
2006-08-27 09:48:26 +00:00
..
.cvsignore 2005-07-05 [colin] 1.9.12cvs20 2005-07-05 16:53:12 +00:00
libspamc.c 2005-10-26 [wwp] 1.9.15cvs114 2005-10-26 22:24:12 +00:00
libspamc.h 2004-09-23 [colin] 0.9.12cvs103.1 2004-09-23 12:51:33 +00:00
Makefile.am 2006-03-05 [paul] 2.0.0cvs110 2006-03-05 10:04:40 +00:00
README 2006-03-04 [wwp] 2.0.0cvs107 2006-03-04 09:29:57 +00:00
spamassassin.c 2006-08-27 [colin] 2.4.0cvs97 2006-08-27 09:48:26 +00:00
spamassassin.h 2006-03-10 [colin] 2.0.0cvs130 2006-03-10 18:33:24 +00:00
spamassassin_gtk.c 2006-06-03 [colin] 2.2.0cvs78 2006-06-03 10:06:28 +00:00
spamassassin_gtk.deps 2005-07-14 [colin] 1.9.12cvs51 2005-07-14 13:37:35 +00:00
utils.c 2004-09-23 [colin] 0.9.12cvs103.1 2004-09-23 12:51:33 +00:00
utils.h 2004-09-23 [colin] 0.9.12cvs103.1 2004-09-23 12:51:33 +00:00

SpamAssassin Plugin
-------------------

This plugin will filter incoming messages using SpamAssassin. Like the
spamc command from the SpamAssassin package, the message is sent to a
spamd server that decides if the message is spam or not. Filtering of
spam at incorporation time can be turned off.

The plugin also provides the ability to teach spamd to recognize spam and ham,
using the external command sa-learn in local modes or spamc in TCP mode
(this one requires SpamAssassin >=3.1.x). A toolbar button for marking
messages as spam or ham can be added to the main window or the message
window (see "Configuration/Preferences/Customize toolbars).

To build the plugin run configure with --enable-spamassassin-plugin.

Message that are classified as spam can be deleted or moved to a folder
that can be specified in the configuration, if the folder is not
specified or not found the default trash folder will be used.

Plugin preferences can be found under "Configuration/Preferences/Plugins
/SpamAssassin". 

The SpamAssassin plugin uses it's own block in the sylpheedrc file in your
~/.sylpheed-claws/ directory, and define the following options:

[SpamAssassin]
transport=0				transport type (to reach spamd)
					0 is to disable all features
					1 is using a local spamd
					2 is using a TCP connection
					3 is using a Unix socket
					[default: 0]

hostname=localhost			hostname of the spamd server
					[default: localhost]

port=783				port the spamd server uses
					[default: 783]

timeout=30				max time (in seconds) a transaction with spamd
					should last
					[default: 30]

max_size=250				maximum size a mail can have (in kB)
					larger mails will not be filtered
					[default: 250]

process_emails=1			enable to filter incoming emails (POP, IMAP, local)
					[default: 1]

receive_spam=1				enable to save spam to a mailfolder
					if not enabled the mails will be deleted,
					please note that this is dangerout and you
					might lose an important mail that is
					classified as spam by mistake
					[default: 1]

save_folder=#mh/Mail/trash/Spam		the folder that should be used to save
					spam mails, if empty the default trash
					folder is used
					[default: none, use default trash]

username=<empty>			user the spamd server have to use
					[default: user name of the current user]

libspamc.[ch] and utils.[ch] are files from the SpamAssassin distribution.
The copyright holders and license information can be found inside the files.
The SpamAssassin distribution can be downloaded from http://spamassassin.apache.org/.