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.fr and secure.geonames.org.
• Free GeoNames account with Web Services enabled for non-French lookups.

Installation

1. Download module_dolipostalworld-1.0.0.zip from Dolistore.
2. Open “Home > Setup > Modules/Applications”.
3. Deploy the archive as an external module without extracting it.
4. Disable DoliPostal France if enabled.
5. Enable DoliPostal-World and open its setup page.

GeoNames configuration

1. Create a free account at https://www.geonames.org/login.
2. Confirm the registration email and sign in.
3. Open https://www.geonames.org/manageaccount.
4. Under “Free Web Services”, click “Click here to enable”.
5. 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.fr and secure.geonames.org