3,254
edits
Changes
From SME Server
Jump to navigationJump to search→Installation
{{Languages}}
{{Languages}}
=== Version ===
===Version===
{{ #smeversion: smeserver-learn}}
{{#smeversion: smeserver-learn}}
=== Maintainer ===
===Maintainer===
[[Unnilennium|JP Pialasse]]
[[Unnilennium|JP Pialasse]]
=== Initial contributors===
===Initial contributors===
[mailto:emmanuel.jooris@firewall-services.com Jooris Emmanuel] for [http://www.firewall-services.com Firewall-services],
[mailto:emmanuel.jooris@firewall-services.com Jooris Emmanuel] for [http://www.firewall-services.com Firewall-services],
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel B.]]] from [http://www.firewall-services.com Firewall Services],
[mailto:daniel@firewall-services.com][[User:VIP-ire|Daniel B.]] from [http://www.firewall-services.com Firewall Services],
Brian Read , Tim Litwiller , Michael McCarn and Jesper Knudsen
Brian Read , Tim Litwiller , Michael McCarn and Jesper Knudsen
=== Description ===
===Description===
Scripts, based on LearnAsSpam, which allows users to interact with spamassassin rules simply by dropping mail into special folders added to their mailbox. This works only with IMAP as it is a server side process.
Scripts, based on LearnAsSpam, which allows users to interact with spamassassin rules simply by dropping mail into special folders added to their mailbox. This works only with IMAP as it is a server side process.
=== Installation ===
*Learn mail as spam
*Learn mail as ham
*Whitelist the sender so his mails won't be tagged as spam again
===Installation===
yum --enablerepo=smecontribs install smeserver-learn
yum --enablerepo=smecontribs install smeserver-learn
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes.mutex
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes.mutex
chmod 640 /var/spool/spamd/.spamassassin/bayes_*
chmod 640 /var/spool/spamd/.spamassassin/bayes_*
we then suggest you those settings, as default use medium Sensitivity
config setprop spamassassin status enabled
config setprop spamassassin status enabled
config setprop spamassassin RejectLevel 12
config setprop spamassassin RejectLevel 12
Don't forget to configure db key according to your needs and expand config file to activate the contrib.
Don't forget to configure db key according to your needs and expand config file to activate the contrib.
=== Documentation ===
===Documentation===
The smeserver-learn package stores all key values needed in the configuration db. The right angle character, >, indicates that is a prop and not a key. For example, "status" is a property and "enabled, disabled" presents the allowed input values.
The smeserver-learn package stores all key values needed in the configuration db. The right angle character, >, indicates that is a prop and not a key. For example, "status" is a property and "enabled, disabled" presents the allowed input values.
|-
|-
|>SpamLinks=$string
|>SpamLinks=$string
|Allows to create IMAP fakedfolder linked to junkmail folder. Useful for IOS client thant keep using junk folder and do not allow to set another folder. Multiple Links could be entered separated by comas ",". Default is empty ('') for disabled. More examples follow the table.
|Allows to create IMAP fakedfolder linked to junkmail folder. Useful for IOS client thant keep using junk folder and do not allow to set another folder. Multiple Links could be entered separated by comas ",". Default is empty ('') for disabled. More examples follow the table.''
|-
|-
|>DeleteAfterLearn={enabled,disabled}
|>DeleteAfterLearn={enabled,disabled}
expand-template /etc/cron.d/Learn
expand-template /etc/cron.d/Learn
=== Setup Bayesian Autolearning ===
===Setup Bayesian Autolearning===
You'll also have to setup [[Email#Bayesian_Autolearning | Bayesian Autolearning]] as described in the [[Email]] page.
You'll also have to setup [[Email#Bayesian_Autolearning | Bayesian Autolearning]] as described in the [[Email]] page.
=== Automatic creation of folders ===
===Automatic creation of folders===
this is not necessary anymore, if you keep the Uniq property enabled. For reference, the script previously here is kept in discussion.
this is not necessary anymore, if you keep the Uniq property enabled. For reference, the script previously here is kept in discussion.
=== Example of configuration ===
===Example of configuration===
I like to have my learning folder as subdir of junkmail folder. My thunderbird clients are set to use junkmail folder to put what they find to be a SPAM, but my iOS client wants to use Junk and I do not want to check myself multiple folders. My SME is set to to delete the content of junkmail after 30 days (config getprop spamassassin MessageRetentionTime), but I want that the content of junkmail folder is used to learn before deletion (15 days) leaving me time to find false positives to move them to jumkmail.not_a_spam or moving them myself to jumkmail.junkmail.learn. I keep Uniq enabled to have the IMAP folder created automatically even if users deleted them again and again. I do not want that junkmails that never were downloaded by any client be used to learn, so I keep LearnNew as disabled.
I like to have my learning folder as subdir of junkmail folder. My thunderbird clients are set to use junkmail folder to put what they find to be a SPAM, but my iOS client wants to use Junk and I do not want to check myself multiple folders. My SME is set to to delete the content of junkmail after 30 days (config getprop spamassassin MessageRetentionTime), but I want that the content of junkmail folder is used to learn before deletion (15 days) leaving me time to find false positives to move them to jumkmail.not_a_spam or moving them myself to jumkmail.junkmail.learn. I keep Uniq enabled to have the IMAP folder created automatically even if users deleted them again and again. I do not want that junkmails that never were downloaded by any client be used to learn, so I keep LearnNew as disabled.
signal-event email-update
signal-event email-update
=== Uninstall ===
===Uninstall===
Simply do :
Simply do :
yum remove smeserver-learn
yum remove smeserver-learn
=== Bugs ===
===Bugs===
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
and select the smeserver-learn component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-learn|title=this link}}.
and select the smeserver-learn component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-learn|title=this link}}.
Only released version in smecontrib are listed here.
Only released version in smecontrib are listed here.
{{ #smechangelog: smeserver-learn}}
{{#smechangelog: smeserver-learn}}
<noinclude>[[Category: Contrib]]</noinclude>
<noinclude>
<noinclude>[[Category: Mail]]</noinclude>
[[Category: Contrib]]
<noinclude>[[Category: Administration:Content Spam Virus Blocking]]</noinclude>
</noinclude>
<noinclude>
[[Category: Mail]]
</noinclude>
<noinclude>
[[Category: Administration:Content Spam Virus Blocking]]
</noinclude>
