The module rcmail is currently broken.
Introduction
Basic: Integration of the roundcube webmail client in drupal
Pro / Contra iframe: The iframe solution is not very nice, but roundcube is just a complex application. Maybe it's also better for maintaining updates. Also following the unix philosophy: a task should have it's own application.
Advantages: rcmail is an module to use the nice-looking ajax webmail client roundcube in drupal. Users can leave their mail account information in drupals account settings to make use of a single-sign-on. The passwords stored crypted in drupals database*. Some scripts in roundcube were modified to use contacts managed with civicrm. Users can query, edit and insert new contacts in the contact pool of civicrm.
Future: Uses can see sent emails as activities in civicrm.
*Security: The password of the users IMAP account stored in the database using php mcrypt and a key you can set in the rcmail.module. So even a database administrator is not able to read users password as plain-text. To login the IMAP account, the password will be decrypted using mcrypt and the key in runtime. Paranoia: If an evil hacker gain access of booth, drupals database and your key (wich is stored in the script), the hacker is able to decrypt the passwords.
-
Notes 4.7.x <
rcmail was updated to work with drupal-4.7. But there are two outstanding tasks:
currently no patch for civicrm-module, if you need this don't hesitate to
contact me
Notes Drupal 5.x
rcmail.install
The automatic installation of tables needed by roundcubemail could not be done by a procedure of hook_install. Because drupal strips all protection characters like ' or ` . Because roundcubemail uses fieldnames like 'from' or 'reply-to' in the identities table f.e. Without protecting characters this breakes the MySQL syntax.
roundcube
Demo
Support / Development
Please use the rcmail project site at drupal.
If you need fast response or modification for your own needs
1) please contact me at
polyformal to
open a business track.
Installation
Requirements
please have a look at Versions before.
rcmail.module comes with 2 different patches for 2 flavors of using adressbooks. The one with the great advantage to use the addressbook from civicrm, wich needs the patch patch_ab_civicrm.txt . The other one with the standard addressbook from roundcubemail needs patch_ab_rc.txt
— Superuser 2007/03/24 12:50 civicrm is not supported yet, because it seems like that nobody needs it.
Configuration
goto [drupal]/sites/all/modules/rcmail/
unpack roundcubemail to ./ so that you have [drupal]/sites/all/modules/rcmail/roundcubemail
assuming now that ./patch_ab_[flavor].txt and ./roundcubemail/ (create symbolic links if necessary)
apply patch patch -p0 -u < patch_ab_[flavor].txt
edit roundcubemail/conf/ (for further details read roundcubemail/README and INSTALL)
before
// you can define specific table names used to store webmail data
$rcmail_config['db_table_users'] = 'users';
after
// you can define specific table names used to store webmail data
$rcmail_config['db_table_users'] = 'rcmail_users';
There is also an file called roundcubemail/SQL/mysql.initial.sql for mysql 4.x. It should work in the same way.
before
CREATE TABLE `contacts`
after
CREATE TABLE `rcmail_contacts`
when using vi/vim you can use can use:
:%s/CREATE TABLE `/CREATE TABLE `rcmail_/
In the file rcmail.module you can change the $key variable in the _encrypt() and _decrypt() function to any random characters. Booth $key must have the same content.
Finish and Check it out
settings in druapl
enable the module / permissions
edit IMAP setting in 'my account'
select 'roundcubemail' from the menu
Versions
This is a matrix witch patch matches the right roundcube version.
patch | roundcube | drupal |
patch_ab_rc.txt 1.4 | 0.1beta2 | 4.7.3 |
patch_ab_rc.txt 1.5 | 0.1beta2 | 5 |
Modifications
This gives an overview how it was modified, for everybody who is interested in.
iframe problem: 'Compose' overrides the iframe (Zeile 845)
database to drupals database
adressbook civicrm support
see patch
make patch with addressbook from civicrm
diff -ruN roundcubemail/ drupal/modules/rcmail/roundcubemail/ -x .svn -x config > patch_ab_civicrm.txt
make patch with rcmail standard addressbook
diff -ruN roundcubemail/ drupal/modules/rcmail/roundcubemail/ -x .svn -x config -x program > patch_ab_rc.txt
TODO
Task | Status | Priority | Comments |
Basic Integration | Complete | 1 | Javascript issue |
Security | Complete | 1 | handled via drupals session_db |
Crypted Passwords | Complete | 1 | handled via php mcrypt |
CiviCRM integration | In Progress | 2 | difficult if, there were different databases, works when same db as drupal (table prefix civicrm_ |
# adressbook | In Progress | 2 | Query, Update & New works basicly
solve firstname-surname-display_name issue
solve 'edit contact'→email
delete contacts(?) |
# activities | | 3 | log sent email |
# permissions | | 3 | check drupals settings for civicrm, also perissions for groups |
drupal-4.7.0 tag | Complete | 2 | issues with grab and modify formdata in case:update hook_user
patch for civicrm adressbook |
code cleanup | | 2 | |
iframe dimensions | | 3 | adminster task |
signature fom user | | 3 | |
Priority
1 : essential
2 : for stable release
3 : make up