RoundCube/fr

	Skill level: Easy
	Les instructions pour installation et l'utilisation de Roundcube peuvent être suivies par un débutant ; la modification des options nécessite une connaissance basique de Linux.

Is this article helpful to you?
Please consider donating or volunteering
Thank you!

RoundCube V1.0 pour le serveur SME Koozali

Maintaineur

stephdl Stéphane de Labrusse AKA Stephdl

Contrib 10:

1.2-24

Contrib 9:

1.2-9

smeserver-roundcube

The latest version of smeserver-roundcube is available in the SME repository, click on the version number(s) for more information.

Contrib 9:

1.2-2

roundcubemail_plugins

The latest version of roundcubemail_plugins is available in the SME repository, click on the version number(s) for more information.

Le paquet roundcubemail_plugins est obsolète dans SME10, tout est fourni par la contribution smeserver-roundcube.

Release	Released	Active Support	Security Support	Latest
1.6	25 Jul 2022	Yes	Yes	1.6.0
1.5 LTS	18 Oct 2021	Yes	Yes	1.5.3

Installation

Pour SME 10Pour SME 9Pour SME 8

yum install smeserver-extrarepositories-remi-roundcube -y

Pour la version LTS 1.5.3, ajouter ceci :

yum install yum-plugin-versionlock -y
yum versionlock  roundcubemail-1.5.3

sinon vous mettrez à jour vers la version 1.6.

yum install smeserver-roundcube   --enablerepo=smecontribs,remi-roundcube

Pour retrograder versionlock :

yum versionlock delete roundcubemail
yum update
/usr/bin/rcplugin_update.sh
signal-event smeserver-roundcube-update

yum install smeserver-roundcube --enablerepo=smecontribs

Répondre « oui » (y) pour toutes les extensions que vous voulez activer

Si vous ne voulez pas redémarrer votre serveur :

signal-event roundcube-update

sinon :

signal-event post-upgrade; signal-event reboot

Mise à jour :

yum upgrade --enablerepo=smecontribs,remi-roundcube

For SME8

Remember to first configure the two required repositories, stephdl and epel, then issue the following command on the SME Server shell:

yum install smeserver-roundcube --enablerepo=epel,stephdl
rcplugin_update.sh

answer yes (y) for all plugins you want to activate

If you do not want to restart your server

signal-event roundcube-update

or

signal-event post-upgrade; signal-event reboot

Désinstallation

Pour supprimer le paquet, exécutez la commande suivante sur l'interface du serveur SME :

yum remove roundcube smeserver-roundcube smeserver-roundcube_plugins

Pour supprimer la base de données mysql et l'utilisateur, les deux appartenants à RoundCube, voir MySQL#Remove a database and MySQL#Remove a user. Il n'y a pas besoin de redémarrer.

Utilisation

http://nom_du_serveur/roundcube et se connecter avec votre compte utilisateur du serveur SME.

Journaux

Les journaux sont disponibles :

• pour SME 8

less /opt/roundcube/logs/errors

• pour SME 9 et suivantes

less /var/log/roundcubemail/errors

	Note :
	Roundcube se connectera en IMAP avec SSL au domaine principal de votre serveur. Vous avez besoin d'un certificat valide ou auto-signé incluant au moins votre propre nom de domaine comme DNS alternatif.

Limiter l'accès à l'interface web

	Note :
	par défaut, l'interface webmail Roundcube est accessible depuis tout l'internet sans nécessiter une authentication HTTP supplémentaire.

L'acès à Roundcube peut être ajusté finement en règlant la propriété correspondante dans la BDD de configuration du serveur SME :

config setprop roundcube PublicAccess OPTION

où « OPTION » est l'un des paramètres suivants :

       none             => Pas d'acès
       local            => Réseau local (mot de passe non requis)
       local-pw         => Réseau local (mot de passe requis)
       global           => Tout l'Internet (mot de passe non requis, c'est la configuration par défaut de SME)
       global-pw        => Tout l'Internet (mot de passe requis)
       global-pw-remote => Tout l'Internet (mot de passe requis en dehors du réseau local)

Par exemple, pour restreindre l'accès au seul LAN :

config setprop roundcube PublicAccess local

Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :

expand-template /etc/httpd/conf/httpd.conf
sv h /service/httpd-e-smith

Note : pour une description générale sur la façon de régler une BDD sur le serveur SME, jeter un œil sur Web Application RPM#New DB settings.

Personnalisation

Extension pour Roundcube

Extensions par défaut contenues dans la contribution smeserver-roundcube

La contribution smeserver-roundcube est empaquetée avec les extensions suivantes déjà installées et activées par défaut :

config getprop roundcube PluginsList

globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve

Installation d'extensions supplémentaires

Note :

à contre-courant, le projet Roundcube est actuellement en train de passer de la mise à disposition d'extensions via http://trac.roundcube.net/wiki/Plugin_Repository à un nouveau référentiel d'extensions à part entière sur http://plugins.roundcube.net et un processus d'installation des extensions semi-automatisé. Les administrateurs de serveur SME sont encouragés à utiliser la nouvelle méthode de style décrite ci-dessous.

Pour installer une extension supplémentaire (absente par défaut) de Roundcube au roundcube du serveur SME server :

Étape 1 : chercher la page de l'extension sur http://plugins.roundcube.net/packages (par exemple : http://plugins.roundcube.net/packages/cor/message_highlight)

Étape 2 : prendre note du nom du paquet et de la version indiqués dans le 'require:' ligne de droite sous le titre de l'en-tête de la version de l'extension (par exemple : "cor/message_highlight" : "dev-master")

Étape 3 : ajouter le nom du paquet et la version au bloc "require:" dans /opt/roundcube/composer.json. Faire attention au séparateur virgule (,), c'est très important !

Pour SME 10Pour SME 9Pour SME 8

cd /usr/share/roundcubemail
/usr/bin/php74  /usr/local/bin/composer require cor/message_highlight --with-dependencies

• for sme9

nano /usr/share/roundcubemail/composer.json

 "require": {
      	"php": ">=5.3.0",
      	"roundcube/plugin-installer": ">=0.1.3",
      	"johndoh/markasjunk2": "dev-release-1.0",
      	"johndoh/contextmenu": "dev-master",
      	"johndoh/globaladdressbook": "dev-release-1.0",
        "cor/message_highlight": "dev-master"
    },

nano /opt/roundcube/composer.json

 "require": {
      	"php": ">=5.3.0",
      	"roundcube/plugin-installer": ">=0.1.3",
      	"johndoh/markasjunk2": "dev-release-1.0",
      	"johndoh/contextmenu": "dev-master",
      	"johndoh/globaladdressbook": "dev-release-1.0",
        "cor/message_highlight": "dev-master"
    },

Étape 4 : après chaque modification de composer.json, de façon à télécharger automatiquement et à installer l'extension, lancer :

rcplugin_update.sh

A la demande, répondre « yes » pour activer automatiquement l'extension dans la configuration actuelle de Roundcube.

Étape 5 : de façon à garder pérenne la liste des extensions installées quand la contribution est mise à jour (c'est-à-dire que les modèles de configuration soient à nouveau propagés), vous devez *absolument* ajouter l'extension de RoundCube nouvellement installée à la propriété "PluginsList" de "roundcube" dans la base de données (BDD) de configuration du serveur SME par les étapes supplémentaires ci-après :

Étape 5a : afficher d'abord la liste des extensions actuelles dans la BDD de configuration :

config getprop roundcube PluginsList

PluginsList=globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve

Étape 5b : ajouter l'extension nouvellement installée à la liste (separée par une virgule (,) est sans espaces) et enregistrer la modification :

config setprop roundcube PluginsList globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk2,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve,message_highlight

Étape 5c : enregistrer les modifications dans la BDD de configuration :

signal-event roundcube-update

Étape 5 en raccourci, en utilisant les apostrophes inverses (Alt Gr + 7) :

config setprop roundcube PluginsList `config getprop roundcube PluginsList`,message_highlight
signal-event conf-roundcube

Pour vérifier l'existence de mises à jour des extensions déjà installées, vous pouvez à tout moment re-exécuter la commande suivante :

rcplugin_update.sh

Paramètres personalisés de Roundcube

Pour des besoins spécifiques, vous pouvez créer votre fichier modèle personnalisé si vous voulez que votre fichier de configuration ne soit pas écrasé par les modèles de la contribution smeserver-roundcube. Cela s'applique aussi aux extensions de Roundcube dans /opt/roundcube/plugins/ qui viennent occasionnellement avec leur propre ficihier config.inc.php ou le fichier générique config.php.inc.dist que vous pouvez utiliser pour régler les options par défaut.

• Le fichier de configuration de Roundcube lui-même est maintenant sous forme de modèles, les modifications doivent donc être faites dans un nouveau fragment de modèle.

• pour sme8

ll /etc/e-smith/templates/opt/roundcube/config/config.inc.php/

10default_host           15Ldap_addressbook       20plugins_configuration  template-begin           template-end             

• pour sme9/sme10

ls /etc/e-smith/templates/etc/roundcubemail/config.inc.php/
10SQL_DATABASE  20LOGGING_DEBUGGING  30IMAP  40SMTP  50LDAP  60SYSTEM  70USER_INTERFACE  80ADDRESSBOOKS_SETTINGS  90USER_PREFERENCES  95PLUGINS  template-begin  template-end

• Vérifier quel réglage vous voulez modifier avec :

cat /etc/roundcubemail/defaults.inc.php

• Étendez les paramètres par défaut en ajoutant un nouveau fragment de modèle et ajoutez-y vos personnalisations/ajouts, par exemple :

vim /etc/e-smith/templates/etc/roundcubemail/config/config.inc.php/30my_custom_settings

• A la fin, propagez le modèle :

signal-event roundcube-update

De même, la personnalisation de l'extension peut être effectuée en créant des fragments de modèle personnalisés. Par exemple, pour définir si et comment le « panneau de gestion des congés » de l'extension « managesieve » doit apparaître dans l'interface webmail Roundcube :

• vérifiez la configuration actuelle de l'extension managesieve :

cat /usr/share/roundcubemail/plugins/managesieve/config.inc.php

• vérifiez les fragments actues de modèles pour la configuration de l'extension :

ll /etc/e-smith/templates/usr/share/roundcubemail/plugins/managesieve/config.inc.php/
 
 ...
 -rw-r--r-- 1 root root  266 30. Nov 19:45 30showvacation
 ...

• copiez le fragment de modèle pertinent vers /etc/e-smith/templates-custom/... et modifiez le réglage :

mkdir -p /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php
 
cp /etc/e-smith/templates/usr/share/roundcubemail/plugins/managesieve/config.inc.php/30showvacation /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php/

vim /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php/30showvacation

• Finally, expand the customized template:

signal-event roundcube-update

	Note:
	If you think your setting should be the SME default raise a bug

Add an alternative URL

If Roundcube should be reachable by an alternative URL to http://yourserver.net/roundcube, eg.

http://yourserver.net/webmail 

or

http://yourserver.net/mail

	Warning:
	The URL /webmail is by default used by the horde webmail, so you have to deactivate the webmail in the server-manager's "Configuration" -> "Email" panel if you want to use it for roundcube instead.

	Note:
	this adds another url, it doesn't remove the default

config setprop roundcube URL webmail

or

config setprop roundcube URL mail

To enable your changes run these commands

expand-template /etc/httpd/conf/httpd.conf
sv h /service/httpd-e-smith

• If you want to remove completely the new url

config delprop roundcube URL

then

expand-template /etc/httpd/conf/httpd.conf
sv h /service/httpd-e-smith

Miscellaneous notes

Mail filter support (Sieve)

Roundcube V1.0 on SME server comes with the managesieve plugin installed and enabled by default. The managesieve plugin adds additional menu items to the settings in Roundcube's webinterface to allow users to define mail filters and vacation messages in a convenient way. However, to make use of these features, the smeserver-dovecot-extras contrib also has to be installed (this adds sieve script support and a manage sieve daemon to SME server). If these features are not wanted, Roundcube's managesieve plugin should be disabled (reverse Step 5 described above, ie. remove managesieve from the list of installed plugins).

	Warning:
	sieverules has been deprecated and you must only use managesieve

Troubleshooting

• If mails are not correctly filtered by the filters configured in user's roundcube settings, check the following:
  • Is smeserver-dovecot-extras installed and is the sieve service enabled ( config getprop sieve status => enabled )? If it is not enabled: config setprop sieve status enabled
  • Is using sieve deliberately disabled for the user in question ( db accounts getprop $USER Sieve => disabled )? If it is disabled: db accounts setprop $USER Sieve enabled (Note the capital "S" in Sieve!)
  • If smeserver-mailsorting is also installed on the server, mails are first filtered by procmail or maildrop before they are handed off to the dovecot delivery agent and sieve filters. Chances are that a rule exists in a user's .procmailrc or .mailfilter file that intercepts all mails before they get to the latter stage in the mail delivery process.

---

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-roundcube component or use this link .

• smeserver-roundcube

ID	Product	Version	Status	Summary (2 tasks) ⇒
12587	SME Contribs	10.0	CONFIRMED	composer installs skins in plugins folder
12270	SME Contribs	10.0	CONFIRMED	NFR: Allow the specification of the host for the imap mail

• roundcubemail_plugins

"No open bugs found."