= Configure User specific Filters for MPE's Mail Services =

Each user has the opportunity to preprocess his incoming mail stream by a filter. Usual applications are: 

 * storing or dropping tagged Spam messages depending on the score
 * putting mails from certain senders or with special subjects in different folders as inbox
 
== Calling the Filter Editor ==

Login to [[https://mail.mpe.mpg.de/tpl|MPE mail user interface https://mail.mpe.mpg.de/tpl]] and choose menu 'Edit Filter'


 * when clicking the 'save' button a syntax check is performed. If no errors where found, the new filter rules are installed
 * use the 'default' button to reload the MPE default filter setup
 * use the 'back' button to go back to the main menu
 

==  the standard filter as a example ==

The standard filter contents is copied automatically to a new user's environment. Take this contents as a template to construct your personal filter. Feel free to comment or uncomment the following lines in order to enable/disable functionalities.


#Exim filter<<BR>>
#<<BR>>
#if $header_from: contains "myimportantfromaddress" then<<BR>>
#save /home/virtual_mail/$local_part/<<BR>>
#finish<<BR>>
#endif<<BR>>
## drop all mails with spam-level >=8[[BR]]
#if $h_x-spam-level: begins "********" then<<BR>>
#seen finish<<BR>>
#endif<<BR>>
#<<BR>>
## move all mails with spam-level >=4 to .Spam[[BR]]
if $h_x-spam-level: begins "****" then <<BR>>
save /home/virtual_mail/$local_part/.Spam/<<BR>>
endif<<BR>>
#<<BR>>
## drop all mails from virusalert@rzg.mpg.de[[BR]]
#if $h_from: contains "virusalert@rzg.mpg.de" then<<BR>>
#seen finish<<BR>>
#endif<<BR>>

Please note that the first line has to begin with a '#Exim filter' line. The filter is executed sequential from up to down.

 1 the first '''commented''' block allows to tunnel certain from-addresses direct to your inbox without scanning for spams

 2 the second '''commented''' block allows to drop Spams with a certain level

 3 the third '''active''' block stores all spams from 4 * and more in special Folder 'Spam'

 4 the forth '''commented''' block allows to drop Mails with a certain from-Address







== variables ==
 * '''$header_from''' the sender address
 * '''$header_subject''' the sender subject
 * '''$sender_address''' the sender address that was received in the envelope of the message
 * '''$reply_address''' the contents of the Reply-to: header, if the message has one; otherwise the contents of the From: header.
 * '''$return_path''' the return path – that is, the sender field that will be transmitted as part of the message’s envelope if the message is sent to another host. 
== commands ==

 || save /home/virtual_mail/$local_part/ || '''store email in your inbox'''||
 || save /home/virtual_mail/$local_part/.xxx (note the dot preceding the foldername; folders are created automatically if not available) || '''store email in folder xxx''' ||
 || finish || '''drop email and stop mail processing''' ||

<<BR>>


further information for writing filters can be found in the [[http://www.exim.org/exim-html-current/doc/html/filter.html|exim filter specs]]