Administration

Changement de domaine email

dolixdomaine · version 1.0.4

Un client change de nom : ses adresses passent au nouveau domaine en une opération.

Prix: 25 € HT
Dolibarr: 19.0 minimum
Version: 1.0.4
Licence: GPL v3+
Langues: Français, anglais

En validation sur le DoliStore

Il n’est pas achetable aujourd’hui. La vente, l’encaissement, la facture et le téléchargement se feront sur le DoliStore, jamais sur ce site. Pour être prévenu de sa mise en vente, écrivez à contact@dolix.fr.

Support et contact

L'aperçu complet avant écriture : chaque adresse barrée, la nouvelle en vert. La partie avant le @ n'est jamais touchée, et vous décochez ligne par ligne. — L'aperçu complet avant écriture : chaque adresse barrée, la nouvelle en vert. La partie avant le @ n'est jamais touchée, et vous décochez ligne par ligne.

Ce que fait le module

Vous saisissez l'ancien et le nouveau domaine, sans l'arobase ; le module liste tous les tiers et contacts dont l'adresse se termine par l'ancien domaine.
Aperçu ancienne adressenouvelle adresse, ligne par ligne, avec une case à décocher pour exclure une fiche.
La partie située avant l'arobase n'est jamais modifiée.
Écriture transactionnelle : en cas d'erreur, la totalité de l'opération est annulée.
Option de configuration : inclure aussi les adhérents, si le module Adhérents est activé.
Plafond de sécurité réglable (1 000 fiches par défaut) et historique des opérations consultable dans la configuration du module.

À qui ça sert

Votre client a changé de nom et vous avez des dizaines d'adresses à corriger fiche par fiche.

Une entreprise que vous suivez est rachetée, ou change de raison sociale. Toutes ses adresses passent de @ancienne-entreprise.fr à @nouvelle-entreprise.fr. Dans Dolibarr, il faut ouvrir la fiche du tiers, corriger, ouvrir chaque contact, corriger. Pour quarante contacts, c’est une demi-journée, et une faute de frappe passe inaperçue.

À qui ça sert : Toute structure dont un client, un fournisseur ou un groupe d'adhérents a changé de nom de domaine : rachat, changement de raison sociale, fusion, migration de messagerie.

Ce que le module ne fait pas

Ce bloc figure sur les six fiches, sans exception.

Ne traite que les tiers, leurs contacts et, en option, les adhérents. Ni les comptes utilisateurs, ni les adresses écrites dans les documents, les événements ou les campagnes d'emailing.
Le rapprochement est exact : seules les adresses qui se terminent par @ancien-domaine sont proposées. Une adresse en @service.ancien-domaine n'est pas concernée par une recherche sur ancien-domaine.
Un seul domaine à la fois. Pour trois domaines, trois opérations.
La mise à jour est écrite directement en base : les déclencheurs de Dolibarr ne sont pas exécutés et aucun événement n'est créé dans l'agenda. L'opération est en revanche inscrite dans les journaux de Dolibarr et dans l'historique du module.
Le module ne vérifie pas que le nouveau domaine existe : il vérifie seulement que la forme saisie est celle d'un nom de domaine.

Comment ça marche

Le module remplace la partie située après l’arobase dans les adresses email des tiers et de leurs contacts. En option, il traite aussi les adhérents.

Vous saisissez l’ancien et le nouveau domaine, sans l’arobase. Le module liste toutes les fiches dont l’adresse se termine par l’ancien domaine, et affiche pour chacune l’ancienne adresse barrée suivie de la nouvelle. Vous décochez ce que vous voulez exclure, puis vous appliquez.

La partie située avant l’arobase n’est jamais modifiée. paul.durand@ancienne.fr devient paul.durand@nouvelle.fr, jamais autre chose.

Après application, le module dit exactement combien de fiches il a modifiées.

Réglages

La page de configuration du module propose trois réglages.

Réglage	Défaut	Effet
Inclure aussi les adhérents	désactivé	Traite également les adresses des adhérents, si le module Adhérents est activé.
Plafond de sécurité (lignes)	1 000	Au-delà de ce nombre de fiches concernées, l’application est bloquée et il faut affiner le domaine.
Conserver un historique	activé	Enregistre chaque opération : date, utilisateur, domaines, nombre de fiches.

Les trois réglages, et l'historique : qui a changé quel domaine, quand, et sur combien de fiches. — Les trois réglages, et l'historique : qui a changé quel domaine, quand, et sur combien de fiches.

Sécurité et garde-fous

Un droit dédié, « Utiliser le changement de domaine email », à attribuer aux seuls utilisateurs concernés. Sans ce droit, le menu n’apparaît pas et l’écran est inaccessible.
Aperçu obligatoire : il n’existe aucun chemin qui écrive sans être passé par la liste.
Confirmation demandée avant l’écriture.
Revérification côté serveur : au moment d’écrire, le module relit chaque fiche et ne modifie que celles dont l’adresse correspond encore à l’ancien domaine.
Écriture transactionnelle : à la première erreur, l’ensemble de l’opération est annulé et rien n’est enregistré.
Multi-société : chaque lecture et chaque écriture sont limitées aux entités autorisées.
Utilisateurs externes : un compte rattaché à un tiers ne voit que sa propre fiche et ses propres contacts, et jamais les adhérents.

Au-delà du plafond de sécurité, l'application est bloquée. Le module ne modifie jamais plus de fiches que ce que vous avez autorisé.

Ce qui est livré

Ce que le module écrit dans votre installation
Tables créées en base	Une table : llx_dolixdomaine_log. Elle enregistre l'historique des opérations (date, utilisateur, ancien domaine, nouveau domaine, nombre de tiers, de contacts et d'adhérents modifiés, entité). Aucune donnée métier n'y est stockée.
Permissions	Un droit : « Utiliser le changement de domaine email ». Sans ce droit, l'écran est inaccessible et le menu n'apparaît pas.
Désinstallation	Désactiver le module dans ConfigurationModules/Applications. Le menu disparaît. Les adresses déjà modifiées restent telles quelles : ce sont des données de votre base, comme si vous les aviez saisies. La table d'historique llx_dolixdomaine_log et les réglages du module ne sont pas supprimés. Rien n'est effacé de votre base sans votre intervention.

Une table est ajoutée : llx_dolixdomaine_log. Elle ne contient que l’historique des opérations — date, utilisateur, ancien et nouveau domaine, nombre de fiches, entité. Aucune donnée métier n’y est copiée.
Les seules données modifiées sont les adresses email des fiches que vous avez laissées cochées.
Chaque modification est écrite dans les journaux de Dolibarr, avec l’ancienne et la nouvelle adresse et l’identifiant de l’utilisateur.
Aucune connexion sortante : rien n’est envoyé nulle part.

Compatibilité

Le descripteur du module ne déclare qu’une version minimale. Aucune borne haute n’est inscrite dans le code : les versions ci-dessous sont celles sur lesquelles le module a réellement été exécuté.

Compatibilité du module Changement de domaine email
Versions de Dolibarr	Dolibarr 19.0 minimum. Installé et exécuté sur 23.0.4 et 24.0.0.
PHP minimum	7.4
Modules Dolibarr à activer	Tiers
Licence	GPL v3 ou ultérieure, code source complet
Langues	Français, anglais
Menu	Menu Tiers« Changer un domaine email ».

Installation

Récupérer le module sur le DoliStore et télécharger le fichier zip.
Dans Dolibarr : AccueilConfigurationModules/Applicationsonglet « Déployer/installer un module externe », puis envoyer le zip. Sinon, décompresser le dossier dolixdomaine dans htdocs/custom/.
Activer « Changement de domaine email » dans la liste des modules. La table d'historique est créée à ce moment-là.
Attribuer le droit « Utiliser le changement de domaine email » aux utilisateurs concernés, dans Utilisateurs & Groupes.
Régler le plafond, l'historique et l'inclusion des adhérents dans la page de configuration du module.

Le détail — droits du dossier custom, hébergement mutualisé, mise à jour, désinstallation — est sur la page Installation et mise à jour.

Questions fréquentes

Sur quelles versions de Dolibarr ce module fonctionne-t-il ?

Le descripteur exige Dolibarr 19.0 au minimum et PHP 7.4 au minimum. Les captures ont été réalisées sous 24.0.0. Si vous êtes sur une version plus ancienne et que vous avez un doute, écrivez avant d'acheter.

Est-ce que ça touche ma base de données ?

Oui, c'est l'objet du module : il écrit les nouvelles adresses email des fiches que vous avez laissées cochées. Il ajoute par ailleurs une table, llx_dolixdomaine_log, qui ne contient que l'historique des opérations. Aucune autre colonne de votre base n'est modifiée.

Que se passe-t-il si l'opération échoue au milieu ?

Rien n'est enregistré. Les mises à jour sont faites dans une transaction : à la première erreur, l'ensemble est annulé et un message le signale. Avant d'écrire, le module revérifie côté serveur que chaque adresse correspond encore à l'ancien domaine.

Et si je désinstalle ?

Le menu disparaît. Les adresses corrigées restent corrigées. La table d'historique et les réglages restent en base : vous pouvez les supprimer vous-même si vous le souhaitez.

Qui répond au support ?

La personne qui a écrit le module. Écrivez à support@dolix.fr avec votre version de Dolibarr, la version du module et ce que vous observez.

Comment se passent le paiement et les mises à jour ?

La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore. Les nouvelles versions y sont publiées, et le journal des versions de cette page est mis à jour à chaque publication.

Journal des versions

Repris du fichier ChangeLog.md du module : une seule source.

1.0.410 septembre 2026

Correctif d'affichage : le message de fin annonçait « … mis à jour. et 3 adhérent(s) », un « et » minuscule après un point. Le message est désormais rédigé d'un seul tenant.

1.0.310 septembre 2026

Technique : la fonction de vérification du jeton anti-CSRF porte désormais un nom préfixé par le module, pour qu'une fonction du même nom ajoutée un jour dans Dolibarr ne puisse pas empêcher la page de s'ouvrir. Un jeton vide est refusé explicitement.

1.0.210 septembre 2026

Correctif : l'écran de configuration renvoyait une erreur 500 à l'enregistrement, la fonction d'écriture des réglages de Dolibarr étant appelée sans que sa bibliothèque soit chargée. Les réglages s'enregistrent normalement.

1.0.19 septembre 2026

Correctif de sécurité : un utilisateur externe, c'est-à-dire un compte rattaché à un tiers, ne voit et ne modifie plus que sa propre fiche et ses contacts, à l'aperçu comme à l'application.

1.0.09 septembre 2026

Première version : changement en masse du domaine email des tiers et contacts, avec aperçu, sélection et mise à jour transactionnelle.