Changes

From SME Server
Jump to navigationJump to search

Learn (view source)

Revision as of 21:22, 26 March 2017

2,964 bytes added ,  21:22, 26 March 2017
→‎Initial contributors
Line 1: Line 1:  
{{Languages}}
 
{{Languages}}
−
{{Outdated|msg=please read that forum post http://forums.contribs.org/index.php/topic,51019.msg258122.html#msg258122 }}  
+
=== Version ===
 +
{{ #smeversion: smeserver-learn}}
 
=== Maintainer ===
 
=== Maintainer ===
 
[[Unnilennium|JP Pialasse]]
 
[[Unnilennium|JP Pialasse]]
Line 7: Line 8:  
[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 in special folders of their mailbox (working only with imap).
+
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.
 
* Learn mail as spam
 
* Learn mail as spam
 
* Learn mail as ham
 
* Learn mail as ham
 
* Whitelist the sender so his mails won't be tagged as spam again
 
* Whitelist the sender so his mails won't be tagged as spam again
−
  −
      
=== Installation ===
 
=== Installation ===
   −
  yum --enablerepo=smedev,smecontribs,smetest install smeserver-learn
+
  yum --enablerepo=smecontribs install smeserver-learn
   −
enable Bayes
+
Enable Bayes. See  [[Email#Bayesian_Autolearning | Bayesian Autolearning]] as described in the [[Email]] page for a full setup. The bare minimum configuration would be:
 
  db configuration setprop spamassassin UseBayes 1
 
  db configuration setprop spamassassin UseBayes 1
 +
config setprop spamassassin BayesAutoLearnThresholdSpam 6.00
 +
config setprop spamassassin BayesAutoLearnThresholdNonspam 0.10
 +
expand-template /etc/mail/spamassassin/local.cf
 +
sa-learn --sync --dbpath /var/spool/spamd/.spamassassin -u spamd
 +
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes_*
 +
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes.mutex
 +
chmod 640 /var/spool/spamd/.spamassassin/bayes_*
 +
config setprop spamassassin status enabled
 +
config setprop spamassassin RejectLevel 12
 +
config setprop spamassassin TagLevel 4
 +
config setprop spamassassin Sensitivity custom
 
  signal-event email-update
 
  signal-event email-update
−
Don't forget to configure db key according to your needs and expand config file.
+
 
 +
Don't forget to configure db key according to your needs and expand config file to activate the contrib.
    
=== Documentation ===
 
=== Documentation ===
−
smeserver-learn store all key who need in configuration db : (the > indicate that is a prop and not a key)
+
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.
    
{|
 
{|
Line 43: Line 53:  
|-
 
|-
 
|>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.
+
|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}
Line 49: Line 59:  
|-
 
|-
 
|>DelayToMove=$integer
 
|>DelayToMove=$integer
−
|Get the content of the user's junkmail folder before it is deleted. Useful to get SPAM placed here by the mail client software, not yet learnt. Can only be activated if DeleteAfterLearnis enabled to avoid loop. Default ''0'' for disabled.
+
|Get the content of the user's junkmail folder before it is deleted. Useful to get SPAM placed here by the mail client software, not yet learnt. Can only be activated if DeleteAfterLearn is enabled to avoid loop. Default ''0'' for disabled.
 
|-
 
|-
−
|>LearnNew={enabled,disabled}
+
|>LearnNew={enabled,junkmail,disabled}
−
|Learn content of subdir of the read IMAP folder "cur"(disabled) only or also "new" (enabled- where emails are stored before any client connect to download them). Default is ''disabled''.
+
|Learn content of subdir of the read IMAP folder "cur"(disabled) only or also "new" (enabled- where emails are stored before any client connect to download them). With value junkmail this behaviour will be use only for inspecting junkmail IMAP folder. Default is ''disabled''.
 
|-
 
|-
 
|>Uniq={enabled,disabled}
 
|>Uniq={enabled,disabled}
Line 112: Line 122:  
|-
 
|-
 
|>cron={none,hourly,daily,weekly,monthly}
 
|>cron={none,hourly,daily,weekly,monthly}
−
|do the search never, hourly, daily, weekly or monthlSpamLinksy. Default is ''daily''.
+
|do the search never, hourly, daily, weekly or monthly. Default is ''daily''.
 +
|-
 +
|>Exclude=user,list,separated,by,coma
 +
|List of users without the right to use Learn. Default is empty ''""'' for disabled.
 +
|-
 +
|>Include=user,list,separated,by,coma
 +
|List of user who has the right to use Learn. Override Exclude list. If not empty, only these users will have access to Learn. Default is empty ''""'' for disabled.
 +
|-
 +
|>Verbose={enabled,disabled, active}
 +
|default is enabled. Active will only report users with activity, disabled will not report.
 
|}
 
|}
   Line 120: Line 139:     
Individual configuration is also possible for users with the SpamLinks property
 
Individual configuration is also possible for users with the SpamLinks property
−
  db accounts set MYUSER SpamLinks junks,junker
+
  db accounts setprop MYUSER SpamLinks junks,junker
    
One config file is modified : /etc/cron.d/Learn who need to be expand if prop Learn>cron is modified with the following.
 
One config file is modified : /etc/cron.d/Learn who need to be expand if prop Learn>cron is modified with the following.
 
  signal-event email-update
 
  signal-event email-update
 +
 +
also the following should be sufficient:
 +
 +
expand-template /etc/cron.d/Learn
    
=== Setup Bayesian Autolearning ===
 
=== Setup Bayesian Autolearning ===
Line 130: Line 153:  
=== 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 ===
 +
 +
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.
 +
config setprop LearnAsSpam status enabled DeleteAfterLearn enabled DelayToMove 15 SpamLinks Junk dir junkmail.junkmail_learn Uniq enabled
 +
 +
I want to be able to remove badly SPAM tag when moved to  jumkmail.not_a_spam and have them back in my inbox without any new tag.
 +
config setprop LearnAsHam status enabled dir junkmail.not_a_spam tag "" RemoveSPAMTag enabled Uniq enabled
 +
 +
Finally, I want my SME to learn every hours
 +
config setprop Learn cron hourly
 +
signal-event email-update
    
=== Uninstall ===
 
=== Uninstall ===
Line 139: Line 174:  
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}}.
 
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-learn|noresultsmessage="No open bugs found."}}
 
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-learn|noresultsmessage="No open bugs found."}}
 +
 +
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-learn}}
 +
 
<noinclude>[[Category: Contrib]]</noinclude>
 
<noinclude>[[Category: Contrib]]</noinclude>
 
<noinclude>[[Category: Mail]]</noinclude>
 
<noinclude>[[Category: Mail]]</noinclude>
 
<noinclude>[[Category: Administration:Content Spam Virus Blocking]]</noinclude>
 
<noinclude>[[Category: Administration:Content Spam Virus Blocking]]</noinclude>
Gieres
3,054

edits

Retrieved from "https://wiki.koozali.org/Special:MobileDiff/30522...33021"

Navigation menu