French Address Autocomplete

French Address Autocomplete añade sugerencias de direcciones francesas a los formularios estándar de PrestaShop. La Base Adresse Nationale (BAN), distribuida por el IGN a través de la Géoplateforme, proporciona los resultados. Elegir una propuesta rellena address1, postcode y city.

Inicio rápido

1. Sube el ZIP desde el gestor de módulos e instala French Address Autocomplete.
2. Abre Configurar en el módulo. Las sugerencias de cuenta y pedido ya están activadas.
3. Conserva los lugares de uso que quieras y guarda los ajustes.
4. Si la tienda envía una Content Security Policy, añade el origen del IGN como indica el ejemplo.
5. Incluye la transmisión del texto de la calle y de la IP al IGN en la política de privacidad.
6. Prueba la cuenta, el pedido de invitado y una dirección de facturación separada. Elige también un país no cubierto para verificar la introducción habitual.

Funciones

• Introducción de la dirección. Sugerencias en el campo de la calle de la cuenta y del proceso de compra de PrestaShop, también para invitados.
• Campos relacionados. Calle, código postal y ciudad rellenados juntos al elegir una propuesta.
• Cobertura. Francia metropolitana con Córcega y los departamentos de ultramar cubiertos por el servicio.
• País elegido. Resultados del país seleccionado y formulario habitual para los demás países.
• Uso diario. Una lista con el aspecto del tema, disponible en el móvil y con el teclado.
• Tu control. Inicio sin cuentas externas e interruptores separados para cuenta de cliente y pedido.

Opciones de configuración

• Sugerir direcciones mientras el cliente escribe: interruptor general de la función.
• Formulario de dirección de la cuenta de cliente: activa las sugerencias ahí si el interruptor general está activado.
• Formularios de dirección del pedido: activa las sugerencias en el proceso de compra de PrestaShop, incluidos invitados y facturación separada.

Todos los interruptores están activados tras la instalación. Para ofrecer sugerencias solo en la cuenta, deja activados el general y el de la cuenta y desactiva el del pedido. El interruptor general detiene las propuestas en ambos lugares.

La página también explica cobertura, introducción manual, privacidad, licencia de los datos y permiso de conexión al IGN. La comprobación de integridad avisa si ningún país cubierto está activo en la tienda. Los países a los que envías siguen siendo una decisión de la configuración de tu tienda.

El módulo no tiene una lista de países que puedas ampliar libremente. La cobertura sigue los datos BAN y el país de la dirección; los interruptores eligen los formularios donde se muestran las sugerencias.

Ejemplos de personalización

Empezar por la cuenta de cliente

Deja activados el interruptor general y el de la cuenta, y desactiva el del pedido. Prueba una dirección francesa en la cuenta. Cuando actives también el pedido, prueba el formulario de un invitado y una dirección de facturación separada, además de un pedido con sesión iniciada.

Permitir la conexión al IGN

Si tu tienda envía una Content Security Policy, añade el origen del IGN a la directiva connect-src existente:

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

El ejemplo indica el origen necesario para obtener sugerencias. Conserva los otros orígenes que necesita tu tienda. Esta línea no es una política completa para sustituir la que ya tienes.

Conservar los detalles de entrega

Escribe un piso o una puerta en la segunda línea y elige después una sugerencia de calle. Calle, código postal y ciudad se rellenan juntos, mientras la segunda línea permanece igual. Si buscas una calle sin número, añade el número tras elegirla. Un número como «12 bis» también requiere completar el número.

Instalación

Requisitos

• Compatibilidad general: PS 1.6 – 9.x. El mínimo exacto declarado por el módulo es PrestaShop 1.6.1.0.
• PHP 7.1 o posterior.
• Formularios de dirección estándar y un tema Bootstrap 3, 4 o 5 para la presentación descrita de la lista.
• Al menos un país cubierto activo en la tienda para hacer la prueba.

No necesitas una cuenta externa, una clave API ni una suscripción. Abrir un formulario vacío no inicia una búsqueda. Las propuestas requieren un país cubierto y texto suficiente en el campo de la calle.

Cómo funciona

De la escritura a la elección

Las sugerencias empiezan a partir de 3 caracteres y una pausa de 300 ms. La lista muestra hasta 5 resultados. Son valores de funcionamiento incorporados, no opciones de la página de ajustes.

La selección rellena calle, código postal y ciudad en el mismo formulario. El país sigue siendo el que eligió el cliente. La segunda línea, el nombre, la empresa y el teléfono quedan intactos: un piso, una puerta o una indicación de acceso ya escrita no desaparece al seleccionar la calle.

Cuando la búsqueda comienza con un número, la lista muestra solo direcciones numeradas. Buscar una calle sin número devuelve calles, y el cliente añade después el número. Los números con un añadido como «bis» también requieren completar el número. La propuesta ayuda a rellenar los campos, pero no certifica que la dirección final sea correcta.

Por ejemplo, 10 rue de rivoli comienza con un número, por lo que solo aparecen direcciones numeradas. Buscar únicamente el nombre de la calle devuelve propuestas de calles. Una lista vacía no declara que la dirección sea incorrecta: el cliente sigue escribiendo o rellena el formulario a mano.

País y cobertura

La cobertura incluye Francia metropolitana con Córcega, Guadalupe, Martinica, Guayana Francesa, Reunión y Mayotte. El país elegido en el formulario determina los resultados. Una dirección de Martinica no recibe una calle de la Francia metropolitana y elegir una propuesta nunca modifica el país.

Saint-Pierre-et-Miquelon, Saint-Barthélemy y Saint-Martin mantienen la introducción manual: BAN no proporciona allí direcciones numeradas completas para este módulo. El formulario sigue funcionando con normalidad. La cobertura depende del país de la dirección, sin ampliarse porque el cliente visite la tienda en francés.

En Alemania y los demás países fuera de la cobertura, el formulario funciona como siempre. El módulo no muestra sugerencias ni envía el texto escrito al IGN. El país lo elige el cliente; una propuesta nunca sustituye esa elección por Francia.

La introducción manual sigue disponible también en los países cubiertos. El cliente selecciona un resultado o continúa escribiendo por su cuenta. Si el IGN no responde, un mensaje breve lo indica y el formulario permanece utilizable. Que una dirección no aparezca en la lista no impide guardarla. El módulo no valida la dirección al enviar el formulario.

Teclado, móvil y lectores de pantalla

La lista se abre debajo del campo de la calle con la presentación de los menús de tu tema. En el móvil, el cliente toca un resultado. Con el teclado, las flechas recorren las propuestas y Enter elige la dirección resaltada; Escape o Tab cierra la lista sin seleccionar ninguna.

Un mensaje discreto comunica el número de resultados a los lectores de pantalla. Debajo de la lista se identifica la fuente: Base Adresse Nationale, distribuida por el IGN. El cliente sigue en el formulario existente, en su cuenta o en el proceso de compra de PrestaShop, también como invitado o con una dirección de facturación separada.

La lista utiliza elementos de menú desplegable del tema para Bootstrap 3, 4 o 5, incluidos classic y default-bootstrap. El campo incorpora semántica de combobox y un anuncio discreto de resultados para lectores de pantalla. Recorrer las propuestas no elige por sí solo una dirección.

Formularios incluidos

La cuenta y el proceso de compra de PrestaShop tienen ajustes separados. En el pedido se incluyen clientes conectados, invitados y dirección de facturación distinta. En PrestaShop 1.6 también se contempla el bloque de facturación del pedido en una página.

Solicitudes, fuente y privacidad

Las solicitudes van directamente desde el navegador del visitante a https://data.geopf.fr. El IGN recibe el texto de la calle y ve la dirección IP. Este módulo no envía nombre, empresa, teléfono ni los demás campos. Las búsquedas no pasan por el servidor de la tienda y no se almacenan en el módulo.

El resultado elegido rellena primero el formulario. Cuando el cliente guarda la dirección, PrestaShop sigue su funcionamiento habitual. Que no se guarden las búsquedas no significa que la tienda deje de guardar la dirección que el cliente ha confirmado.

Los datos BAN se ofrecen bajo Licence Ouverte / Etalab 2.0. La atribución aparece debajo de las sugerencias. El IGN aplica un límite de uso de 50 solicitudes por segundo y por IP de visitante. Si el servicio no responde, la introducción manual sigue disponible.

Junto a what3words Integration

El módulo gratuito what3words Integration añade un campo separado para identificar el punto exacto de entrega. Ambos módulos usan la misma lista compartida de sugerencias, de modo que la calle y el campo what3words tienen una presentación y una selección coherentes con el tema. Cada módulo mantiene su función y configuración propias.

Límites que debes conocer

• Ayuda para rellenar: no valida la dirección al enviar el formulario. Una propuesta no confirma la intención del cliente ni garantiza que el transportista entregue allí.
• Cobertura limitada: no hay sugerencias para otros países. Saint-Pierre-et-Miquelon, Saint-Barthélemy y Saint-Martin mantienen la introducción manual al faltar direcciones BAN numeradas completas.
• Números: buscar una calle requiere añadir después el número; añadidos como «bis» también exigen completarlo.
• Campos conservados: país, segunda línea, nombre, empresa y teléfono no se sustituyen.
• Sin mapas ni geolocalización: el módulo no guarda coordenadas ni usa la ubicación del visitante.
• Servicio externo: los resultados dependen de que el IGN responda y de que el navegador pueda conectarse. El formulario sigue disponible si hay un error.
• Checkout Revolution hoy: su paso de dirección usa Google. Este módulo no interviene ahí y sigue trabajando en el formulario estándar de la cuenta.

Un paso de dirección personalizado de otro módulo de pedidos no queda incluido automáticamente en los formularios estándar descritos. La presentación indicada usa los menús Bootstrap del tema y no implica compatibilidad universal con cualquier formulario personalizado.

Si no aparecen sugerencias

• Revisa el interruptor general y el del formulario que estás probando.
• Elige un país cubierto y comprueba que esté activo en la tienda.
• Escribe al menos 3 caracteres en la calle y haz una pausa. Un campo vacío no inicia una búsqueda.
• Una búsqueda que empieza con número espera resultados numerados. Sigue escribiendo o introduce la dirección a mano si no hay coincidencias.
• Si tienes Content Security Policy, permite https://data.geopf.fr en connect-src.
• Para Checkout Revolution, revisa sus propios ajustes de dirección; este módulo no controla ese paso.
• Si el IGN no responde, sigue el aviso bajo el campo y utiliza la introducción manual.

Los diagnósticos compartidos mypresta están desactivados por defecto. Sus eventos técnicos nunca registran el texto escrito ni las direcciones. No son un historial de las búsquedas de direcciones de los visitantes.