ZENFUSIONMAPS Lien vers Google Maps sur les adresses 1. PRÉSENTATION DU MODULE Présentation du module ZenFusion Maps est un module d'interface léger pour Dolibarr. Il ne crée aucune table, aucun menu et aucun écran métier supplémentaire. Sa seule fonction est de rendre les adresses postales cliquables : sur les fiches Tiers, Contacts et Adhérents, l'adresse affichée devient un lien qui ouvre directement Google Maps positionné sur cette adresse. Un petit repère (marqueur) Google Maps est ajouté à droite de l'adresse pour signaler que la fonction est disponible. Manuel d'utilisation du module ZenFusion Maps — Liens Google Maps sur les adresses Version du module 1.2.0 InfraS Éditeur GPC.solutions (module tiers, licence GPL v3) Distribution Dolibarr LTS by InfraS (base Dolibarr 22.0.x) Date du manuel 22 septembre 2026 Avantages Localiser un client, un fournisseur, un contact ou un adhérent en un clic. Préparer un itinéraire depuis Google Maps sans recopier l'adresse. Aucune saisie ni configuration supplémentaire : le module exploite les champs d'adresse déjà renseignés dans Dolibarr. Google Maps s'ouvre dans la langue de l'utilisateur Dolibarr. 2. PRÉREQUIS ET INSTALLATION Installation du module Prérequis Dolibarr : 3.5 ou supérieur (validé sur Dolibarr LTS by InfraS 22.0.x). PHP 5.3 ou supérieur. Un accès Internet depuis le poste de l'utilisateur, car Google Maps s'ouvre dans le navigateur. Aucun compte Google ni clé d'API n'est nécessaire : le module utilise l'adresse publique https://maps.google.com/maps. Le module n'a aucune dépendance envers un autre module Dolibarr. Installation et activation Manuel d'utilisation du module ZenFusion Maps. Le module est livré dans le répertoire htdocs/custom/zenfusionmaps/ de l'instance. Pour l'activer : Se connecter à Dolibarr avec un compte administrateur. Ouvrir le menu Accueil > Configuration > Modules/Applications. Rechercher « ZenFusion Maps » (le module apparaît dans la famille configurée par le module Dolinfras, ou dans la famille « Autres » si Dolinfras n'est pas actif). Cliquer sur l'interrupteur pour activer le module. Dès l'activation, les liens Google Maps apparaissent sur les fiches concernées. Aucune autre étape n'est nécessaire. L'icône représentant le module (marqueur de carte) est visible dans la liste des modules et dans l'onglet « À propos » du module. 3. ACCÈS AU MODULE Droits utilisateurs Le module déclare un seul droit, visible dans la fiche de chaque utilisateur ou groupe, onglet « Permissions » : « Utiliser ZenFusion Maps ». Ce droit est accordé par défaut aux administrateurs. Pour un utilisateur standard, il se coche dans sa fiche (Accueil > Utilisateurs & Groupes > fiche de l'utilisateur > onglet Permissions > section ZenFusion Maps). Remarque importante : dans la version actuelle du module, ce droit est déclaré mais n'est pas contrôlé à l'affichage. Le lien Google Maps est donc visible par tout utilisateur autorisé à consulter la fiche Tiers, Contact ou Adhérent, qu'il possède ou non ce droit. La visibilité de l'adresse reste gouvernée par les droits habituels de Dolibarr sur ces fiches. 4. CONFIGURATION DU MODULE Configuration Le module ne possède aucun paramètre à régler. La page de configuration accessible depuis la liste des modules (icône d'engrenage ou lien « Configuration ») ne contient qu'un onglet « À propos » qui présente : Le nom et la version du module. L'éditeur (GPC.solutions) et ses coordonnées. La licence (GNU GPL version 3). Les crédits de développement et les mentions relatives aux logos utilisés. 5. UTILISATION DU MODULE Utilisation au quotidien Fiches concernées Le module s'active sur les écrans suivants : Fiche Onglet Code Tiers principal thirdpartycard Tiers Client commcard Tiers Fournisseur suppliercard Contact / Adresse — contactcard Adhérent — membercard Sur ces écrans, le champ « Adresse » (bloc adresse complète : rue, code postal, ville, pays) est enrichi du lien Google Maps. Les autres types d'objets (utilisateurs, entrepôts, projets, etc.) ne sont pas traités : le module ignore volontairement ces adresses et laisse l'affichage Dolibarr standard. Repérer le lien Google Maps Sur une fiche concernée, dès qu'une adresse est renseignée : L'adresse s'affiche avec sa mise en forme habituelle (retours à la ligne conservés). Un marqueur Google Maps de 16 pixels apparaît à droite du bloc adresse. Au survol de l'adresse, la souris prend la forme d'une main et une infobulle « Google Maps » s'affiche. Ouvrir l'adresse dans Google Maps Cliquer sur l'adresse ou sur le marqueur. Google Maps s'ouvre dans un nouvel onglet du navigateur, centré sur l'adresse recherchée. Depuis Google Maps, il est ensuite possible de calculer un itinéraire, d'utiliser Street View, de partager la position, etc. Ces fonctions relèvent de Google Maps et non du module. La fiche Dolibarr reste ouverte dans l'onglet d'origine. 6. FONCTIONNEMENT DU LIEN Fonctionnement détaillé du lien Construction de la requête envoyée à Google Maps Le module récupère l'adresse telle que Dolibarr l'a formatée (rue, code postal, ville, pays, selon le format d'adresse du pays), puis : Remplace les retours à la ligne par des espaces. Remplace les séparateurs « , » par le signe « + » attendu par Google. Retire les mentions CEDEX  Ajoute le code de langue de l'utilisateur. Le lien final est de la forme : https://maps.google.com/maps?q=&hl= Aucune donnée n'est transmise à Google tant que l'utilisateur ne clique pas sur le lien : le simple affichage de la fiche ne contacte pas Google. Suppression automatique des mentions CEDEX Google Maps ne sait pas interpréter les mentions de type « CEDEX 9 » qui suivent le nom d'une ville française. Le module supprime automatiquement, dans la requête envoyée à Google, tout ce qui suit le mot « CEDEX » (insensible à la casse) dans la ligne de ville. Exemple : Adresse saisie : 2 avenue du Président Pierre Angot, 64053 PAU CEDEX 9 Requête Google : 2 avenue du Président Pierre Angot, 64053 PAU L'adresse affichée sur la fiche Dolibarr n'est pas modifiée : seule la requête envoyée à Google est nettoyée. Langue d'affichage de Google Maps Google Maps s'ouvre dans la langue de l'utilisateur connecté à Dolibarr (langue définie dans sa fiche utilisateur ou, à défaut, langue par défaut de l'instance). Le module convertit le code de langue Dolibarr en code Google : Langue Dolibarr Code Google fr_FR, fr_BE, fr_CH fr fr_CA fr-CA en_US, en_AU, en_IN, en_NZ, en_SA en en_GB en-GB es_ES es es_AR, es_HN, es_MX, es_PE, es_PR es-419 (espagnol d'Amérique latine) de_DE, de_AT de nl_NL, nl_BE nl it_IT it pt_PT pt-PT pt_BR pt-BR ar_SA ar bg_BG bg ca_ES ca da_DK da el_GR el et_EE et fa_IR fa fi_FI fi he_IL iw hu_HU hu is_IS is ja_JP ja nb_NO no pl_PL pl ro_RO ro ru_RU, ru_UA ru sl_SI sl sv_SE sv tr_TR tr zh_CN zh-CN zh_TW zh-tw Toute autre langue non listée ci-dessus ouvre Google Maps en anglais. 7. LIMITES Limites et points d'attention Le module ne géocode pas les adresses et n'affiche pas de carte dans Dolibarr : il se limite à un lien vers le site Google Maps. La précision du positionnement dépend entièrement de la qualité de l'adresse saisie et de la base de données Google. Une adresse incomplète (sans code postal ou sans ville) peut aboutir à un résultat approximatif ou à plusieurs propositions dans Google Maps. Les adresses des utilisateurs Dolibarr, des entrepôts, des projets et des événements ne sont pas concernées. Le lien n'apparaît pas dans les listes, les documents PDF ni les e-mails, uniquement sur les fiches consultées à l'écran. Le droit « Utiliser ZenFusion Maps » n'est pas vérifié à l'affichage (voir chapitre 4). Le module Dolibarr natif « Google » propose également une option de carte sur la fiche Tiers. Si les deux sont actifs, ZenFusion Maps remplace l'affichage standard de l'adresse et prend le dessus sur cette option. L'usage de Google Maps est soumis aux conditions d'utilisation de Google. Le clic sur le lien transmet l'adresse à Google. 8. DÉPANNAGE Questions fréquentes et dépannage Le marqueur n'apparaît pas sur la fiche. Vérifier que le module est bien activé (Configuration > Modules). Vérifier que le champ Adresse de la fiche est renseigné : sans adresse, rien n'est affiché. Vérifier qu'il s'agit bien d'une fiche Tiers, Contact ou Adhérent. Vider le cache du navigateur (Ctrl + F5) si le module vient d'être activé. Google Maps ne trouve pas l'adresse ou pointe au mauvais endroit. Compléter l'adresse dans Dolibarr : rue, code postal, ville et pays. Éviter les abréviations non standard ou les commentaires dans le champ adresse (« 2e étage », « sonner chez… »), qui perturbent la recherche. Les boîtes postales et les mentions CEDEX ne sont pas localisables ; le module retire déjà les mentions CEDEX, mais une adresse constituée uniquement d'une boîte postale renverra un résultat au niveau de la ville. Google Maps s'ouvre dans la mauvaise langue. Vérifier la langue définie dans la fiche de l'utilisateur (menu Utilisateurs & Groupes > fiche > Langue par défaut). Le module suit cette langue. Le clic n'ouvre rien. Vérifier que le navigateur autorise l'ouverture de nouveaux onglets ou de fenêtres surgissantes (pop-up) pour l'adresse de l'instance Dolibarr. Vérifier que le poste dispose d'un accès à Internet. Un utilisateur sans le droit « Utiliser ZenFusion Maps » voit tout de même le lien. Comportement normal dans la version actuelle : le droit est déclaré mais non contrôlé (voir chapitre 4).