Update en_US/howto/sql.user.mail.forwarding.md with new sql structure in iRedMail-0.9.7.

en_US/howto/0-sql.user.mail.forwarding-20170701.md

@@ -0,0 +1,47 @@
+# SQL: User mail forwarding
+
+[TOC]
+
+!!! attention
+
+    * This document is applicable to iRedMail-0.9.6 and earlier releases.
+    * Here's [doc for iRedMail-0.9.7 and later releases](./sql.user.mail.forwarding.html).
+
+## Set mail forwarding with iRedAdmin-Pro
+
+With iRedAdmin-Pro, you can manage mail forwarding addresses in user
+profile page, under tab `Forwarding`.
+
+Screenshot:
+
+![](../images/iredadmin/user_profile_mail_forwarding.png){: width=1000px }
+
+## Set mail forwarding with SQL command line
+
+Let's say you have an existing mail user `user@domain.com`, and you want to
+forward all received emails to another address `forward@example.com`,
+to achieve this, you can login to SQL server and update `vmail` database like
+below:
+
+```
+sql> USE vmail;
+sql> UPDATE alias SET goto='forward@example.com' WHERE address='user@domain.com';
+```
+
+If you want to forward email to multiple destinations, please separate
+addresses with comma like below:
+
+```
+sql> UPDATE alias SET goto='forward_1@example.com,forward_2@example.com,forward_3@example.com' WHERE address='user@domain.com';
+```
+
+To save a copy of forwarded email in mailbox, please add your own email address
+as a forwarding destination like below:
+
+```
+sql> UPDATE alias SET goto='user@domain.com,forward_1@example.com' WHERE address='user@domain.com';
+```
+
+## Related tutorial
+
+* [LDAP: user mail forwarding](./ldap.user.mail.forwarding.html)

en_US/howto/sql.user.mail.forwarding.md

@@ -2,6 +2,11 @@
 
 [TOC]
 
+!!! attention
+
+    * This document is applicable to iRedMail-0.9.7 and later releases.
+    * Here's [doc for iRedMail-0.9.6 and earlier releases](./sql.user.mail.forwarding-20170701.html).
+
 ## Set mail forwarding with iRedAdmin-Pro
 
 With iRedAdmin-Pro, you can manage mail forwarding addresses in user
@@ -13,28 +18,54 @@ Screenshot:
 
 ## Set mail forwarding with SQL command line
 
-Let's say you have an existing mail user `user@domain.com`, and you want to
+Let's say you have an __existing__ mail user `user@domain.com`, and you want to
 forward all received emails to another address `forward@example.com`,
 to achieve this, you can login to SQL server and update `vmail` database like
 below:
 
 ```
-sql> USE vmail;
-sql> UPDATE alias SET goto='forward@example.com' WHERE address='user@domain.com';
+USE vmail;
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
 ```
 
-If you want to forward email to multiple destinations, please separate
-addresses with comma like below:
+If you want to forward email to multiple addresses, please create more records
+like above:
 
 ```
-sql> UPDATE alias SET goto='forward_1@example.com,forward_2@example.com,forward_3@example.com' WHERE address='user@domain.com';
+USE vmail;
+
+-- Forwarding to address 'forward-2@example.com'
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward-2@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
+
+-- Forwarding to address 'forward-3@example.com'
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward-3@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
 ```
 
 To save a copy of forwarded email in mailbox, please add your own email address
 as a forwarding destination like below:
 
 ```
-sql> UPDATE alias SET goto='user@domain.com,forward_1@example.com' WHERE address='user@domain.com';
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'user@domain.com',
+                         'domain.com', 'domain.com',
+                         1, 1);
 ```
 
 ## Related tutorial

html/sql.user.mail.forwarding-20170701.html

@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        <title>SQL: User mail forwarding</title>
+        <link rel="stylesheet" type="text/css" href="./css/markdown.css" />
+    </head>
+    <body>
+    
+    <div id="navigation">
+    <a href="/index.html" target="_blank">
+        <img alt="iRedMail web site"
+             src="./images/logo-iredmail.png"
+             style="vertical-align: middle; height: 30px;"
+             />&nbsp;
+        <span>iRedMail</span>
+    </a>
+    &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="sql-user-mail-forwarding">SQL: User mail forwarding</h1>
+<div class="toc">
+<ul>
+<li><a href="#sql-user-mail-forwarding">SQL: User mail forwarding</a><ul>
+<li><a href="#set-mail-forwarding-with-iredadmin-pro">Set mail forwarding with iRedAdmin-Pro</a></li>
+<li><a href="#set-mail-forwarding-with-sql-command-line">Set mail forwarding with SQL command line</a></li>
+<li><a href="#related-tutorial">Related tutorial</a></li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="admonition attention">
+<p class="admonition-title">Attention</p>
+<ul>
+<li>This document is applicable to iRedMail-0.9.6 and earlier releases.</li>
+<li>Here's <a href="./sql.user.mail.forwarding.html">doc for iRedMail-0.9.7 and later releases</a>.</li>
+</ul>
+</div>
+<h2 id="set-mail-forwarding-with-iredadmin-pro">Set mail forwarding with iRedAdmin-Pro</h2>
+<p>With iRedAdmin-Pro, you can manage mail forwarding addresses in user
+profile page, under tab <code>Forwarding</code>.</p>
+<p>Screenshot:</p>
+<p><img alt="" src="../images/iredadmin/user_profile_mail_forwarding.png" width="1000px" /></p>
+<h2 id="set-mail-forwarding-with-sql-command-line">Set mail forwarding with SQL command line</h2>
+<p>Let's say you have an existing mail user <code>user@domain.com</code>, and you want to
+forward all received emails to another address <code>forward@example.com</code>,
+to achieve this, you can login to SQL server and update <code>vmail</code> database like
+below:</p>
+<pre><code>sql&gt; USE vmail;
+sql&gt; UPDATE alias SET goto='forward@example.com' WHERE address='user@domain.com';
+</code></pre>
+
+<p>If you want to forward email to multiple destinations, please separate
+addresses with comma like below:</p>
+<pre><code>sql&gt; UPDATE alias SET goto='forward_1@example.com,forward_2@example.com,forward_3@example.com' WHERE address='user@domain.com';
+</code></pre>
+
+<p>To save a copy of forwarded email in mailbox, please add your own email address
+as a forwarding destination like below:</p>
+<pre><code>sql&gt; UPDATE alias SET goto='user@domain.com,forward_1@example.com' WHERE address='user@domain.com';
+</code></pre>
+
+<h2 id="related-tutorial">Related tutorial</h2>
+<ul>
+<li><a href="./ldap.user.mail.forwarding.html">LDAP: user mail forwarding</a></li>
+</ul><div class="footer">
+    <p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">download the latest version</a> for offline reading. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
+</div>
+<script type="text/javascript">
+  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+  ga('create', 'UA-3293801-21', 'auto');
+  ga('send', 'pageview');
+</script>
+</body></html>

html/sql.user.mail.forwarding.html

@@ -26,28 +26,61 @@
 </li>
 </ul>
 </div>
+<div class="admonition attention">
+<p class="admonition-title">Attention</p>
+<ul>
+<li>This document is applicable to iRedMail-0.9.7 and later releases.</li>
+<li>Here's <a href="./sql.user.mail.forwarding-20170701.html">doc for iRedMail-0.9.6 and earlier releases</a>.</li>
+</ul>
+</div>
 <h2 id="set-mail-forwarding-with-iredadmin-pro">Set mail forwarding with iRedAdmin-Pro</h2>
 <p>With iRedAdmin-Pro, you can manage mail forwarding addresses in user
 profile page, under tab <code>Forwarding</code>.</p>
 <p>Screenshot:</p>
 <p><img alt="" src="../images/iredadmin/user_profile_mail_forwarding.png" width="1000px" /></p>
 <h2 id="set-mail-forwarding-with-sql-command-line">Set mail forwarding with SQL command line</h2>
-<p>Let's say you have an existing mail user <code>user@domain.com</code>, and you want to
+<p>Let's say you have an <strong>existing</strong> mail user <code>user@domain.com</code>, and you want to
 forward all received emails to another address <code>forward@example.com</code>,
 to achieve this, you can login to SQL server and update <code>vmail</code> database like
 below:</p>
-<pre><code>sql&gt; USE vmail;
-sql&gt; UPDATE alias SET goto='forward@example.com' WHERE address='user@domain.com';
+<pre><code>USE vmail;
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
 </code></pre>
 
-<p>If you want to forward email to multiple destinations, please separate
-addresses with comma like below:</p>
-<pre><code>sql&gt; UPDATE alias SET goto='forward_1@example.com,forward_2@example.com,forward_3@example.com' WHERE address='user@domain.com';
+<p>If you want to forward email to multiple addresses, please create more records
+like above:</p>
+<pre><code>USE vmail;
+
+-- Forwarding to address 'forward-2@example.com'
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward-2@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
+
+-- Forwarding to address 'forward-3@example.com'
+INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'forward-3@example.com',
+                         'domain.com', 'example.com',
+                         1, 1);
 </code></pre>
 
 <p>To save a copy of forwarded email in mailbox, please add your own email address
 as a forwarding destination like below:</p>
-<pre><code>sql&gt; UPDATE alias SET goto='user@domain.com,forward_1@example.com' WHERE address='user@domain.com';
+<pre><code>INSERT INTO forwardings (address, forwarding,
+                         domain, dest_domain,
+                         is_forwarding, active)
+                 VALUES ('user@domain.com', 'user@domain.com',
+                         'domain.com', 'domain.com',
+                         1, 1);
 </code></pre>
 
 <h2 id="related-tutorial">Related tutorial</h2>