ROUNDCUBE PLUS FRAMEWORK PLUGIN
===============================

This plugin provides a common framework for all the Roundcube Plus plugins.

REQUIREMENTS
------------
- Roundcube: 1.5, 1.6
- PHP: 7.4 or higher
- PHP Extensions: bcmath (for Geo IP to country functions)

INSTALLATION
------------
This plugin does not need to be installed. It simply needs to be present in the <roundcube>/plugins directory.
Don't add this plugin to the plugins array in the Roundcube config file.

COMPATIBILITY
-------------
This plugin 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 a non-standard version of Roundcube.

CONFIGURATION
-------------
This plugin does not have its own configuration file. But it offers some configuration options that can be added to
the main Roundcube config file: <roundcube>/config/config.inc.php.

**** LICENSE KEY (REQUIRED)

This option is required for the plugins and skins to function. The license key can be obtained from the customer area
of the website where you purchased the skins or plugins. Add the license key to the config file this way:

$config['license_key'] = 'your_license_key';

**** SHOW/HIDE SIDEBAR

Some Roundcube Plus plugins (for example, xcalendar, xlast_login, xnews_feed) add content to the sidebar that appears on
the left side of the screen. The sidebar will be visible by default; if you want to change this behavior and hide the
sidebar to begin with, add this to the config file:

$config['xsidebar_visible'] = false;

**** COLLAPSE/EXPAND SIDEBAR ITEMS

By default, all the items in the sidebar are expanded. If you want to change this default and collapse some items
to begin with, use this config option:

$config['xsidebar_collapsed'] = array('xcalendar', 'xquote');

In the example above, the items added by the calendar and the quote plugins will be collapsed while all the other items
will be expanded.

**** REORDER SIDEBAR

The items are added to the sidebar following the order in which the plugins are added to the plugins array. If you want
to change the default order of the sidebar items, change the order of the plugins in the plugins array.

**** ADD TO APPS MENU

Using this setting you can add your own, personalized items to the Apps menu. The items should be in the format:

url => array(title, image)

For example:

$config['add_to_apps_menu'] = array(
    "?_task=your_plugin" => array("title" => "Your plugin", "image" => "http://path_to_image.png"),
);

**** REMOVE FROM APPS MENU

Using this setting you can remove items from the Apps menu. Reference the items by their url, for example:

$config['remove_from_apps_menu'] = array(
    '?_task=settings&_action=preferences&_section=xcalendar',
);

**** DISABLE APPS MENU

If you'd like to remove the Apps button from the Roundcube header menu, use this setting:

$config['disable_apps_menu'] = true;

**** REMOVE VENDOR BRANDING

If you'd like to remove the Roundcube Plus branding from the login screen, add this to the config file:

$config['remove_vendor_branding'] = true;

**** CHANGE $_SERVER['REMOTE_ADDR']

If the user IP on your server is not stored under $_SERVER['REMOTE_ADDR'], you can use this setting to tell the
xframework plugin which $_SERVER variable to retrieve it from. For example:

$config['remote_addr_key'] = 'HTTP_CLIENT_IP';

In this case, the plugin will retrieve the user IP from $_SERVER['HTTP_CLIENT_IP'].

The user IP is used by some plugins that rely on xframework, for example xlast_login.

**** OVERWRITE ROUNDCUBE URL

The Roundcube Plus plugins use the variables from the $_SERVER array to construct the URL through which Roundcube can be
accessed. In some cases, the $_SERVER variables don't provide the right values and the constructed URL is incorrect.
If this is true in your case, you can bypass the xframework functions that construct the URL from the $_SERVER variables
and specify the Roundcube URL directly using this setting:

$config['overwrite_roundcube_url'] = "https://my-roundcube-is-here.com";

ATTRIBUTION
-----------
This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.

LICENSE
-------
This plugin is distributed under a commercial license. In order to use the plugin, you must purchase the license
from Tecorama LLC. See the LICENSE file for details.

COPYRIGHT
---------
Copyright (c) 2024, Tecorama LLC