add missing information about managesieve plugin
All checks were successful
/ build (push) Successful in 1m17s
All checks were successful
/ build (push) Successful in 1m17s
This commit is contained in:
parent
66990a037e
commit
5c452cb495
2 changed files with 43 additions and 8 deletions
|
|
@ -126,10 +126,18 @@ email address as the user name. E.g. `john@example.org` and password `summersun`
|
||||||
|
|
||||||
If the login fails, check `/var/log/roundcube/errors.log`.
|
If the login fails, check `/var/log/roundcube/errors.log`.
|
||||||
|
|
||||||
|
<Aside type="tip" title="Important">
|
||||||
|
|
||||||
|
Before you get overly enthusiastic: you can't send emails from Roundcube yet. We will fix that now.
|
||||||
|
|
||||||
|
</Aside>
|
||||||
|
|
||||||
## Plugins
|
## Plugins
|
||||||
|
|
||||||
Roundcube comes with various plugins that you can offer your users. I suggest that you enable at least the **password**
|
Roundcube comes with various plugins that you can offer your users. I suggest that you enable at least
|
||||||
plugin so that your users can change their access password.
|
|
||||||
|
- the **password** plugin so that your users can change their access password
|
||||||
|
- the **managesieve** plugin so that your users can create server-based filtering rules
|
||||||
|
|
||||||
Again edit the `/etc/roundcube/config.inc.php` file and look for the _plugins_ configuration. To enable the recommended
|
Again edit the `/etc/roundcube/config.inc.php` file and look for the _plugins_ configuration. To enable the recommended
|
||||||
plugins change it to:
|
plugins change it to:
|
||||||
|
|
@ -141,8 +149,11 @@ $config['plugins'] = array(
|
||||||
);
|
);
|
||||||
```
|
```
|
||||||
|
|
||||||
Plugins are configured through files located in the `/etc/roundcube/plugins` directory. Let's quickly set up the
|
Plugins are configured through files located in the `/etc/roundcube/plugins` directory.
|
||||||
password plugin:
|
|
||||||
|
### password
|
||||||
|
|
||||||
|
Let's quickly set up the password plugin:
|
||||||
|
|
||||||
```sh title="Run this on your server"
|
```sh title="Run this on your server"
|
||||||
cat > /etc/roundcube/plugins/password/config.inc.php << 'EOF'
|
cat > /etc/roundcube/plugins/password/config.inc.php << 'EOF'
|
||||||
|
|
@ -161,7 +172,7 @@ chown root:www-data /etc/roundcube/plugins/password/config.inc.php
|
||||||
chmod u=rw,g=r,o= /etc/roundcube/plugins/password/config.inc.php
|
chmod u=rw,g=r,o= /etc/roundcube/plugins/password/config.inc.php
|
||||||
```
|
```
|
||||||
|
|
||||||
Let’s briefly cover the meaning of those lines:
|
What these settings mean:
|
||||||
|
|
||||||
- `$config['password_driver'] = 'sql';`\
|
- `$config['password_driver'] = 'sql';`\
|
||||||
Use SQL as a backend.
|
Use SQL as a backend.
|
||||||
|
|
@ -191,8 +202,32 @@ Try it. Log into Roundcube as `john@example.org` with password ‘summersun’.
|
||||||
Enter a new password twice. You should get a success message at the bottom right. Now logout and login with the new
|
Enter a new password twice. You should get a success message at the bottom right. Now logout and login with the new
|
||||||
password. Does it work? Great.
|
password. Does it work? Great.
|
||||||
|
|
||||||
<Aside type="tip" title="Important">
|
### managesieve
|
||||||
|
|
||||||
Before you get overly enthusiastic: you can't send emails from Roundcube yet. We will fix that now.
|
[Sieve](<https://en.wikipedia.org/wiki/Sieve_(mail_filtering_language)>) is a simple programming language to be used for
|
||||||
|
server-side rules. Dovecot executes these rules every time a new email comes in. There are global rules that are
|
||||||
|
executed for every email. And of course every user/mailbox can have its own rules. To manage sieve rules Dovecot offers
|
||||||
|
the _managesieve_ interface that you enabled earlier. So we just need to tell Roundcube how to access it.
|
||||||
|
|
||||||
</Aside>
|
The configuration file for Roundcube’s _managesieve_ plugin is found at
|
||||||
|
`/etc/roundcube/plugins/managesieve/config.inc.php`. But the defaults are fine so you do not need to change it.
|
||||||
|
|
||||||
|
Sieve rules are stored in a special syntax on the server. This is an example that moves all incoming emails to the
|
||||||
|
_test_ folder that have “test” in the subject:
|
||||||
|
|
||||||
|
```
|
||||||
|
require ["fileinto"];
|
||||||
|
if header :contains "subject" "test"
|
||||||
|
{
|
||||||
|
fileinto "INBOX/test";
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
You do not need to learn this syntax though. Roundcube’s sieve rule editor is way more user-friendly.
|
||||||
|
|
||||||
|
Try adding a sieve rule for `john@example.org` in Roundcube. That feature is located in Settings/Filters. You will find
|
||||||
|
the machine-readable sieve code at `/var/vmail/example.org/john/sieve/roundcube.sieve`.
|
||||||
|
|
||||||
|
The rule editor looks like this:
|
||||||
|
|
||||||
|

|
||||||
|
|
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 51 KiB |
Loading…
Add table
Add a link
Reference in a new issue