Roundcube Webmail bringt von Hause aus ein eigenes Adressbuch mit, in dem man seine Kontakte ablegen kann. Über das Plugin RCMCardDAV ist es außerdem möglich Adressbücher über CardDAV einzubinden und so beispielsweise sein Adressbuch von OwnCloud auch in Roundcube zu nutzen.
Diese Anleitung beschreibt die Vorgehensweise bei der Einrichtung des Plugins in Roundcube und geht dabei von einer bereits laufenden aktuellen Roundcube-Version (1.1.4) aus.
Vorbereitungen
- Wie eigentlich immer: Backup der Dateien und der Datenbank erstellen.
- In Roundcube abmelden, falls man eingeloggt ist. Dies ist wichtig, da es sonst später zu Datenbankfehlern kommt!
- Auf dem Server curl und php-curl (php5-curl für PHP5) installieren, falls nicht schon vorhanden:
apt-get install curl php-curl
Installation des Plugins
Zuerst wechseln wir in das plugins
-Verzeichnis von Roundcube, laden das Plugin von GitHub herunter und entpacken es. Im Beispiel ist Roundcube unter /var/www/roundcube
installiert.
user@server:~$ cd /var/www/roundcube/plugins user@server:/var/www/roundcube/plugins$ wget https://github.com/blind-coder/rcmcarddav/archive/master.zip user@server:/var/www/roundcube/plugins$ unzip master.zip user@server:/var/www/roundcube/plugins$ mv rcmcarddav-master carddav user@server:/var/www/roundcube/plugins$ rm master.zip
Wichtig ist das Verzeichnis des Plugins in carddav
umzubenennen, da sonst das Plugin nicht richtig funktioniert.
Anschließend wechseln wir in das Verzeichnis des Plugins und installieren die benötigten Abhängigkeiten mit Hilfe von composer, was einen Moment dauern kann.
user@server:/var/www/roundcube/plugins$ cd carddav user@server:/var/www/roundcube/plugins/carddav$ curl -sS https://getcomposer.org/installer | php user@server:/var/www/roundcube/plugins/carddav$ php composer.phar install
Sobald dies erledigt ist kopieren wir noch die config.inc.php.dist
nach config.inc.php
und bearbeiten diese anschließend.
user@server:/var/www/roundcube/plugins/carddav$ cp config.inc.php.dist config.inc.php user@server:/var/www/roundcube/plugins/carddav$ nano config.inc.php
Die einzige Einstellung die wir in der Konfiguration des Plugins ändern bzw. einfügen müssen ist $prefs['_GLOBAL']['pwstore_scheme'] = 'des_key';
. Achtung: Es dürfen keine // am Anfang der Zeile stehen! Standardmäßig werden die CradDAV-Passwörter nur in Base64-Kodierung gespeichert, was recht unsicher ist. Durch die Anpassung auf des_key wird der globale des_key von Roundcube verwendet um die Passwörter verschlüsselt zu speichern.
Zuletzt aktivieren in der Konfiguration von Roundcube (nicht dem Plugin) noch das Plugin indem wir dem Array $config['plugins']
den Eintrag carddav
hinzufügen.
user@server:/var/www/roundcube/plugins/carddav$ cd ../../ user@server:/var/www/roundcube$ nano config/config.inc.php
Der Eintag könnte dann wie folgt aussehen, wobei hier noch ein anderes Plugin namens jqueryui aktiv ist.
$config['plugins'] = array('jqueryui', 'carddav');
Einrichtung eines CardDAV-Adressbuches in der Weboberfläche
Sobald das Plugin aktiviert ist können wir uns in der Weboberfläche von Roundcube wieder ganz normal anmelden. Bei der ersten Anmeldung werden die vom Plugin benötigten Datenbanktabellen automatisch erstellt.
Unter Einstellungen->Einstellungen->CardDAV können nun für den aktuellen Benutzer beliebige Adressbücher über die entsprechende CardDAV-URL mit den dazugehörigen Logindaten angelegt werden.
Der Aktualisierungsintervall gibt dabei an, die oft Roundcube Änderungen vom CardDAV-Server abruft. Nimmt man in Roundcube eine Änderung an den Kontakten vor, so werden diese Änderungen immer direkt zum CardDAV-Server übertragen.
Alle angelegten CardDAV-Adressbücher sind dann im ganz normalen Roundcube Adressbuch verfügbar.
28. Dez. 2021 um 16:08
Super Anleitung, vielen Dank! Hat einwandfrei funktioniert!