Belgian Address Autocomplete

Belgian Address Autocomplete est un module PrestaShop gratuit pour saisir les adresses belges. Une suggestion numérotée remplit rue et numéro, code postal à quatre chiffres et ville. Il utilise les registres officiels de Flandre, Bruxelles et Wallonie, sans compte, clé ni coût par recherche.

Démarrage rapide

1. Installez le ZIP dans PrestaShop. Aucun compte de service, clé ou paiement à préparer.
2. Ouvrez Configurer ou l’entrée Belgian Address du menu du back-office ; en multiboutique choisissez une boutique autorisée.
3. Vérifiez que la Belgique est active et disponible sur les formulaires natifs utilisés.
4. Choisissez les interrupteurs général, compte, tunnel et back-office, dans cet ordre, puis enregistrez. Aucun sélecteur de pays ici.
5. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.
6. Ajoutez les trois origines régionales à votre CSP existante et mentionnez les connexions du navigateur dans votre politique de confidentialité.
7. Sélectionnez la Belgique et saisissez rue royale 10 bru. Vérifiez Rue Royale 10, 1000, Bruxelles si retournés. Ajoutez la boîte en deuxième ligne. Testez rue seule, saisie libre, invités, facture, employés/nouvelle commande, France avec French Address Autocomplete et téléphone.

Fonctionnalités

• Suggestions belges. Registres régionaux officiels dans les formulaires natifs du compte et du tunnel, invités inclus.
• Champs remplis ensemble. Rue et numéro, code postal à quatre chiffres et ville après un choix numéroté.
• Couverture belge fixe. Flandre, Bruxelles et Wallonie ensemble ; boîtes et rues seules à compléter à la main.
• Back-office. Aide à la saisie pour votre équipe dans Clients > Adresses.
• Saisie quotidienne. Tactile, clavier et annonces pour lecteurs d’écran ; la saisie manuelle reste possible.
• Sans compte de service. Module et données régionales gratuits, quatre interrupteurs et aucune clé.

Options de configuration

• Suggérer des adresses pendant la saisie du client : interrupteur général, premier champ.
• Dans le formulaire d’adresse du compte client : adresses natives du compte.
• Dans les formulaires d’adresse de la commande (clients invités et adresses de facturation séparées compris) : invités et facturation distincte inclus.
• Sur le formulaire d’adresse du back-office (adresses des clients, nouvelles commandes) : adresses clients et nouvelles commandes natives.

Ouvrez Configurer dans le Gestionnaire de modules ou l’entrée Belgian Address du menu du back-office. La page unique contient les sections Configuration, Integrity, License, Update et Support (libellés anglais). Les quatre interrupteurs apparaissent dans cet ordre, puis Enregistrer. Tous sont activés par défaut. Aucun champ de clé, compte ou pays. En multiboutique, choisissez une boutique que vous pouvez gérer ; les réglages sont enregistrés pour cette boutique. Après le formulaire viennent les notes couverture/service gratuit, saisie manuelle, confidentialité, CSP et services associés. Les textes sont fournis en anglais, allemand, français, polonais, italien, espagnol et néerlandais ; cela ne garantit pas des données d’adresse dans sept langues.

Utiliser pour ces pays existe uniquement sur les modules mondiaux. Vide signifie tous les pays du formulaire ; une liste limite le module concerné. Belgian Address reste fixe sur BE. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Vous pouvez laisser un service mondial pour les autres destinations. Aucun échec ne provoque un relais automatique.

Exemples de personnalisation

Autorisez les trois régions belges dans votre Content Security Policy

Origines connect-src déduites du code : https://geo.api.vlaanderen.be, https://geoservices.irisnet.be et https://geoservices.wallonie.be. Aucun SDK ni style externe n’est chargé. Ajoutez cet exemple à votre politique existante, en conservant règles du thème, inline/nonces et autres modules. Avec French Address Autocomplete, autorisez aussi https://data.geopf.fr dans connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://geo.api.vlaanderen.be https://geoservices.irisnet.be https://geoservices.wallonie.be;

Conserver les détails d’appartement et de livraison

Pays, deuxième ligne, nom, entreprise et téléphone restent inchangés. Ajoutez ou conservez boîte, appartement, étage, entrée et bâtiment en deuxième ligne. Vérifiez rue, numéro, code postal et ville avant d’enregistrer. Une rue seule nécessite encore un numéro. Un choix de rue flamand vide le code postal ; Bruxelles et la Wallonie conservent celui retourné. Complétez les données manquantes à la main.

Installation

Prérequis

• Plage PrestaShop générale : PS 1.6 – 9.x. Minimum déclaré exact : PrestaShop 1.6.1.0 et PHP 7.1 ou ultérieur.
• Champs natifs et présentation Bootstrap 3, 4 ou 5. La Belgique doit être disponible ; activez-la si vous y livrez.
• Vérifiez que la Belgique est active et disponible sur les formulaires natifs utilisés.

Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Belgian Address fonctionne seul.

L’installation ne certifie pas la disponibilité du service ou toutes les combinaisons plateforme/thème. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Fonctionnement

Les suggestions commencent après trois caractères et 300 ms de pause. Quatre requêtes GET directes interrogent en parallèle Flandre, Bruxelles en français et néerlandais, et Wallonie. La Flandre utilise c=10&q=..., Bruxelles spatialReference=4326, language=fr ou nl fixe et address, la Wallonie address. Les filtres par préfixes de mots et nombres réduisent les résultats flous, avec normalisation de casse et accents. Jusqu’à cinq résultats distincts sont fusionnés à tour de rôle, sans doublons de rue, code postal et ville. Si la Wallonie ne fournit aucun résultat retenu et si la recherche a au moins trois mots, elle est interrogée une fois sans le dernier mot, avec filtrage sur le texte complet. Apostrophes et opérateurs sont remplacés par des espaces pour la Wallonie seulement. Après un premier résultat utile, les services plus lents ont encore une seconde avant annulation. Une région peut répondre malgré la panne d’une autre.

La simple ligne « Recherche des adresses… » (source : « Searching addresses… ») apparaît après 600 ms pendant une recherche. Chaque requête HTTP s’arrête après dix secondes. La nouvelle tentative wallonne peut prolonger la recherche au-delà ; il n’existe pas de limite globale de dix secondes. Vos clients peuvent continuer la saisie manuelle pendant ce temps.

Champs de l’adresse choisie

Le choix remplit address1, postcode et city sans nouvel appel. La Flandre sépare rue/numéro, code à quatre chiffres et ville ; Bruxelles fournit rue, numéro, code et commune ; la Wallonie analyse les adresses de niveau 4, déplace un numéro initial après la rue et retire les tirets bas finaux de la ville. Les quatre chiffres du code restent sans espace. Lettres et suffixes retournés avec barre oblique peuvent rester, mais les boîtes sont ajoutées à la main après le choix. Une boîte saisie doit correspondre à la ligne retournée et peut ne donner aucun résultat. Les rues seules apparaissent uniquement sans adresse numérotée valide et sans chiffre saisi. Un choix de rue flamand vide le code, Bruxelles/Wallonie conservent celui retourné. Complétez numéro et code manquants. Aucune province ni traitement spécial de localité sans rue. Deux lignes montrent rue/numéro, puis code + ville.

Utiliser pour ces pays existe uniquement sur les modules mondiaux. Vide signifie tous les pays du formulaire ; une liste limite le module concerné. Belgian Address reste fixe sur BE. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Vous pouvez laisser un service mondial pour les autres destinations. Aucun échec ne provoque un relais automatique.

Dans Clients > Adresses, votre équipe peut choisir une adresse belge pour remplir rue, code postal et ville après un appel client. L’interrupteur du back-office est indépendant du compte et du tunnel.

Le code vise aussi les fenêtres natives d’adresse d’une nouvelle commande lorsqu’elles passent par la page des adresses clients. Routes et formulaires personnalisés nécessitent un essai. Checkout Revolution peut charger le même moteur pour ses formulaires d’adresse et réutiliser ces réglages de service propres à la boutique.

Sur téléphone, vos clients touchent un résultat sous la rue. Au clavier, les flèches naviguent, Entrée sélectionne et Échap ou Tab ferme la liste. Les lecteurs d’écran reçoivent les annonces de résultats. Le composant commun suit la présentation Bootstrap du thème.

Le crédit affiché est © Digitaal Vlaanderen, paradigm.brussels, SPW. Sans résultat, la liste reste fermée ; une indisponibilité est annoncée. La saisie manuelle reste possible et l’enregistrement n’exige aucun choix. Le module ne valide pas la livrabilité lors de l’envoi.

Confidentialité et crédit des données

Le navigateur transmet le texte de rue aux trois régions, avec q pour la Flandre et address pour Bruxelles/Wallonie. Les options fixes comprennent limite de résultats, référence spatiale et langues française/néerlandaise de Bruxelles. La Wallonie reçoit du texte nettoyé et éventuellement une requête raccourcie, toujours filtrée sur le texte complet. Aucun paramètre de clé, pays choisi, langue de page, nom, e-mail, téléphone, entreprise ou deuxième ligne n’est ajouté. Tout texte saisi est transmis. Les connexions exposent l’IP et peuvent transmettre des informations du navigateur ainsi que les en-têtes Origin et Referer selon les règles du navigateur. Les identifiants de connexion sont désactivés. Chaque requête HTTP expire après dix secondes ; une nouvelle tentative peut prolonger la recherche. Le choix est local. Aucun historique ni proxy du magasin ; les diagnostics omettent recherches et adresses retournées. PrestaShop enregistre normalement l’adresse. Mentionnez ces connexions dans votre politique de confidentialité. Crédit visible : © Digitaal Vlaanderen, paradigm.brussels, SPW.

Limites à connaître

• Les registres régionaux ne garantissent ni chaque adresse, fraîcheur, disponibilité continue ni usage illimité. Les réponses enregistrées ne certifient pas les résultats actuels ou les localités sans rue.
• Les lignes mal formées sont ignorées ; les préfixes peuvent correspondre à des noms ou numéros plus longs. Boîte, appartement et bâtiment sont à ajouter après le choix. Une rue seule nécessite un numéro et parfois un code postal ; la Flandre vide ce dernier. Vérifiez l’adresse avant d’enregistrer.
• HTTP 429 suspend uniquement le serveur concerné selon Retry-After ou dix secondes ; les deux langues de Bruxelles partagent la pause. Les autres régions peuvent fournir des résultats. Chaque requête expire après dix secondes avec une nouvelle tentative wallonne possible. Saisie manuelle conservée ; aucun relais vers un autre service installé.
• Les formulaires/thèmes personnalisés et routes de nouvelles commandes doivent être testés. Checkout Revolution peut utiliser le moteur commun.
• Aucune carte, géolocalisation, sauvegarde de coordonnées, validation à l’envoi, sélection automatique du pays ou garantie de livraison. Mises à jour à vie, sans support inclus promis.

Si aucune suggestion n’apparaît

• Aucun résultat belge : vérifiez que la Belgique est active et contrôlez les interrupteurs, puis rue complète, numéro et ville.
• Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.
• Rue seule ou aucun résultat : complétez numéro, code postal et ville postale à la main puis vérifiez l’adresse avant d’enregistrer.
• Service indisponible : vérifiez réseau/CSP des services régionaux, patientez après une limite et continuez manuellement.
• Formulaire ou présentation personnalisés : testez le formulaire natif, clavier/téléphone et route de commande ; vérifiez les réglages du service pour cette boutique.