
CONTENTS OF THIS FILE
---------------------

 * Summary
 * Installation
 * Configuration
 * More Information
 * Credits


SUMMARY
-------

This module integrates RoundCube Webmail with Drupal by automagically logging
users in and out of RoundCube. It provides users with easy access to to their
webmail, with support for Thickbox.

This readme provides essential instructions for installing and setting up the
module. For more detailed instructions, see the module's online Drupal handbook
page at this hard to forget URL: http://drupal.org/node/333333.


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

1. DOWNLOAD AND INSTALL ROUNDCUBE WEBMAIL

   Download RoundCube Webmail 2.0-beta from:
   
     http://roundcube.net/downloads

   Install it by following these instructions:

     http://trac.roundcube.net/wiki/Howto_Install

   Make sure to set a fixed IMAP host address in RoundCube's configuration
   file, as explained here:

   http://trac.roundcube.net/wiki/Howto_Config.

2. INSTALL ROUNDCUBE MODULE

   To install this module, place its entire folder into your modules directory
   (resulting in e.g. sites/default/modules/roundcube). Go to Administer >
   Site building > Modules and enable the RoundCube module.

3. INTEGRATE MODULE WITH ROUNDCUBE

   Copy the following lines and paste them into line 35 of the index.php file
   of your RoundCube Webmail installation:

     #################### BEGINNING OF DRUPAL INTEGRATION ####################
     require_once('/foo/bar/modules/roundcube/roundcube.inc');
     ####################### END OF DRUPAL INTEGRATION #######################

   Change the dummy path so that it points to the roundcube.inc file of this
   module (e.g. '../sites/default/modules/roundcube/roundcube.inc').

   The result should look something like this:

     // init application and start session with requested task
     $RCMAIL = rcmail::get_instance();

     #################### BEGINNING OF DRUPAL INTEGRATION ####################
     require_once('../sites/default/modules/roundcube/roundcube.inc');
     ####################### END OF DRUPAL INTEGRATION #######################

     // init output class

4. DOWNLOAD AND INSTALL THICKBOX (OPTIONAL)

   To use RoundCube in a Thickbox, install and enable the Thickbox module.
   It can be downloaded from http://drupal.org/project/thickbox.


CONFIGURATION
-------------

Go to Administer > Site configuration > RoundCube and enter an absolute URL to
the index.php file of your RoundCube Webmail installation (e.g.
https://example.com/webmail/index.php).

If RoundCube has been correctly installed, and the logged in Drupal user has a
matching IMAP account, you should now see RoundCube and its Inbox when clicking
on the "Webmail" menu item.


MORE INFORMATION
----------------

For additional documentation, see the module's online Drupal handbook page at
http://drupal.org/node/333333.

To file a bug report, feature request or support request, see the module's
issue queue at http://drupal.org/project/issues/roundcube.


CREDITS
-------

Authors:
Thomas Barregren <http://drupal.org/user/16678>
Joakim Stai <http://drupal.org/user/88701>

Sponsors:
Norrlandsflyg <http://norrlandsflyg.se/>
Webbredaktören <http://webbredaktoren.se/>
