Todo lo que querrías saber antes de instalar.
Una mirada detallada a cómo funciona DataFirefly Address Lookup - Autocompletado de direcciones al pagar para PrestaShop 8 y 9, por qué lo construimos así y la lógica detrás de las características anteriores.
El problema invisible que cuesta dinero: direcciones mal escritas
Uno de cada diez clientes introduce su dirección con un error tipográfico, una calle incompleta, un código postal equivocado. Resultado: entregas devueltas, costes de reenvío, soporte sobrecargado, carritos abandonados al pagar. En PrestaShop, el formulario de dirección nativo no ofrece ninguna ayuda — el cliente teclea a ciegas. DataFirefly Address Lookup soluciona esto convirtiendo el formulario de dirección en un asistente inteligente que sugiere, completa y valida en tiempo real.
La API francesa BAN: gratuita y oficial
El módulo utiliza por defecto api-adresse.data.gouv.fr, la API oficial del Gobierno francés. Es la misma base que usan los servicios postales y los sistemas de información públicos: cobertura exhaustiva del territorio, actualización continua, direcciones normalizadas. Sin clave de API, sin suscripción, sin coste de uso. Las peticiones van directamente del navegador del cliente a la API — su servidor nunca interviene, su ancho de banda no se consume.
Google Places opcional para sus clientes internacionales
Si vende a nivel internacional, active el motor Google Places como complemento. Introduzca su clave de API en la configuración, restrínjala por referente HTTP en la Google Cloud Console, y el módulo cambia a Google automáticamente en cuanto el cliente selecciona un país distinto de Francia. También puede restringir Google a una lista blanca de países (BE, CH, LU, DE por ejemplo) para mantener bajo control su presupuesto Google Cloud.
El flujo del cliente: código postal → ciudad → calle
El cliente empieza a rellenar su dirección. Teclea los cinco dígitos de su código postal: si una sola comuna coincide, la ciudad se rellena sola; si no, aparece un selector de ciudades. Empieza a teclear su calle: el módulo consulta la BAN filtrando por el código postal ya conocido y propone las direcciones coincidentes. Un clic, y los tres campos se rellenan a la vez con una dirección normalizada. Tres interacciones, cero pulsaciones perdidas.
Integración sin fricción en cualquier checkout
El módulo se engancha al hook estándar actionFrontControllerSetMedia e inyecta su JavaScript y su CSS sólo en las páginas que contienen un formulario de dirección: pedido, mi dirección, mi identidad, registro. Sin sobrecarga de plantilla Smarty. Sin tablas en base de datos. Sin dependencia de un tema concreto — Classic, Hummingbird y la mayoría de temas de terceros funcionan sin configuración.
Robustez: compatible con checkout one-page y multi-formulario
El checkout one-page de PrestaShop re-renderiza el formulario de dirección en cada cambio de paso, y algunas extensiones de terceros hacen lo mismo. El módulo gestiona estos re-renderizados con un MutationObserver combinado con eventos nativos de PrestaShop: updatedAddressForm, updatedAddress, updatedDeliveryForm, changedCheckoutStep. Si se muestran dos formularios de dirección simultáneamente (envío + facturación), cada uno recibe su propio autocompletado independiente.
Rendimiento y privacidad: sin servidor intermedio
Todas las peticiones de autocompletado van directamente del navegador del cliente a la API elegida (BAN o Google). Su servidor PrestaShop nunca es consultado por el módulo durante la escritura: sin carga de CPU, sin consumo de ancho de banda, sin latencia añadida. En términos de RGPD: ningún tránsito de datos por DataFirefly, ninguna recolección en el lado de DataFirefly, ninguna cookie de terceros colocada por el módulo.
Configuración en dos minutos
Instale el módulo, abra su configuración, y ya está operativo para Francia. Para Google Places: active la opción, pegue su clave, elija la lista blanca de países. Configure el número mínimo de caracteres antes del disparo, el retardo de debounce, la activación del resaltado de coincidencias. Sin una sola línea de código que modificar.
No hay valoraciones aún.