PS PrestaShop Principiante

Detectar el idioma y el país del visitante (sin redirección)

Instala, configura y prueba la sugerencia de idioma, moneda y tienda, sin redirección.

Actualizado Versión del módulo 2.0.0

Presentación

El módulo detecta el país del visitante y los idiomas de su navegador y le ofrece, en un banner no bloqueante, la misma página en el idioma, la moneda o la tienda adecuados. Nunca redirige: el visitante mantiene el control, los rastreadores reciben la página que han pedido y tus etiquetas hreflang se quedan como están.

Compatible con PrestaShop 1.7.8 a 9.x, tienda única, multitienda y multidominio. No se carga nada en la tienda si solo tiene un idioma y una moneda.

Barra inferior: a un visitante español en la tienda francesa se le propone la misma página en español, sin redirección
Barra inferior

Novedades de la versión 2.0

  • Asistente de configuración en cinco pasos, con los países precargados para cada idioma.
  • Modo de prueba: el banner solo aparece en tu propio navegador, abierto con un enlace firmado válido 24 horas.
  • Sugerencia de moneda: a un visitante que aún ve la moneda predeterminada se le ofrece la moneda de su país, si vendes en ella.
  • Cabeceras CDN de confianza: una cabecera solo se usa cuando la has elegido, opcionalmente limitada a las direcciones de tu CDN.
  • Base de datos integrada fijada y verificada (huella SHA-256), fuentes de detección reordenables, subida de archivos .mmdb.
  • Nuevos estilos (barra superior o inferior, toast, diálogo accesible), comprobación del contraste, banderas reservadas a los países.
  • Estadísticas protegidas contra la repetición (token de un solo uso, límite por hora) y rechazos contados por país.

Instalación y actualización

  1. En Módulos > Gestor de módulos, haz clic en Subir un módulo y envía el archivo ZIP.
  2. El módulo crea un destino por cada par tienda e idioma activo y se abre en el Asistente de configuración.
  3. Tras una instalación nueva, el módulo está en modo de prueba: tus visitantes no ven nada hasta que lo pongas en producción.

Al actualizar desde la 1.0, la 1.1 o la 1.2 se conservan tus destinos, textos, colores y estadísticas. Dos cambios intencionados: no se usa ninguna cabecera CDN hasta que la confirmes en Geolocalización (un aviso te indica cuándo se recibe una), y la sugerencia de moneda permanece desactivada hasta que la actives.

En multitienda, instala el módulo en el contexto «Todas las tiendas» y comprueba que está activado en cada tienda de destino: es el que recuerda la elección del visitante cuando llega.

Asistente de configuración

El asistente reúne en cinco pasos lo que hay que configurar al principio. Puedes saltarlo y volver a abrirlo en cualquier momento desde su pestaña.

  1. Detección: número de tiendas, idiomas y monedas, cabecera de país recibida por la tienda, módulo del servidor web, archivo MaxMind y base de datos integrada.
  2. Idiomas y países: para cada destino, se precargan los países donde se habla el idioma (GB, US, IE, CA, AU… para el inglés). Ajústalos antes de guardar.
  3. Monedas: activación de la sugerencia y lista de los países a los que se ofrecerá otra moneda.
  4. Apariencia: estilo, colores y banderas, con vista previa en directo.
  5. Activación: probar primero, poner en producción o dejar en pausa.
Asistente de configuración, paso 1: tiendas, idiomas y monedas activos, fuentes de detección del país e instalación de la base verificada
Asistente de configuración, paso 1
Asistente, paso 2: países rellenados para cada idioma (ES, MX, AR, CO… para el español), editables antes de guardar
Asistente, paso 2
Asistente, paso 4: estilo (barra, aviso flotante, diálogo), colores, banderas solo para países y vista previa en directo
Asistente, paso 4
Asistente, paso 5: compromisos (sin redirección, caché y hreflang preservados) y elección entre probar primero, activar o dejar en pausa
Asistente, paso 5

Geolocalización

El idioma del navegador siempre se conoce. El país sirve para sugerir una tienda o una moneda. Hay cuatro fuentes disponibles; gana la primera que conoce el país y tú fijas su orden con las flechas:

  • Cabecera del CDN (Cloudflare, CloudFront, Vercel, App Engine, Fastly o X-Country-Code);
  • Módulo del servidor web (mod_geoip, mod_maxminddb, geoip2 de nginx);
  • Archivo MaxMind GeoLite2 o GeoIP2, en la ubicación de PrestaShop o en la ruta que indiques;
  • Base de datos integrada, instalada desde el módulo.

La dirección IP solo se usa para la búsqueda, en memoria: nunca se almacena ni se envía a terceros.

Cualquiera puede enviar una cabecera como X-Country-Code. Elige una solo si todas las peticiones pasan por ese CDN y, preferiblemente, introduce las direcciones del CDN en Aceptarla solo desde estas direcciones. Se comparan con la dirección que se conecta al servidor web, nunca con X-Forwarded-For.

Base de datos integrada

El botón Instalar la base descarga una versión fija de la base geo-whois-asn-country del proyecto ip-location-db (unos 7,5 MB, IPv4 e IPv6) desde jsDelivr, o desde unpkg como alternativa. Antes de sustituir el archivo, el módulo comprueba su tamaño exacto y su huella SHA-256; un archivo que no coincide se descarta y se conserva la base actual. El archivo se guarda en var/dflocalesuggest/, protegido del acceso web. La copia anterior se puede restaurar.

Estos datos se publican bajo la licencia CC BY 4.0 (datos de los registros de internet NRO): la atribución es obligatoria si vuelves a publicar los datos. Como la distribución npm del proyecto ya no se actualiza, se muestra la fecha de los datos: para obtener la mejor precisión, da preferencia a la cabecera de tu CDN o a un archivo MaxMind actualizado.

Fuente personalizada y subida de archivos

En Tu propia base puedes indicar la dirección HTTPS de un archivo .mmdb con su huella SHA-256 (o la dirección del archivo .sha256 publicado por la fuente); un archivo no verificado nunca se instala. La actualización programada la ejecuta el cron de tu servidor con la dirección secreta que se muestra, nunca un visitante. Sin conexiones salientes, sube directamente un archivo .mmdb.

Geolocalización: fuentes en orden, cabecera CDN de confianza limitada a las direcciones del CDN, base integrada fijada con huella SHA-256
Geolocalización

Correspondencias

Cada fila es un par tienda e idioma que el banner puede sugerir: etiqueta mostrada, países (códigos ISO, vacío = todos), idiomas del navegador (de, de-at, en-gb…) y orden de desempate mediante arrastrar y soltar. Sugerir países rellena los destinos sin países y Añadir los pares que faltan crea las filas de las nuevas tiendas o idiomas.

La tabla Monedas enumera los países cuya moneda está activa en tus tiendas. Para cada uno: automático (la moneda configurada en el país en PrestaShop o, si no, la moneda que se usa en ese país), una moneda concreta o no sugerir nunca.

Correspondencias: pares tienda e idioma con sus países e idiomas del navegador, y moneda sugerida para cada país
Correspondencias

Apariencia

En ordenador: barra inferior, barra superior, toast a la izquierda o a la derecha, o diálogo. En móvil: tarjeta flotante, barras o diálogo. Todos los estilos flotan sobre la página: nada se mueve cuando aparecen. El diálogo pide una respuesta antes de continuar; resérvalo para tiendas en las que estar en la equivocada sale caro.

  • Colores: cinco temas y cuatro colores libres. El contraste se calcula en directo y se señala por debajo de 4,5:1.
  • Banderas: «Solo países» (por defecto) muestra una bandera para una tienda o una moneda, nunca para un idioma.
  • Recordatorio compacto, retraso de visualización y cuánto tiempo se recuerda «Quedarme aquí» (30 días por defecto, en el almacenamiento local del navegador, sin cookie).
Apariencia: barra, aviso flotante o diálogo en ordenador y móvil, temas de color, control de contraste y vista previa en directo
Apariencia

Textos

El banner se redacta en el idioma sugerido: un visitante alemán lo lee en alemán en tu tienda francesa. Una sugerencia que solo afecta a la moneda se redacta en el idioma de la página. Cada idioma tiene sus mensajes de idioma, tienda y moneda, con las variables {language}, {country}, {store}, {currency} y {currency_name}. Un campo vacío usa el texto integrado.

Textos del banner por idioma: mensajes de idioma, tienda y moneda, variables {language}, {country}, {store} y {currency}
Textos del banner por idioma

Reglas

  • Idioma dentro de una tienda: decide el idioma del navegador; el país solo sirve para desempatar.
  • Entre tiendas: prevalece el país (la tienda que hace envíos al visitante, con sus precios) o prevalece el idioma.
  • Moneda: decide el país, solo mientras el visitante siga viendo la moneda predeterminada.
  • Respeto de los visitantes multilingües, ocultación para los clientes conectados, páginas sin banner (carrito y proceso de compra por defecto), espera al banner de consentimiento, límite por hora de las estadísticas, eventos de Google Tag Manager.
Reglas: prioridad idioma del navegador y país, sin redirección para los robots, caché preservada, espera del banner de consentimiento
Reglas

Probar antes de pasar a producción

El Simulador muestra, para una página, un país y unos idiomas de navegador, el banner resultante, su enlace y la puntuación de cada destino. Proporciona un enlace de vista previa válido durante una hora. En modo de prueba, abre una vez el enlace de prueba que aparece en Estadísticas: el banner aparece entonces en ese navegador durante 24 horas con la detección real, y no se cuenta nada. Los visitantes no ven nada.

Simulador: visitante de España con navegador en español en la página francesa, banner obtenido y puntuación de cada destino
Simulador

Estadísticas

Banners mostrados (una vez por visita y sugerencia), aceptados, rechazados, tasas de aceptación y de rechazo, actividad diaria, clasificaciones por país, por destino y por tipo de sugerencia, en 7, 30 o 90 días o un año, con exportación CSV. Cada banner se cuenta una sola vez; se ignoran los rastreadores y las peticiones repetidas. No se almacena ninguna dirección IP, cookie ni identificador de cliente.

Estadísticas de 30 días (datos de demostración): banners mostrados, aceptados, rechazados, por país, por destino y por tipo de sugerencia
Estadísticas de 30 días (datos de demostración)

Del lado del visitante

  • Sin redirección, ni para visitantes ni para rastreadores: Google desaconseja redirigir según el idioma o la dirección IP. Los rastreadores nunca ven el banner, que lleva data-nosnippet.
  • El enlace sugerido es la misma página en el otro idioma o tienda, idéntico a la alternativa hreflang de la página.
  • El HTML de la página es el mismo para todos; la sugerencia llega en una petición independiente que nunca se almacena en caché. El módulo funciona detrás de una caché de página completa.
  • La barra y el toast no toman el foco; Escape cierra el banner; el diálogo mantiene el foco en su interior y lo devuelve a la página al cerrarse.
Sugerencia de moneda: a un visitante de Estados Unidos que lee español se le propone ver los precios en dólares (USD)
Sugerencia de moneda
Diálogo accesible: foco en el botón principal, navegación con teclado dentro del diálogo, Esc o clic fuera para quedarse
Diálogo accesible
En el móvil: tarjeta flotante abajo, botones a todo el ancho de 44 px como mínimo, sin desplazamiento horizontal
En el móvil
Multitienda y multidominio: a un visitante del Reino Unido en la tienda francesa se le propone la UK Store, en su propio dominio
Multitienda y multidominio

Para desarrolladores

Eventos DOM en document: dfls:shown, dfls:accept, dfls:dismiss (con idioma, tienda, país, tipo y moneda). Opción dataLayer para Google Tag Manager. El hook PHP actionDflocalesuggestResponse recibe la respuesta por referencia; solo se conservan las URL de tus tiendas.

Solución de problemas

El banner no aparece

Comprueba el estado (en pausa, en prueba o en producción), que al menos dos destinos sean válidos o que haya una segunda moneda activa, que la página no esté excluida y que este navegador no haya rechazado o aceptado ya una sugerencia (borra el almacenamiento local del sitio). El simulador te indica por qué se descarta un destino.

El país sigue como «Desconocido»

Es normal desde una IP local o privada, o sin ninguna fuente de detección. Abre la pestaña Geolocalización: muestra qué fuente está activa y el país detectado para ti.

Falla la descarga de la base de datos

El mensaje indica la causa: conexión saliente bloqueada (permite HTTPS hacia cdn.jsdelivr.net y unpkg.com, o sube el archivo), carpeta sin permisos de escritura, extensión cURL ausente o huella que no coincide.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte