French Address Autocomplete : installation et aide

• La saisie d’adresse. Des suggestions dans le champ de rue du compte client et de la commande, y compris pour les invités.
• Le remplissage. La rue, le code postal et la ville renseignés ensemble après sélection.
• La couverture. La métropole, Corse comprise, et les départements d’outre-mer couverts par la Base Adresse Nationale.
• Le pays choisi. Des adresses du pays sélectionné, sans intervention dans les autres pays.
• Le confort de saisie. Une liste adaptée au thème, utilisable sur téléphone et au clavier.
• Vos réglages. Un démarrage sans compte à créer et des interrupteurs distincts pour le compte client et la commande.

• Proposer des adresses pendant la saisie : interrupteur général des suggestions.
• Formulaire d’adresse du compte client : active les suggestions dans ce formulaire lorsque l’interrupteur général est actif.
• Formulaires d’adresse de la commande : active les suggestions à la commande native, invités et adresse de facturation séparée compris.

Tous ces réglages sont actifs après l’installation. Pour limiter les suggestions au compte client, laisser le réglage général actif et désactiver celui de la commande. L’interrupteur général coupe les suggestions aux deux endroits.

La page de configuration présente aussi les pays couverts, la saisie manuelle, la confidentialité, la licence des données et la règle de sécurité ci-dessous. Le contrôle d’intégrité avertit si aucun pays couvert n’est actif dans la boutique. Il ne remplace pas le choix de vos pays de livraison.

Commencer par le compte client

Le réglage général et celui du compte client restent actifs, celui de la commande est désactivé. Un essai sur une adresse française du compte client suffit à vérifier cet emplacement ; la commande native garde sa saisie habituelle. Pour ouvrir ensuite les suggestions à la commande, activer son réglage et essayer également une commande sans compte et une facturation séparée.

Autoriser la connexion à l’IGN

Si votre boutique envoie une Content Security Policy, son connect-src doit autoriser l’origine utilisée par la Géoplateforme :

connect-src https://data.geopf.fr;

Cette ligne montre l’origine à ajouter à votre directive existante. Les autres sources déjà nécessaires à la boutique restent à conserver ; il ne s’agit pas d’une politique complète à copier en remplacement.

Préserver les compléments d’adresse

Saisir un bâtiment ou un étage dans le complément d’adresse, puis choisir une proposition dans le champ de rue. La rue, le code postal et la ville se remplissent ; le complément reste identique. Pour une rue recherchée sans numéro, ajouter le numéro après sélection. Les numéros du type « 12 bis » demandent également de compléter le numéro.

Prérequis

• Compatibilité générale : PS 1.6 – 9.x. Le minimum exact déclaré par le module est PrestaShop 1.6.1.0.
• PHP 7.1 ou ultérieur.
• Un formulaire d’adresse natif et un thème fondé sur Bootstrap 3, 4 ou 5 pour la présentation habituelle de la liste.
• Au moins un pays couvert actif dans la boutique pour effectuer un essai.

Aucun compte externe, aucune clé API et aucun abonnement ne sont nécessaires.

De la saisie à la sélection

Les suggestions commencent à partir de 3 caractères, après une pause de 300 ms. La liste affiche jusqu’à 5 propositions. Ces seuils décrivent le fonctionnement du module ; ce ne sont pas des options de la page de configuration.

Une sélection renseigne la rue, le code postal et la ville dans le même formulaire. Le pays reste celui que le client a choisi. Le complément d’adresse, le nom, l’entreprise et le téléphone sont préservés : un bâtiment, un étage ou un digicode déjà saisi reste à sa place.

Quand la recherche commence par un numéro, la liste propose uniquement des adresses numérotées. Sans numéro, elle propose des rues ; le client complète ensuite son numéro. Les numéros avec un complément comme « bis » demandent aussi une vérification et, si nécessaire, une saisie manuelle. Une suggestion aide à remplir le formulaire, elle ne certifie pas l’adresse.

Le pays de l’adresse

La couverture comprend la France métropolitaine et la Corse, la Guadeloupe, la Martinique, la Guyane, La Réunion et Mayotte. Le pays choisi dans le formulaire détermine les suggestions : une adresse en Martinique ne reçoit pas une rue de métropole, et une adresse à La Réunion conserve son pays.

Saint-Pierre-et-Miquelon, Saint-Barthélemy et Saint-Martin restent en saisie manuelle : la Base Adresse Nationale n’y fournit pas d’adresses numérotées complètes pour ce module. La couverture est précise, sans promesse d’autocomplétion pour tous les territoires français.

Le formulaire fonctionne comme d’habitude pour une adresse en Allemagne ou dans tout autre pays non couvert. Le module ne propose rien et ne transmet aucun texte à l’IGN. Le choix du pays reste toujours entre les mains du client ; une suggestion ne le modifie jamais.

Dans les pays couverts, la saisie manuelle reste disponible à tout moment. Le client choisit une proposition ou poursuit seul. Si le service ne répond pas, un court message l’indique et le formulaire reste utilisable. Le module ne bloque pas l’enregistrement parce qu’une adresse ne figure pas dans la liste.

Clavier, téléphone et présentation

La liste s’ouvre sous le champ de rue et reprend la présentation des listes de votre thème. Elle se sélectionne au toucher sur téléphone. Sur ordinateur, les flèches parcourent les propositions, Entrée choisit l’adresse surlignée, et Échap ou Tab ferme la liste sans sélectionner d’adresse.

Un message annonce le nombre de propositions aux lecteurs d’écran. La source des adresses est indiquée sous la liste : la Base Adresse Nationale, diffusée par l’IGN. Cette aide reste dans le formulaire existant, aussi bien dans le compte client qu’à la commande native, pour les clients connectés et les invités.

La liste utilise les éléments de menu du thème, pour Bootstrap 3, 4 ou 5, notamment les thèmes classic et default-bootstrap. Le champ est exposé aux lecteurs d’écran comme une zone de saisie avec propositions, avec une annonce discrète du nombre de résultats. La sélection reste une action du client.

Formulaires concernés

Le compte client et la commande native sont réglés séparément. Les formulaires de commande couvrent les clients connectés, les invités et la facturation à une autre adresse. Sur PrestaShop 1.6, le bloc de facturation de la commande en une page est également pris en charge.

Données et confidentialité

Les requêtes partent directement du navigateur du visiteur vers https://data.geopf.fr. Le texte saisi dans la rue est transmis à l’IGN, qui reçoit également l’adresse IP. Aucun nom, téléphone, entreprise ou autre champ du formulaire n’est envoyé par ce module. Les recherches ne transitent pas par le serveur de la boutique et le module ne les conserve pas.

La sélection remplit le formulaire ; l’enregistrement de l’adresse suit ensuite le fonctionnement habituel de PrestaShop. L’absence de stockage des recherches ne signifie donc pas que l’adresse du client ne sera pas enregistrée lorsqu’il sauvegarde son formulaire.

Les données de la Base Adresse Nationale sont sous Licence Ouverte / Etalab 2.0. Leur attribution figure sous les propositions. Le service IGN applique une limite d’usage de 50 requêtes par seconde et par adresse IP de visiteur. Une indisponibilité du service laisse la saisie manuelle accessible.

Avec what3words Integration

Les modules utilisent la même liste de suggestions partagée pour une présentation et des gestes cohérents dans le formulaire. French Address Autocomplete renseigne l’adresse postale ; le module gratuit what3words Integration ajoute son propre champ pour préciser un point de livraison. Son installation et ses réglages sont distincts.

• Aide à la saisie : le module ne contrôle pas la validité de l’adresse à l’envoi du formulaire. Une adresse proposée ne garantit pas la distribution d’un colis.
• Couverture limitée : aucun autre pays et aucune extension automatique aux territoires non couverts. Saint-Pierre-et-Miquelon, Saint-Barthélemy et Saint-Martin restent en saisie manuelle.
• Numéros : une recherche sans numéro retourne des rues ; le client ajoute le numéro. Les compléments comme « bis » demandent une saisie complémentaire.
• Champs préservés : ni pays, ni complément d’adresse, ni nom, entreprise ou téléphone ne sont remplacés.
• Pas de carte ni de géolocalisation : le module ne stocke pas de coordonnées et n’utilise pas la position du visiteur.
• Service externe : les suggestions dépendent de la réponse de l’IGN et des autorisations de connexion de la boutique. Le formulaire reste utilisable en cas d’échec.
• Checkout Revolution aujourd’hui : son étape d’adresse garde ses suggestions Google. Ce module n’y intervient pas et conserve son rôle sur le formulaire natif du compte client.

Une commande avec un formulaire d’adresse propre à un autre module ne relève pas automatiquement des formulaires natifs décrits ici. La présentation annoncée repose sur les menus Bootstrap du thème, sans promesse de compatibilité universelle avec tous les formulaires personnalisés.

• Vérifier l’interrupteur général et celui de l’emplacement essayé.
• Vérifier le pays sélectionné, son activation dans la boutique et la couverture décrite ci-dessus.
• Saisir au moins 3 caractères dans la rue puis marquer une pause. Un formulaire vide n’envoie pas de recherche.
• Une recherche commençant par un numéro attend des adresses numérotées ; poursuivre la saisie ou remplir l’adresse manuellement si rien ne correspond.
• Avec une Content Security Policy, vérifier que connect-src autorise https://data.geopf.fr.
• Dans Checkout Revolution, vérifier ses propres réglages : ce module ne pilote pas son étape d’adresse.
• Si l’IGN ne répond pas, le message sous le champ invite à poursuivre la saisie manuellement.

Les diagnostics partagés mypresta sont désactivés par défaut. Lorsqu’ils sont utilisés, ils ne consignent ni texte saisi ni adresse. Leur rôle est de relever des événements techniques, pas de constituer un historique des recherches des visiteurs.