RoundCube/fr
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
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
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 sme8
less /opt/roundcube/logs/errors
- pour sme9
less /var/log/roundcubemail/errors
- pour SME 10
Limiter l'accès à l'interface web
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
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 !
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 personalisé 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
Likewise, plugin customization can be done by creating custom template fragments. For example, to set if and how the "vacation management panel" of the "managesieve" plugin should appear in the Roundcube webmail frontend:
- check the current configuration of the managesieve plugin:
cat /usr/share/roundcubemail/plugins/managesieve/config.inc.php
- check current template fragments for the plugin configuration:
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 ...
- copy the relevant template fragment to /etc/e-smith/templates-custom/... and modify the setting:
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
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
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).
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