Module DoliPostal-World
Module DoliPostal-World
English documentation: Module_DoliPostal-World_(EN)
| Nom du module | DoliPostal-World |
|---|---|
| Éditeur | InCréation |
| Statut | Stable |
| Version | 1.0.0 |
| Identifiant du module | 207622 |
| Compatibilité | Dolibarr 17 à 24 |
| Licence | GNU GPL v3 ou ultérieure |
| Langues | Français et anglais |
Présentation
DoliPostal-World assiste la saisie des adresses internationales dans les champs natifs de Dolibarr. Après la sélection du pays et la saisie du code postal, le module propose les villes correspondantes et peut renseigner le département, l’État ou la région.
La France utilise l’API géographique officielle française. Les autres pays utilisent GeoNames avec un compte gratuit configuré côté serveur. Le module ne modifie aucun fichier du cœur, n’ajoute aucune table métier et ne modifie aucun document commercial.
Fonctionnalités
- Recherche par pays et code postal.
- Formats internationaux contenant lettres, chiffres, espaces, points et tirets.
- Proposition de toutes les villes retournées.
- Utilisation des champs natifs Ville et Département / Canton.
- Remplissage automatique optionnel du département, de l’État ou de la région.
- Conservation des valeurs existantes et saisie manuelle disponible.
- Cache navigateur configurable de 0 à 30 jours.
- Interface française et anglaise.
Écrans pris en charge
Le module intervient sur les formulaires natifs d’adresse des tiers, contacts/adresses et utilisateurs.
Prérequis
- Dolibarr 17 à 24.
- PHP 7.4 à 8.4 avec cURL.
- Accès HTTPS sortant vers
geo.api.gouv.fretsecure.geonames.org. - Compte GeoNames gratuit avec les services Web activés pour les recherches hors de France.
Installation
- Télécharger
module_dolipostalworld-1.0.0.zipdepuis Dolistore. - Ouvrir « Accueil > Configuration > Modules/Applications ».
- Déployer l’archive comme module externe sans la décompresser.
- Désactiver DoliPostal France s’il est actif.
- Activer DoliPostal-World puis ouvrir sa configuration.
Configuration GeoNames
- Créer gratuitement un compte sur https://www.geonames.org/login.
- Confirmer l’e-mail reçu et se connecter.
- Ouvrir https://www.geonames.org/manageaccount.
- Dans « Free Web Services », cliquer sur « Click here to enable ».
- Dans Dolibarr, saisir le nom d’utilisateur GeoNames, jamais l’adresse e-mail, puis enregistrer.
Confidentialité
Seuls le code postal et le code ISO du pays sont transmis au service correspondant. L’identifiant GeoNames reste côté serveur. Aucun nom, tiers, contact, adresse complète, téléphone, e-mail ou identifiant de document métier n’est transmis.
Édition France
DoliPostal-World est distinct de DoliPostal France. Les deux modules utilisent les mêmes champs natifs et ne doivent pas être activés simultanément.
Informations techniques
- Nom technique :
dolipostalworld - Classe :
modDoliPostalWorld - Identifiant :
207622 - Version :
1.0.0 - API :
geo.api.gouv.fretsecure.geonames.org