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.4 and 1.5
- PHP: 5.6 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
-------------
1. 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.

2. This plugin is not compatible with the old 'classic' skin. We suggest you remove this skin from your Roundcube
   installation.

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

//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js

will be changed to by Roundcube to this:

/skins/larry//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js

This will of course not load the proper script, and your ad won't be shown. The solution to this problem is changing
the protocol-relative URLs to absolute URLs before including your code in the config file. Following our previous
example, you should change this:

//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js

to this:

https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js

Now Roundcube will recognize it as a proper 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) 2022, Tecorama LLC