Configuration par l'administrateur

Accéder à la page de configuration

La configuration du module se fait depuis :

Accueil > Configuration > Modules > Multismtp > Configurer

Ou directement à l'adresse : /custom/multismtp/admin/setup.php. La page est organisée en plusieurs blocs, décrits ci-dessous.

Section SMTP

Cette section affiche d'abord deux avertissements possibles, à corriger avant toute activation :

• Un avertissement si l'envoi d'e-mails est complètement désactivé dans Dolibarr, avec un lien direct pour le réactiver.
• Un avertissement si le mode d'envoi n'est pas réglé sur « SMTP/SMTPS socket library », avec un lien direct vers la page de configuration générale des e-mails pour corriger ce point.

Une fois ces avertissements résolus, trois réglages sont disponibles, sous la forme d'un interrupteur cliquable (icône verte = activé, icône grise = désactivé) :

• « Activer la fonction SMTP » : active ou désactive entièrement la possibilité, pour les utilisateurs, de configurer leur propre compte d'envoi. Désactiver ce réglage supprime au passage tous les identifiants SMTP déjà enregistrés pour l'ensemble des utilisateurs.
• « Utiliser MultiSMTP seulement pour les envois depuis des formulaires email (pas pour des envois automatisés) » : lorsque ce réglage est activé, les identifiants personnels de l'utilisateur ne sont utilisés que lorsqu'il envoie lui-même un e-mail depuis un formulaire Dolibarr (par exemple en envoyant une facture par e-mail). Les envois automatiques du logiciel (notifications, relances programmées, etc.) continuent quant à eux d'utiliser le compte d'envoi général de la société.
• « Autoriser les utilisateurs à configurer un autre serveur e-mail » : par défaut, les utilisateurs ne peuvent renseigner que leur identifiant et leur mot de passe, mais doivent obligatoirement envoyer leurs e-mails par le même serveur que celui de la configuration générale, pour des raisons de sécurité. Activer ce réglage autorise chaque utilisateur à indiquer également son propre serveur, son port, le chiffrement TLS ou STARTTLS, la méthode d'authentification, et le cas échéant sa propre configuration OAuth2.

Section IMAP

Cette section commence par un réglage préalable :

• « MAIN_IMAP_USE_PHPIMAP » : active l'utilisation de la bibliothèque PHP-IMAP (Webklex) à la place de l'extension PHP native. Ce choix est obligatoire pour pouvoir utiliser l'authentification OAuth2 côté IMAP ; il n'est pas nécessaire si seule une authentification par mot de passe est prévue.
• « Activer la fonction IMAP » : rend disponible, pour les utilisateurs, la copie automatique de leurs e-mails envoyés vers leur propre boîte aux lettres. Si aucune des deux bibliothèques IMAP n'est disponible sur le serveur, ce réglage est grisé et un message « Non disponible » s'affiche à la place.

Lorsque la fonction IMAP est disponible, un bloc « Forcer la configuration du serveur IMAP » apparaît, avec les réglages suivants :

• « Ne pas valider le certificat SSL » : à activer uniquement si le serveur IMAP utilise un certificat auto-signé (non reconnu par une autorité de certification publique). Dans le cas contraire, laisser ce réglage désactivé pour conserver la vérification normale du certificat.
• Un champ « Hôte » et un champ « Port » : s'ils sont renseignés, tous les utilisateurs utilisent obligatoirement ce serveur et ce port pour leur IMAP, et ne peuvent plus les modifier depuis leur propre fiche. Ils n'auront alors plus qu'à renseigner leur identifiant, leur mot de passe et le dossier de destination des e-mails.
• « Utiliser le chiffrement SSL » : impose ou non le chiffrement SSL sur ce serveur IMAP commun.
• « Méthode d'authentification » : impose soit une authentification par mot de passe (« LOGIN »), soit une authentification OAuth2 (« XOAUTH2 », disponible uniquement si la bibliothèque PHP-IMAP est activée et si la version de Dolibarr le permet).
• « Service d'authentification OAUTH2 » : si la méthode d'authentification ci-dessus est réglée sur OAuth2, ce champ permet d'imposer à tous les utilisateurs le même service OAuth2 pré-enregistré dans Dolibarr (menu Administration > OAuth). Ce champ ne s'affiche que lorsque la méthode d'authentification OAuth2 est sélectionnée.

Section Cron / OAuth2

Cette section ne comporte qu'un seul réglage :

• « Nombre de jours après expiration pour rafraîchir les tokens OAuth2 » : cette valeur (30 jours par défaut) définit la marge de tolérance laissée à la tâche planifiée quotidienne avant qu'elle ne tente de renouveler automatiquement un jeton d'accès OAuth2 arrivé à expiration.

Adresse d'expédition

Un réglage supplémentaire, non présent sur la page de configuration ci-dessus et destiné à un usage avancé, peut être activé manuellement par l'administrateur depuis Accueil > Configuration > Autres, en créant la constante suivante :

MULTISMTP_REPLACE_MAIL_EMAIL_FROM = 1

Lorsque cette constante est activée, l'adresse d'expédition affichée dans les e-mails envoyés (le champ « De ») est elle aussi remplacée par l'identifiant SMTP personnel de l'utilisateur, au lieu de rester sur l'adresse générale configurée dans Dolibarr. À utiliser uniquement si l'identifiant SMTP de chaque utilisateur correspond bien à une adresse e-mail valide et destinée à être vue par les destinataires.