<docbook><section><title>OdsMailSpamFilterGuide</title><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">ODS WebMail Spam Filter Guide</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3">What is it?</bridgehead>
 ODS WebMail offers the feature for Spam Filtering so to control which mails you can receive in our WebMail inbox and which mails to go to your WebMail Spam folder.<bridgehead class="http://www.w3.org/1999/xhtml:h3">Requirements</bridgehead>
<para>In order the Spam Filter option in ODS WebMail  to work properly you need to:</para>
<orderedlist spacing="compact"><listitem>Install the ODS Framework ods_framework_dav.vad package </listitem>
<listitem>Install the ODS AddressBook ods_addressbook_dav.vad package </listitem>
<listitem>Install the ODS WebMail ods_webmail_dav.vad package version 1.3.93 or higher.
<orderedlist spacing="compact"><listitem>Make sure you have executed all steps from the <ulink url="OdsMailInstallGuide">Mail Installation Guide</ulink> in order to be configured correctly the settings for receiving mail messages in your ODS dataspace.
<itemizedlist mark="bullet" spacing="compact"><listitem>For example.
 let&#39;s say it is configured for domain with name &quot;example.com&quot;.</listitem>
</itemizedlist></listitem>
</orderedlist></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Properties</bridgehead>
<para>The Spam properties are set in Preferences page.
 The properties are: </para>
<orderedlist spacing="compact"><listitem>General Options (What is treated for Spam) <itemizedlist mark="bullet" spacing="compact"><listitem> <emphasis>Trust junk mail headers set by</emphasis> will automatically recognize mail that is marked by a separate junk mail filtering program.
 Very often ISP or mail server will install such a filtering program, which adds special headers to your email before it is retrieved by ODS <ulink url="WebMail">WebMail</ulink>.
 Currently supported are: <ulink url="SpamAssassin">SpamAssassin</ulink> and <ulink url="SpamPal">SpamPal</ulink>.
</listitem>
<listitem> <emphasis>Do not mark messages as junk mail if the sender is in my address book</emphasis> prevents messages from being automatically marked as junk mail if the sender is listed in the user&#39;s <ulink url="AddressBook">AddressBook</ulink> instances.
 The user can also set the scope of allowed mails to be the contacts of his contacts.
 This respectively goes with depth 1, 2, etc.
</listitem>
</itemizedlist></listitem>
<listitem>Handling (Determines what to do with junk mail when it is received) <itemizedlist mark="bullet" spacing="compact"><listitem>When messages are determined to be Spam <itemizedlist mark="bullet" spacing="compact"><listitem>Move them to the Spam folder (move incoming messages determined to be junk mail to will automatically place junk mail into the specified folder upon arrival); </listitem>
<listitem>Delete them.
</listitem>
</itemizedlist></listitem>
<listitem>Mark messages determined to be Spam as read; </listitem>
<listitem>Automatically delete spam messages older then N	days (0 - no delete);</listitem>
</itemizedlist></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Simple example</bridgehead>
<orderedlist spacing="compact"><listitem>Go to http://[host]:[port]/ods and register an user, for ex.
 test1.
<orderedlist spacing="compact"><listitem>Create a WebMail instance for user test1, so to have for example mail value: <ulink url="test1@example.com">test1@example.com</ulink>.
</listitem>
<listitem>Go to the WebMail instance UI and then click the &quot;References&quot; link.
</listitem>
<listitem>For the drop-down list with label &quot;Spam Filter&quot; change the value from &quot;Disabled&quot; to &quot;My contacts only&quot;.
</listitem>
<listitem>Click the button &quot;Save&quot;.
<figure><graphic fileref="OdsMailSpamFilterGuide/ab0.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Logout as user test1 and create user test2.
<orderedlist spacing="compact"><listitem>Create a WebMail instance for user test2, so to have for example mail value: <ulink url="test2@example.com">test2@example.com</ulink>.
</listitem>
</orderedlist></listitem>
<listitem>Logout as user test2 and create user test3 <orderedlist spacing="compact"><listitem>Create a WebMail instance for user test3, so to have for example mail value: <ulink url="test3@example.com">test3@example.com</ulink>.
</listitem>
</orderedlist></listitem>
<listitem>Logout as user test3 and login as user test1.
<orderedlist spacing="compact"><listitem>Create an AddressBook instance for user test1.
</listitem>
<listitem>From the AddressBook instance UI click the button &quot;New Contact&quot; <orderedlist spacing="compact"><listitem>Now leave the type to be with value &quot;Person&quot; and enter in the &quot;Home&quot; tab for name the value: John </listitem>
<listitem>Go to tab &quot;Contact&quot; tab, </listitem>
<listitem>Enter in the field &quot;Mail&quot; the value: <ulink url="test2@example.com">test2@example.com</ulink> <itemizedlist mark="bullet" spacing="compact"><listitem>Note: this is a valid e-mail address of the ODS user test2.
</listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Save&quot; </listitem>
</orderedlist></listitem>
<listitem>From the AddressBook instance UI click the button &quot;New Contact&quot; <orderedlist spacing="compact"><listitem>Now change the type value to &quot;Organization&quot; and enter in the &quot;Home&quot; tab for name the value: Kate&amp;Co.
</listitem>
<listitem>Go to tab &quot;Business&quot; tab, </listitem>
<listitem>Enter in the field &quot;Mail&quot; the value: <ulink url="test3@example.com">test3@example.com</ulink> <itemizedlist mark="bullet" spacing="compact"><listitem>Note: this is a valid e-mail address of the ODS user test3.
</listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Save&quot; <figure><graphic fileref="OdsMailSpamFilterGuide/ab1.png" /></figure> </listitem>
</orderedlist></listitem>
</orderedlist></listitem>
<listitem>Now logout and login as user test2 (or user test3).
<orderedlist spacing="compact"><listitem>Go to user test2&#39;s WebMail instance <orderedlist spacing="compact"><listitem>Click the button &quot;Write message&quot;.
</listitem>
<listitem>In the shown form enter: <orderedlist spacing="compact"><listitem>for field &quot;To&quot;: <ulink url="test1@example.com">test1@example.com</ulink> </listitem>
<listitem>for field &quot;Subject&quot;: simple test </listitem>
<listitem>for field &quot;Comma separated tags&quot;: test </listitem>
<listitem>for field &quot;message&quot;: This is simple test.
<figure><graphic fileref="OdsMailSpamFilterGuide/ab2.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Click the &quot;send message&quot; button </listitem>
<listitem>As result should be shown the message: <programlisting>The message has been sent successfully to: test1@example.com   
</programlisting></listitem>
</orderedlist></listitem>
</orderedlist></listitem>
<listitem>Now logout and login as user test1.
<orderedlist spacing="compact"><listitem>Go to user test1 WebMail instance.
</listitem>
<listitem>As result in the Inbox there will be received one 1 mail message from <ulink url="test@example.com">test@example.com</ulink>.
<figure><graphic fileref="OdsMailSpamFilterGuide/ab3.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Now let&#39;s see what will happen where user test1 receives mail from a sender, which is not in his contact list.
 Logout as test1 and register in ODS user test4.
<orderedlist spacing="compact"><listitem>Create a WebMail instance for user test4, so to have for example mail value: <ulink url="test4@example.com">test4@example.com</ulink>.
</listitem>
<listitem>Go to user test4&#39;s WebMail instance.
<orderedlist spacing="compact"><listitem>Click the button &quot;Write message&quot;.
</listitem>
<listitem>In the shown form enter: <orderedlist spacing="compact"><listitem>for field &quot;To&quot;: <ulink url="test2@example.com">test2@example.com</ulink> </listitem>
<listitem>for field &quot;Subject&quot;: new test </listitem>
<listitem>for field &quot;Comma separated tags&quot;: test </listitem>
<listitem>for field &quot;message&quot;: This is new test.
<figure><graphic fileref="OdsMailSpamFilterGuide/ab4.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Click the &quot;send message&quot; button </listitem>
</orderedlist></listitem>
<listitem>As result should be shown the message: <programlisting>The message has been sent successfully to: test1@example.com   
</programlisting></listitem>
</orderedlist></listitem>
<listitem>Now logout and login as user test1.
<orderedlist spacing="compact"><listitem>Go to user test1 WebMail instance.
</listitem>
<listitem>As result in the Spam folder there will be one message received from sender with mail <ulink url="test4@example.com">test4@example.com</ulink>: <figure><graphic fileref="OdsMailSpamFilterGuide/ab5.png" /></figure></listitem>
</orderedlist></listitem>
</orderedlist><para><ulink url="CategoryMail">CategoryMail</ulink> <ulink url="CategoryODS">CategoryODS</ulink> <ulink url="CategoryOpenSource">CategoryOpenSource</ulink> <ulink url="CategoryHowTo">CategoryHowTo</ulink> <ulink url="CategoryOdsMail">CategoryOdsMail</ulink> <ulink url="CategoryWebSite">CategoryWebSite</ulink></para>
<para> </para>
</section></docbook>