From: Dietmar Maurer <dietmar@proxmox.com>
Date: Tue, 9 Jan 2018 08:04:25 +0000 (+0100)
Subject: pmg-mail-filter.adoc: start mail filter setup docu
X-Git-Url: https://git.proxmox.com/?a=commitdiff_plain;h=62e86eb6e254664f852aec7ec2e9f06fc7cdc398;p=pmg-docs.git

pmg-mail-filter.adoc: start mail filter setup docu
---

diff --git a/images/screenshot/pmg-gui-mail-filter-rules.png b/images/screenshot/pmg-gui-mail-filter-rules.png
new file mode 100644
index 0000000..6d0cf8c
Binary files /dev/null and b/images/screenshot/pmg-gui-mail-filter-rules.png differ
diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc
index a72fca1..feeb526 100644
--- a/pmg-admin-guide.adoc
+++ b/pmg-admin-guide.adoc
@@ -27,6 +27,8 @@ include::pmg-installation.adoc[]
 
 include::pmgconfig.adoc[]
 
+include::pmg-mail-filter.adoc[]
+
 include::pmgbackup.adoc[]
 
 
diff --git a/pmg-intro.adoc b/pmg-intro.adoc
index f9ed17c..2bf8226 100644
--- a/pmg-intro.adoc
+++ b/pmg-intro.adoc
@@ -128,10 +128,6 @@ domains. It’s an easy but very powerful way to define filter rules by
 user, domains, time frame, content type and resulting action. {pmg}
 offers a lot of powerful objects to configure your own custom system.
 
-ACTIONS - objects::
-
-Defines the final actions.
-
 WHO - objects::
 
 Who is the sender or receiver of the e-mail?
@@ -144,6 +140,10 @@ WHEN - objects::
 
 When is the e-mail received by {pmg}?
 
+ACTIONS - objects::
+
+Defines the final actions.
+
 Every rule has five categories FROM, TO, WHEN, WHAT and ACTION. Every
 of these categories can contain several objects and a direction (in,
 out or both).
diff --git a/pmg-mail-filter.adoc b/pmg-mail-filter.adoc
new file mode 100644
index 0000000..ebb9f66
--- /dev/null
+++ b/pmg-mail-filter.adoc
@@ -0,0 +1,45 @@
+Mail Filter
+===========
+
+{pmg} ships with a highly configurable mail filter. It’s an easy but
+powerful way to define filter rules by user, domains, time frame,
+content type and resulting action.
+
+image::images/screenshot/pmg-gui-mail-filter-rules.png[]
+
+
+Filter rules are composed of object
+to match certain criteria:
+
+WHO - objects::
+
+Who is the sender or receiver of the e-mail? Thos object can be used
+for the 'TO' and/or 'FROM' category.
++
+====
+Example: EMail-object - Who is the sender or receiver of the e-mail?
+====
+
+WHAT - objects::
+
+What is in the e-mail?
++
+====
+Example: Does the e-mail contain spam? 
+====
+
+WHEN - objects::
+
+When is the e-mail received by {pmg}?
++
+====
+Example: Office Hours - Mail is received between 8:00 and 16:00.
+====
+
+ACTIONS - objects::
+
+Defines the final actions.
++
+====
+Example: Mark e-mail with “SPAM:” in the subject.
+====