mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Update Roundcube documentation according new app changes
This commit is contained in:
Jérôme Lebleu
parent
ba6ee2ffd5
commit
2282afb377
2 changed files with 13 additions and 125 deletions
|
|
@ -2,76 +2,18 @@
|
|||
|
||||
Roundcube is a web client for email messaging also called webmail.
|
||||
|
||||
### Install CardDAV support for Roundcube
|
||||
### Synchronize your contacts
|
||||
|
||||
Roundcube allows you to synchronize your contacts with a CardDAV server, through a third party plugin. Using a CardDAV server like Radicale or owncloud's "Contacts" application, both available in YunoHost, allows you to centralize and manage your contacts.
|
||||
Roundcube offers you at the installation to synchronize your contacts with a CardDAV server, through a third party plugin. Using a CardDAV server like Baïkal or ownCloud's "Contacts" application, both available in YunoHost, allows you to centralize and manage your contacts.
|
||||
|
||||
Similarly to IMAP that allows you to synchronize your emails with your mail server, CardDAV allows you to access your contacts through multiple clients, such as Roundcube.
|
||||
Thanks to CardDAV, you will not have to import your contacts in each of your devices.
|
||||
Similarly to IMAP that allows you to synchronize your emails with your mail server, CardDAV allows you to access your contacts through multiple clients, such as Roundcube. Thanks to CardDAV, you will not have to import your contacts in each of your devices.
|
||||
|
||||
CardDAV support requires a third party plugin, developped by par Christian Putzke.
|
||||
Note that addressbooks defined in Baïkal or ownCloud will be automatically added in Roundcube for each user if they are already installed.
|
||||
|
||||
----
|
||||
|
||||
Follow the instructions to install:
|
||||
|
||||
* Connect to your server (physically or through SSH):
|
||||
```bash
|
||||
ssh admin@your_server_ip
|
||||
```
|
||||
|
||||
* Next you'll need to gain administrator rights ("root" user): `sudo su`
|
||||
|
||||
* Move to the Roundcube plugin directory ("plugins"):
|
||||
```bash
|
||||
cd /var/www/roundcube/plugins/
|
||||
```
|
||||
|
||||
* Download plugin:
|
||||
```bash
|
||||
git clone https://github.com/christian-putzke/Roundcube-CardDAV/
|
||||
```
|
||||
|
||||
* Rename downloaded folder to "carddav":
|
||||
```bash
|
||||
mv Roundcube-CardDAV carddav
|
||||
```
|
||||
|
||||
* Get MySQL "root" password:
|
||||
```bash
|
||||
cat /etc/yunohost/mysql
|
||||
```
|
||||
|
||||
* Add the plugin necessary SQL tables:
|
||||
```bash
|
||||
mysql -u root -p roundcube < carddav/Roundcube-CardDAV/SQL/mysql.sql
|
||||
```
|
||||
|
||||
* Type in the MySQL root password and press `Enter`.
|
||||
|
||||
* Open Roundcube configuration file:
|
||||
```bash
|
||||
nano /var/www/roundcube/config/main.inc.php
|
||||
```
|
||||
|
||||
* Look for Plugins section using the nano search function (Ctrl-W) and identify the line beginning with `$rcmail_config['plugins'] = array('carddav','http_authentication', 'archive', 'new_user_identity'`
|
||||
|
||||
* Add "carddav" at the beginning, in order to result to the following: `array('carddav','http_authentication', 'archive', 'new_user_identity'`
|
||||
|
||||
* Exit nano by pressing `Crtl-X` and save.
|
||||
|
||||
* Finally, type:
|
||||
```bash
|
||||
cp /var/www/roundcube/plugins/carddav/config.inc.php.dist /var/www/roundcube/plugins/carddav/config.inc.php
|
||||
```
|
||||
|
||||
Now, you just have to connect to your Roundcube application, select "Parameters" located at the top right corner, then select "CardDAV" in the left panel.
|
||||
|
||||
Synchronize your owncloud contacts:
|
||||
In case you've installed ownCloud after, here is how to add your addressbooks:
|
||||
|
||||
* Go to "Contacts" section of your owncloud application and click on the gear wheel icon located at the bottom left. Then, click on "CardDAV link" and copy the URL that appeared.
|
||||
|
||||
* Go to Roundcube's CardDAV section and type in "ownCloud" in "Label" field, paste the previously copied URL and type your username and password.
|
||||
|
||||
Your contacts are now synchronized!
|
||||
|
||||
Note that even if Roundcube may complain about some "time out" but process is working.
|
||||
* Go to Roundcube's CardDAV section and type in "ownCloud" in "Label" field, paste the previously copied URL and type your username and password. Your contacts are now synchronized!
|
||||
|
|
|
|||
|
|
@ -2,72 +2,18 @@
|
|||
|
||||
Roundcube est un client web de courrier électronique libre ou aussi appelé un webmail.
|
||||
|
||||
### Synchronisation des contacts
|
||||
|
||||
|
||||
### Installer le support CardDAV pour Roundcube
|
||||
|
||||
Roundcube vous permet, via un greffon tiers, de synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Radicale ou l’application « Contacts » d’ownCloud, tous deux disponibles pour YunoHost, a l’avantage de permettre une gestion centralisée de vos contacts.
|
||||
Roundcube vous propose à l'installation, via un greffon tiers, de pouvoir synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Baïkal ou l’application « Contacts » d’ownCloud, tous deux disponibles pour YunoHost, a l’avantage de permettre une gestion centralisée de vos contacts.
|
||||
|
||||
De la même façon que le protocole IMAP vous permet de synchroniser vos courriels avec votre serveur mail, CardDAV vous permet d’avoir accès à vos contacts depuis une multitude de clients, dont Roundcube. Avec CardDAV, nous n’aurez donc plus besoin d’importer vos contacts dans chaque client.
|
||||
|
||||
Le support de CardDAV nécessite l’installation d’un greffon tiers, développé par Christian Putzke.
|
||||
Notez que si Baïkal ou ownCloud sont déjà installés, les carnets d'adresses qui y sont définis seront automatiquement ajoutés pour chaque utilisateur dans Roundcube.
|
||||
|
||||
Pour l’installer, suivez les indications suivantes :
|
||||
----
|
||||
|
||||
* Accédez à votre serveur physiquement ou connectez-vous à distance via SSH :
|
||||
```bash
|
||||
ssh admin@ip_de_votre_serveur
|
||||
```
|
||||
|
||||
* Il vous faudra ensuite obtenir les droits de l’administrateur (utilisateur « root ») en tapant : `sudo su`
|
||||
|
||||
* Placez-vous dans le répertoire des greffons (« plugins ») de Roundcube :
|
||||
```bash
|
||||
cd /var/www/roundcube/plugins/
|
||||
```
|
||||
|
||||
* Téléchargez le greffon qui nous intéresse en tapant :
|
||||
```bash
|
||||
git clone https://github.com/christian-putzke/Roundcube-CardDAV/
|
||||
```
|
||||
|
||||
* Renommez le dossier téléchargé en « carddav » :
|
||||
```bash
|
||||
mv Roundcube-CardDAV carddav
|
||||
```
|
||||
|
||||
* Notez (ou copiez) le mot de passe de l’utilisateur « root » de votre base MySQL qui s’affichera en tapant :
|
||||
```bash
|
||||
cat /etc/yunohost/mysql
|
||||
```
|
||||
|
||||
* Ajoutez les tables SQL nécessaires au greffon en tapant :
|
||||
```bash
|
||||
mysql -u root -p roundcube < carddav/Roundcube-CardDAV/SQL/mysql.sql
|
||||
```
|
||||
|
||||
* Entrez le mot de passe que vous venez de noter et appuyez sur `Entrée`.
|
||||
|
||||
* Ouvrez le fichier de configuration de Roundcube :
|
||||
```bash
|
||||
nano /var/www/roundcube/config/main.inc.php
|
||||
```
|
||||
|
||||
* Cherchez la section « Plugins » en utilisant la fonction de recherche de nano (Ctrl-W) et identifiez la ligne qui commence par `$rcmail_config['plugins'] = array('carddav','http_authentication', 'archive', 'new_user_identity'`
|
||||
|
||||
* Modifiez le début de la ligne en ajoutant l’élément « carddav », de sorte à obtenir ceci : `array('carddav','http_authentication', 'archive', 'new_user_identity'`
|
||||
|
||||
* Quittez nano en tapant `Crtl-X` sans bien entendu oublier d’enregistrer le fichier modifié.
|
||||
|
||||
* Pour finir, tapez :
|
||||
```bash
|
||||
cp /var/www/roundcube/plugins/carddav/config.inc.php.dist /var/www/roundcube/plugins/carddav/config.inc.php
|
||||
```
|
||||
|
||||
Il vous suffit ensuite de vous connecter à Roundcube via votre panneau YunoHost et de cliquer sur « Paramètres » en haut à droite, puis sur « CardDAV » à gauche.
|
||||
|
||||
Pour synchroniser vos contacts ownCloud :
|
||||
Si vous avez installé ownCloud après, voici comment ajouter vos carnets d'adresses :
|
||||
|
||||
* Rendez-vous dans la section « Contacts » de votre espace ownCloud et cliquez sur l’icône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur l’icône « Lien CardDAV » et copiez l’URL qui s’affiche en dessous.
|
||||
|
||||
* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « ownCloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur et votre mot de passe. Vos contacts sont désormais synchronisés ! Notez que Roundcube risque de se plaindre d’un « time out », mais le processus fonctionne quand même.
|
||||
* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « ownCloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur et votre mot de passe. Vos contacts sont désormais synchronisés !
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue