ROUNDCUBE PLUS SKINS AND PLUGINS
================================

Roundcube Plus skins and plugins improve the looks and enhance the functionality of the Roundcube program.

REQUIREMENTS
------------
- Roundcube: 1.5, 1.6
- PHP: 7.4 or higher

INSTALLING SKINS
----------------
1. Copy the skins that you want to use from the 'skins' directory included in this package to the 'skins' directory of your Roundcube
installation.

IMPORTANT: If you're running Roundcube 1.6 and you want to use any of the Larry-based skins (Alpha, Droid, iCloud, Litecube, Outlook, W21)
you have to install the legacy Larry skin. Larry is a skin created by the Roundcube Team that used to be included by default in the older
versions of Roundcube but was removed in Roundcube 1.6. To install Larry follow these steps:

a) Download Larry from here: https://roundcubeplus.com/free_downloads/larry.tar.gz
b) Copy the directory 'larry' from the downloaded archive to the 'skins' directory of your Roundcube installation.

If you'll only be using the newer, Elastic-based skins (Outlook+, Droid+, Gmail+) you don't need install Larry. You also don't need to
install Larry if you're running Roundcube 1.4 or 1.5 because it's already included.

If you must install Larry but want to hide it from the users, set the 'skins_allowed' option in your main Roundcube config file.

2. Copy the plugins 'xskin' and 'xframework' from the 'plugins' directory included in this package to the 'plugins' directory of your
Roundcube installation. Follow the instructions found in plugins/xskin/README for installing and configuring the xskin plugin. As explained
there, you'll need to edit the Roundcube config file to add 'xskin' to the plugins array and specify your license key. There are no special
steps needed to install xframework: it needs to be present in the 'plugins' directory but it doesn't need to be added to the plugins array.

3. If you'd like to use one of the newly installed skins on the Roundcube login screen and as the default skin for the newly created user
accounts, edit the file config/config.inc.php, find the option $config['skin'] and set it to the name of the skin you want to use. If the
option doesn't exist, add it at the end of the file, like this:

$config['skin'] = 'outlook_plus';

4. Each skin has its own config file that you can edit and configure. The files are located in the skin directories:

skins/[skin]/config.inc.php.

If the config file doesn't exist, rename skins/[skin]/config.inc.php.sample to skins/[skin]/config.inc.php.

INSTALLING PLUGINS
------------------
The general instructions on installing Roundcube Plus plugins can be found here:

https://roundcubeplus.com/helpdesk/knowledgebase.php?article=29

However, each plugin and skin includes a README file with its own set of installation instructions. You should follow the installation steps
in the README files as they might include some customized steps not covered in the helpdesk article mentioned above.

In short, the steps for plugin installation are as follows:

1. Copy the plugins that you want to use from the 'plugins' directory included in this package to the 'plugins' directory of your Roundcube
installation.

2. Edit the file config/config.inc.php and add the plugins that you want to use to the $config['plugins'] array.

3. Read the README file included with each plugin to check if any additional setup requirements are needed and to configure the plugin's
config files.

4. Add the licence key to the file config/config.inc.php.

COMPATIBILITY
-------------
This skin has been created for the standard version of Roundcube as provided on the Roundcube website: https://roundcube.net. It might not
work properly with customized versions of Roundcube including the version provided as part of the Kolab system. Please note that we cannot
provide any technical support for the plugin deployed on non-standard versions of Roundcube.

LICENSE
-------
The Roundcube Plus skins and plugins are covered by a commercial license agreement (see the file LICENSE for details). In order to use the
skins and plugins you must purchase a license from Tecorama (https://roundcubeplus.com).

COPYRIGHT
---------
Copyright (c) 2011-2025, Tecorama LLC (https://roundcubeplus.com)
