A mail tags module for Roundcube
--------------------------------------

This plugin currently supports a few storage backends:
- "database": SQL database
- "kolab": Kolab Groupware v3 Server
- "annotate": IMAP server with METADATA and ANNOTATE-EXPERIMENT-1 support (e.g. Cyrus IMAP)


REQUIREMENTS
------------

Some functions are shared with other plugins and therefore being moved to
library plugins. Thus in order to run the kolab_tags plugin, you also need the
following plugins installed:

* kolab/libkolab [1]


INSTALLATION
------------

For a manual installation of the plugin (and its dependencies),
execute the following steps. This will set it up with the database backend
driver.

1. Get the source from git

  $ cd /tmp
  $ git clone https://git.kolab.org/diffusion/RPK/roundcubemail-plugins-kolab.git
  $ cd /<path-to-roundcube>/plugins
  $ cp -r /tmp/roundcubemail-plugins-kolab/plugins/kolab_tags .
  $ cp -r /tmp/roundcubemail-plugins-kolab/plugins/libkolab .

2. Create kolab_tags plugin configuration

  $ cd kolab_tags/
  $ cp config.inc.php.dist config.inc.php
  $ edit config.inc.php

3. Initialize the plugin database tables

  $ cd ../../
  $ bin/initdb.sh --dir=plugins/kolab_tags/drivers/database/SQL

4. Build css styles for the Elastic skin (if needed)

  $ lessc --relative-urls -x plugins/libkolab/skins/elastic/libkolab.less > plugins/libkolab/skins/elastic/libkolab.min.css

5. Enable the plugin

  $ edit config/config.inc.php

Add 'kolab_tags' to the list of active plugins:

  $config['plugins'] = [
    (...)
    'kolab_tags',
  ];


IMPORTANT
---------

This plugin doesn't work with the Classic skin of Roundcube because no
templates are available for that skin.

Use Roundcube `skins_allowed` option to limit skins available to the user
or remove incompatible skins from the skins folder.

[1] https://git.kolab.org/diffusion/RPK/
