ZENFUSIONMAPS

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=<adresse>&hl=<langue>

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).