Module DoliPostal-World (EN)
DoliPostal-World module
Documentation française : Module_DoliPostal-World
| Module name | DoliPostal-World |
|---|---|
| Publisher | InCréation |
| Status | Stable |
| Version | 1.0.0 |
| Module ID | 207622 |
| Compatibility | Dolibarr 17 through 24 |
| License | GNU GPL v3 or later |
| Languages | French and English |
Overview
DoliPostal-World assists worldwide address entry in Dolibarr native fields. Once a country and postal code are entered, it proposes matching cities and can fill the State, Department or region.
France uses the official French geographic API. Other countries use GeoNames with a free account configured server-side. The module modifies no Dolibarr core file, adds no business table and alters no business document.
Features
- Country and postal-code lookup.
- International formats with letters, digits, spaces, dots and hyphens.
- All returned cities remain selectable.
- Native Town and State fields.
- Optional State, Department or region autofill.
- Existing values are preserved and manual entry remains available.
- Configurable browser cache from 0 to 30 days.
- French and English interface.
Supported forms
The module works on native Third party, Contact/Address and User address forms.
Requirements
- Dolibarr 17 through 24.
- PHP 7.4 through 8.4 with cURL.
- Outbound HTTPS access to
geo.api.gouv.frandsecure.geonames.org. - Free GeoNames account with Web Services enabled for non-French lookups.
Installation
- Download
module_dolipostalworld-1.0.0.zipfrom Dolistore. - Open “Home > Setup > Modules/Applications”.
- Deploy the archive as an external module without extracting it.
- Disable DoliPostal France if enabled.
- Enable DoliPostal-World and open its setup page.
GeoNames configuration
- Create a free account at https://www.geonames.org/login.
- Confirm the registration email and sign in.
- Open https://www.geonames.org/manageaccount.
- Under “Free Web Services”, click “Click here to enable”.
- In Dolibarr, enter the GeoNames username, never the email address, then save.
Privacy
Only the postal code and ISO country code are sent to the corresponding service. The GeoNames username stays server-side. No name, third party, contact, complete address, phone number, email or business-document identifier is transmitted.
France edition
DoliPostal-World is distinct from DoliPostal France. Both use the same native address fields and must not be enabled simultaneously.
Technical information
- Technical name:
dolipostalworld - Descriptor:
modDoliPostalWorld - Module ID:
207622 - Version:
1.0.0 - APIs:
geo.api.gouv.frandsecure.geonames.org