RoundCube/fr

From SME Server
Revision as of 17:24, 31 December 2022 by Gieres (talk | contribs)
Jump to navigation Jump to search


PythonIcon.png 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.png


RoundCube V1.0 pour le serveur SME Koozali

Maintaineur

stephdl Stéphane de Labrusse AKA Stephdl

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



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 add 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 !

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 dans /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
  • Au final, propagez le modèle personnalisé :
signal-event roundcube-update
  Note :
si vous pensez que votre paramètre devrait être la valeur par défaut de SME, ouvrez un bogue.


Ajouter une URL alternative

Si Roundcube doit être aceessible par une URL alternative à http://mon_serveur.net/roundcube, par exemple :

http://mon_serveur.net/webmail 

ou

http://mon_serveur.net/mail


  Attention :
l'URL /webmail est utilisée par défaut par la messagerie web Horde, donc vous devez désactiver la messagerie web dans le gestionnaire du serveur dans « Configuration » -> panneau « Messagerie électronique » -> « Modifier les paramètres d'accès à la messagerie » si vous voulez utiliser ce mot pour Roundcube en remplacement.



  Note :
ceci ajoute une autre URL, cela ne supprime pas celle par défaut.


config setprop roundcube URL webmail

ou

config setprop roundcube URL mail

Pour activer vos modifications, exécutez ces commandes :

expand-template /etc/httpd/conf/httpd.conf
sv h /service/httpd-e-smith
  • Si vous voulez supprimer totalement la nouvelle URL :
config delprop roundcube URL

puis :

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

Notes diverses

Prise en charge du filtre de messagerie (Sieve)

Roundcube V1.0 sur le serveur SME comprend l'extension « managesieve » installée et activée par défaut. L'extension « managesieve » ajoute dans le menu des items supplémentaires aux réglages de l'interface web de Roundcube pour permettre aux utilisateurs de définir commodément les filtres des courriels et les messages d'absence. Cependant, pour utiliser ces fonctionalités, la contribution smeserver-dovecot-extras doit aussi être installée (cela ajoute la prise en charge des scripts « sieve » et une adaptation du démon « sieve » au serveur SME). Si ces fonctionalités ne sont pas demandées, l'extension « managesieve » de Roundcube peut être désactivée (voir Étape 5 décrite plus haut, c'est-à-dire en supprimant managesieve de la liste des extensions installées).


  Attention :
sieverules est obsolète et vous devez seulement utiliser managesieve.


Dépannage
  • Si les courriels ne sont pas correctement filtrés par les filtres configurés dans les paramètres utilisateur de RoundCube, vérifier les points suivants :
    • est-ce que la contribution smeserver-dovecot-extras est installée et le service « sieve » activé ( config getprop sieve status => enabled ) ? S'il n'est pas activé : config setprop sieve status enabled
    • est-ce que l'utilisation de « sieve » a été délibérement désactivée pour l'utilisateur en question ( db accounts getprop $USER Sieve => disabled ) ? S'il a été désactivé : db accounts setprop $USER Sieve enabled (Notez le « S » majuscule dans Sieve !)
    • si la contribution smeserver-mailsorting est aussi installée sur le serveur, les courriels sont en premier lieu filtrés par procmail ou maildrop avant qu'ils ne soient remis à l'agent de réception dovecot et aux filtres sieve. Il y a de fortes chances qu'une règle existe dans le fichier .procmailrc ou .mailfilter d'un utilisateur qui intercepte tous les courriels avant qu'ils n'atteignent la dernière étape du processus de distribution.

Bogues

Veuillez ouvrir les bogues dans la section SME-Contribs dans bugzilla et sélectionner le composant smeserver-roundcube ou utiliser ce lien .

  • smeserver-roundcube
IDProductVersionStatusSummary (2 tasks)
12587SME Contribs10.0CONFIRMEDcomposer installs skins in plugins folder
12270SME Contribs10.0CONFIRMEDNFR: Allow the specification of the host for the imap mail
  • roundcubemail_plugins
"No open bugs found."