Traduisez vos e-mails sans quitter Dolibarr / Traduction à la demande

1. Présentation

Traduction à la demande ajoute un bouton « Traduire » là où vous rédigez un message : le formulaire d’envoi d’un e-mail et la création ou la modification d’un modèle d’e-mail. Il ouvre une petite fenêtre dans laquelle vous saisissez (ou reprenez) un texte, choisissez la langue, et obtenez sa traduction, copiée automatiquement dans le presse-papier.

• Un texte surligné avant de cliquer sur le bouton est repris dans la fenêtre et traduit tout de suite.
• La langue d’origine et la langue cible se choisissent avec leur drapeau ; la langue par défaut est réglable.
• La traduction peut remplacer le texte surligné à la fermeture de la fenêtre.
• La saisie enrichie (gras, listes, liens) est conservée dans la traduction.
• Sur la fiche d’un produit, un bouton ajoute une traduction dans une langue choisie : le libellé et la description sont traduits automatiquement.
• Les PDF générés dans une autre langue peuvent avoir la description de leurs lignes de produits traduite automatiquement (option).
• Seuls les utilisateurs autorisés par un droit peuvent utiliser la traduction.
• Le module ne modifie pas le Core de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	20 à 24
PHP	7.4 à 8.3
Framework NSINFO (module NSINFO, gratuit)	23.9.5 ou plus récent, installé et activé
Un service de traduction en ligne	DeepL, Google, Microsoft Azure, LibreTranslate, MyMemory ou Lingva (voir plus bas)

2.2 Installation

1. Installez et activez le module NSINFO (framework NSINFO).
2. Déposez le module Traduction à la demande comme n’importe quel module externe de Dolibarr, puis activez-le dans Accueil > Configuration > Modules.
3. Choisissez et configurez le service de traduction (voir Configuration).
4. Donnez le droit « Utiliser la traduction à la demande » aux utilisateurs concernés (voir Droits d’accès).

Après une mise à jour du module, désactivez-le puis réactivez-le pour que les droits et les réglages soient pris en compte.

3. Configuration

Ouvrez Accueil > Configuration > Modules, puis le réglage du module. Les onglets sont :

Onglet	Rôle
Traduction	Choix du service de traduction et saisie de ses informations de connexion
Réglages	Langue par défaut, saisie enrichie, apparence du bouton, comportement de la fenêtre
Copie des paramètres	Export et import des réglages du module
ChangeLog et À propos	Historique des versions et informations sur le module

3.1 Service de traduction

Dans l’onglet Traduction, choisissez le service qui effectuera les traductions et renseignez ce qu’il demande (le plus souvent une clé d’accès ou l’adresse du service). Les services proposés sont DeepL, Google Cloud Translation, Microsoft Azure Translator, LibreTranslate, MyMemory et Lingva. Chaque service précise ses conditions (quota gratuit éventuel, limites, inscription) : elles sont rappelées dans l’onglet.

La liste des langues proposées dans la fenêtre est celle du service choisi : elle change si vous changez de service.

Le texte à traduire est envoyé au service que vous choisissez. Tenez-en compte pour les informations confidentielles.

3.2 Réglages du module

Les réglages sont rangés en sous-onglets (à gauche) : Général (langue par défaut), E-mails, Bouton « Traduire », Produits et PDF. Le dernier sous-onglet ouvert est mémorisé, et un sous-onglet qui contient un réglage modifié porte le picto de retour à la valeur par défaut.

Réglage	Effet
Langue de traduction par défaut	Langue vers laquelle le texte est traduit à l’ouverture de la fenêtre (anglais par défaut). Jusqu’à cinq langues, le choix se fait avec des puces à drapeau ; au-delà, dans une liste de sélection avec drapeaux. L’utilisateur peut en choisir une autre dans la fenêtre.
Saisie enrichie du texte à traduire	Active la mise en forme (gras, italique, listes, liens) dans le champ de saisie ; elle est conservée dans la traduction. Activé par défaut.
Bouton « Traduire » à la création et à la modification des modèles d’e-mails	Affiche le bouton aussi dans les modèles d’e-mails (Accueil > Configuration > Modèles d’e-mails). Activé par défaut.
À la clôture de la fenêtre, remplacer le texte surligné par la traduction	Valeur de départ de la case de la fenêtre (voir Fermer la fenêtre). Activé par défaut.
PDF dans une autre langue : traduire automatiquement la description des lignes de produits qui n’ont pas de traduction	Quand un PDF (proposition, commande, facture…) est généré dans une langue différente de celle de Dolibarr, la description de chaque ligne de produit est d’abord cherchée dans les traductions du produit. Si elle n’y est pas, elle est traduite automatiquement dans la langue du PDF et remplace la description dans le PDF. Rien n’est enregistré : la ligne du document ne change pas, et les traductions sont conservées pour ne pas être redemandées. Désactivé par défaut ; le texte des descriptions est envoyé au service de traduction.
Nom du bouton d’ajout d’une traduction de produit, et sa couleur (sous-onglet Produits)	Libellé (« Ajouter avec traduction automatique » par défaut) et couleur du bouton de la fiche produit (voir Ajouter une traduction à un produit).
Texte du bouton	Libellé du bouton (« Traduire » par défaut).
Affichage du bouton	Picto et texte, picto uniquement ou texte uniquement. En « picto uniquement », le picto s’affiche seul, sans cadre, dans la couleur du bouton.
Couleur du picto du bouton	Couleur du picto quand il accompagne le texte.
Couleur du bouton	Couleur de fond du bouton (et du picto en mode « picto uniquement »). Un aperçu du bouton s’affiche et suit vos choix.

Tous les réglages sont enregistrés dès que vous les modifiez (une coche verte le confirme), sans bouton. Un réglage qui n’a plus sa valeur par défaut est signalé par un picto de retour à la valeur par défaut, et un message en haut de page permet de tout remettre par défaut.

3.3 Copie des paramètres

L’onglet Copie des paramètres exporte les réglages du module dans un fichier, et les importe sur un autre Dolibarr. Les informations sensibles (clés d’accès) ne sont exportées que si vous le demandez.

4. Droits d’accès

Le module ajoute un droit : « Utiliser la traduction à la demande ». Il n’est accordé à personne par défaut : donnez-le dans Utilisateurs et groupes, sur la fiche de l’utilisateur ou du groupe, onglet « Permissions ».

• Sans ce droit, le bouton n’apparaît pas et la traduction est refusée.
• Les administrateurs disposent du droit.
• Tant que le module est activé, la traduction automatique proposée par les autres modules NSINFO est elle aussi réservée aux utilisateurs qui ont ce droit.

5. Utilisation

5.1 Ouvrir la fenêtre de traduction

Le bouton « Traduire » s’affiche au-dessus du message :

• dans le formulaire d’envoi d’e-mail d’une fiche (tiers, proposition, commande, facture, ticket…) ;
• à la création et à la modification d’un modèle d’e-mail, si l’option correspondante est activée.

5.2 Traduire un texte

1. Cliquez sur « Traduire » : la fenêtre s’ouvre, le curseur est déjà dans la zone du texte à traduire.
2. Saisissez ou collez le texte (avec sa mise en forme si la saisie enrichie est activée).
3. Choisissez la langue « De » (par défaut votre langue) et la langue « Vers » (par défaut la langue du réglage), côte à côte, avec leur drapeau.
4. Cliquez sur « Traduire » : la traduction s’affiche et est copiée dans le presse-papier.
5. Collez-la où vous voulez avec Ctrl + V. Si la copie automatique est refusée par le navigateur, le bouton « Copier » la refait.

Les deux langues doivent être différentes.

5.3 Traduire un texte surligné

Surlignez un texte (dans le message en cours de rédaction, dans un champ du formulaire ou dans la page, par exemple un message reçu), puis cliquez sur « Traduire » : le texte surligné est repris dans la fenêtre et traduit immédiatement, sans autre clic. Dans l’éditeur, la mise en forme du texte surligné est conservée.

5.4 Fermer la fenêtre

• « Clôturer » ferme la fenêtre. Si la case « Remplacer le texte surligné par la traduction » est cochée (elle reprend le réglage du module, et ne vaut que pour la traduction en cours), le texte surligné dans le message ou dans le champ est remplacé par la traduction. Un texte surligné dans la page elle-même ne peut pas être remplacé : la case n’est alors pas proposée.
• La croix en haut à droite, la touche Échap ou un clic à côté de la fenêtre ferment sans aucune action : rien n’est remplacé.

5.5 Ajouter une traduction à un produit

Sur la fiche d’un produit ou d’un service, onglet Traduction, un bouton (« Ajouter avec traduction automatique » par défaut, nom et couleur réglables) ouvre une fenêtre :

1. Choisissez la langue : seules sont proposées les langues que le service de traduction sait traduire et que le produit n’a pas encore. La langue par défaut du réglage est présélectionnée.
2. Le libellé et la description du produit sont traduits automatiquement dès l’ouverture, puis à chaque changement de langue.
3. Les traductions s’affichent : vous pouvez les corriger avant de continuer.
4. Cliquez sur « Valider et ajouter la traduction » : la traduction est ajoutée au produit. Rien n’est enregistré avant ce clic.

Le bouton demande le droit « Utiliser la traduction à la demande » et le droit de modifier les produits ou services.

5.6 PDF dans une autre langue

Quand l’option « PDF dans une autre langue : traduire automatiquement la description des lignes de produits qui n’ont pas de traduction » est activée, un PDF généré dans une langue différente de celle de Dolibarr (proposition, commande, facture…) est complété ainsi, ligne de produit par ligne de produit :

• si le produit a une traduction de sa description dans la langue du PDF et que la ligne n’a pas été modifiée à la main, Dolibarr l’utilise comme d’habitude ;
• sinon (pas de traduction du produit, ou description de la ligne modifiée à la main), la description de la ligne est traduite automatiquement et remplace la description dans le PDF.

La ligne du document n’est pas modifiée. Les traductions sont conservées : un même texte dans une même langue n’est demandé qu’une fois au service. Seule la description est traduite (pas le libellé du produit), et seules les lignes de produits (pas les lignes libres).

Cette option est désactivée par défaut : les descriptions sont envoyées au service de traduction choisi et peuvent consommer son quota.

6. Limites connues et FAQ

• Le bouton n’apparaît pas. Vérifiez que vous avez le droit « Utiliser la traduction à la demande » et que vous êtes sur un formulaire d’envoi d’e-mail (ou un modèle d’e-mail si l’option est activée).
• « Traduction impossible » ou message d’erreur. Le service de traduction n’est pas configuré ou refuse la demande (clé incorrecte, quota atteint) : vérifiez l’onglet « Traduction ».
• La liste des langues est courte. Elle dépend du service choisi ; certains services en proposent plus que d’autres.
• La mise en forme est perdue. Certains services (MyMemory, Lingva) ne traduisent que du texte simple : la traduction revient en paragraphes sans mise en forme.
• La copie dans le presse-papier échoue. Le navigateur peut refuser la copie automatique ; utilisez le bouton « Copier ». La copie avec mise en forme demande une connexion sécurisée (https).
• La description n’est pas traduite dans mon PDF. Vérifiez que l’option est activée, que le PDF est bien généré dans une langue différente de celle de Dolibarr et que le service de traduction est configuré ; régénérez ensuite le PDF.
• Le texte est-il conservé ? Non : le module n’enregistre ni le texte ni sa traduction ; ils sont seulement transmis au service de traduction choisi.

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.