ROUNDCUBE PLUS ADVERT PLUGIN
============================

This plugin makes it possible to display ads on the left, right or bottom part of the Roundcube mail page.

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

INSTALLATION
------------
1. Copy the directories xadvert and xframework included in this package to the 'plugins' directory of your Roundcube
   installation.

2. Rename the file <roundcube>/plugins/xadvert/config.inc.php.dist to config.inc.php.

3. Edit the file <roundcube>/plugins/xadvert/config.inc.php and configure the plugin according to your needs.

4. Edit the file <roundcube>/config/config.inc.php, add xadvert to the plugins array and specify your license key.

For more information on installing Roundcube Plus plugins see:
https://roundcubeplus.com/helpdesk/knowledgebase.php?article=29

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.

TROUBLESHOOTING
---------------
If your ad code contains protocol-relative URLs that start with //, Roundcube will automatically (and incorrectly)
modify them by adding the current skin path. For example, the URL:

//your-advert-url.com/advert.js

will be changed by Roundcube to:

/skins/elastic//your-advert-url.com/advert.js

Of course, this will not load the correct script, and your ad will not be displayed. The solution to this issue is
to change the protocol-relative URLs to absolute URLs before including your code in the config file. Continuing
with our previous example, you should change this:

//your-advert-url.com/advert.js

to this:

https://your-advert-url.com/advert.js

Now, Roundcube will recognize it as a valid URL and will not modify it.

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) 2025, Tecorama LLC