DataFirefly Dealer Locator: modo catálogo y mapa de distribuidores

Este módulo convierte una tienda PrestaShop 8 o 9 en un escaparate de marca: desactiva la venta online en todo o parte del catálogo, añade un botón Dónde comprar en las fichas de producto y publica un directorio de distribuidores con mapa, horarios, formulario de contacto y una página por distribuidor.

Instalació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 el menú Vender > Red de distribuidores con tres entradas: Distribuidores, Solicitudes de contacto y Configuración.
3. La página del directorio se crea automáticamente con una URL traducida por idioma: /donde-comprar, /where-to-buy, /ou-acheter, /wo-kaufen, etc.

Para actualizar, basta con subir el nuevo ZIP: los scripts de actualización añaden las columnas y los hooks que faltan. Si el directorio o las páginas de distribuidor devuelven un error 404, guarda una vez Parámetros de la tienda > Tráfico y SEO para regenerar el archivo .htaccess.

Compatibilidad: PrestaShop 8.0 a 9.x, multitienda, sin dependencias Composer. Traducciones incluidas en inglés, francés, español, alemán, italiano, neerlandés, polaco y portugués.

Configurar el modo catálogo

Abre Red de distribuidores > Configuración, bloque Modo catálogo. El modo catálogo se aplica al vuelo: el ajuste nativo de PrestaShop nunca se modifica y todo vuelve a la normalidad si desactivas el módulo.

Venta online

• Activada: el modo catálogo está desactivado, el módulo solo funciona como directorio.
• Desactivada para todo el catálogo: ningún producto puede añadirse al carrito.
• Desactivada solo para la selección: solo las categorías, marcas y productos elegidos abajo pasan a modo catálogo.
• Desactivada para todo salvo la selección: la selección se sigue vendiendo online, el resto pasa a modo catálogo.

Precios, mensaje y carrito

• Ocultar precios: si está desactivado, los precios siguen visibles. Puedes mostrar entonces una etiqueta bajo el precio, por defecto Precio de venta recomendado.
• Mensaje en la ficha de producto: texto mostrado sobre el botón, por ejemplo Este producto se vende exclusivamente a través de nuestra red de distribuidores autorizados. Déjalo vacío para ocultarlo.
• Redirigir el carrito y el pedido al directorio: en modo catálogo completo, las páginas de carrito y pedido envían al directorio.

El carrito se bloquea en el servidor: un añadido forzado mediante una URL es rechazado.

Grupos de clientes exentos

Marca los grupos que pueden seguir comprando online. Ejemplo: un grupo Distribuidores que pide su stock en la web mientras el público solo ve el catálogo.

El botón Dónde comprar

Bloque Botón Dónde comprar de la configuración:

• Productos afectados: solo los productos que no se pueden comprar online, o todos los productos.
• Texto del botón, traducible.
• Al hacer clic: abrir una ventana con el mapa y los distribuidores del producto, o ir al directorio filtrado por el producto.
• Mostrar la disponibilidad bajo el botón: Disponible en 14 distribuidores y, después, el distribuidor más cercano en cuanto el visitante ya ha hecho una búsqueda localizada.
• Mostrar las tiendas online: los distribuidores de tipo Tienda online aparecen aparte, con un botón hacia el producto en su tienda.

El botón solo muestra los distribuidores que ofrecen el producto (pestaña Productos vendidos de cada distribuidor). La ventana se abre en la última ciudad buscada por el visitante.

Directorio y mapa

Bloque Directorio de distribuidores y mapa:

• Texto de introducción sobre la búsqueda y color de acento de botones, marcadores y agrupaciones.
• Centro y zoom por defecto del mapa, unidad (km o millas), opciones de radio, radio por defecto (0 = sin límite) y número máximo de resultados.
• Estilo del mapa: CARTO Voyager, CARTO Positron, OpenStreetMap o servidor de teselas propio (URL en https con {z}, {x} y {y}).
• Preguntar antes de cargar el mapa: por el RGPD, el servidor de teselas solo recibe la IP del visitante tras un clic.
• Agrupar marcadores cercanos y un color de marcador por tipo, con leyenda en el mapa.
• Lista completa de distribuidores por país bajo el mapa, legible por los buscadores.
• Una página por distribuidor: ver más abajo.

El visitante busca por ciudad o código postal, o usa su ubicación. Puede filtrar por tipo de distribuidor y marcar Abierto ahora. En móvil, un botón alterna entre la lista y el mapa. El mapa Leaflet está alojado en el módulo: no hace falta ninguna clave API.

Geocodificación

La geocodificación convierte una dirección o una ciudad en coordenadas. Los resultados se guardan en caché en la base de datos.

• OpenStreetMap Nominatim: gratuito, limitado a una petición por segundo. Indica el email de contacto, recomendado por la política de uso de Nominatim.
• Google Geocoding API: requiere una clave API de Google.
• Limitar las búsquedas a estos países: códigos ISO separados por comas, por ejemplo es,pt,fr.

Gestionar los distribuidores

Menú Red de distribuidores > Distribuidores. La ficha de un distribuidor tiene cuatro pestañas.

General

• Nombre, tipo (tienda, distribuidor mayorista, showroom, servicio técnico, tienda online), logo (JPG, PNG, WebP o GIF, 2 MB como máximo).
• Oficial: insignia Distribuidor oficial, que aparece primero cuando no se indica ubicación.
• Teléfono, sitio web y email: el email recibe las solicitudes de contacto y nunca se muestra cuando el formulario está activado.
• Enlace al producto en la tienda del distribuidor: opcional, añade un botón Comprar online. Etiquetas disponibles: {reference} {ean13} {upc} {mpn} {name} {id_product}. Ejemplo: https://shop.example.com/search?q={ean13}
• Acceso al área de distribuidor: email de una cuenta de cliente existente (ver Área de distribuidor).

Dirección y mapa

El distribuidor se coloca en el mapa automáticamente al guardar. El botón Buscar la posición a partir de la dirección vuelve a lanzar la geocodificación, y puedes hacer clic en el mapa o arrastrar el marcador para ajustar la posición.

Descripción y horario

Descripción multiidioma, cuadrícula de horarios de 7 días con dos franjas por día (la segunda sirve para la pausa del mediodía), botones para copiar el lunes en los demás días y campo Información útil para festivos o cierres de temporada. Un día vacío significa cerrado. Los horarios alimentan la insignia y el filtro Abierto ahora, calculados en la zona horaria de la tienda.

Productos vendidos

Elige Toda la gama o una selección de categorías, marcas y productos. Solo los distribuidores que ofrecen un producto aparecen en su botón Dónde comprar.

Importación y exportación CSV

Botón Importar CSV de la lista de distribuidores. Formato: UTF-8, separado por punto y coma, primera línea con los nombres de las columnas. Lo más sencillo es exportar primero tus distribuidores para obtener un archivo listo para usar.

Columnas: id;name;type;active;featured;address1;address2;postcode;city;country_iso;phone;email;website;product_url;latitude;longitude;scope;categories;manufacturers;products;description;hours;opening

• Solo name es obligatorio. Deja id vacío para crear un distribuidor, o marca la actualización de los distribuidores existentes.
• type: retailer, distributor, showroom, service u online. country_iso: código de dos letras.
• scope: 0 para toda la gama, 1 para las categorías, marcas y productos indicados, separados por una barra vertical: 3|8|12.
• opening: número del día (1 = lunes) y franjas horarias, días separados por una barra: 1=09:00-12:00,14:00-19:00/2=09:00-19:00/6=10:00-18:00

Tras importar distribuidores sin coordenadas, haz clic en Colocar en el mapa los distribuidores importados: la geocodificación se hace por lotes, a razón de una dirección por segundo. Mantén la página abierta durante la operación.

Solicitudes de contacto

Bloque Solicitudes de contacto de la configuración: activa el formulario en cada distribuidor, el envío por email al distribuidor, una copia a tu dirección, el texto de la casilla de consentimiento y la página de política de privacidad.

El formulario está protegido contra el spam (campo trampa, tiempo mínimo, cinco envíos por hora y por dirección IP). Las solicitudes aparecen en Red de distribuidores > Solicitudes de contacto, con filtros, vista detallada, estado tratada o pendiente y exportación CSV.

Área de distribuidor

Activa Área de distribuidor en la cuenta de cliente y luego introduce en la ficha de un distribuidor el email de una cuenta de cliente existente. Al conectarse, ese cliente ve una tarjeta Área de distribuidor en Mi cuenta. Puede:

• modificar su teléfono, sitio web, horarios, Información útil y descripción en su idioma;
• leer sus solicitudes de contacto y marcarlas como tratadas;
• ver sus estadísticas de 30 días: visitas al sitio web, clics en el teléfono, indicaciones, solicitudes.

La dirección y la posición en el mapa siguen gestionadas por la marca. Una misma cuenta puede gestionar varios distribuidores.

Páginas de distribuidor y SEO

Con la opción Una página por distribuidor, cada distribuidor (salvo las tiendas online) tiene una página del tipo /donde-comprar/12/lumiere-co-lyon: dirección, mapa, horarios, descripción, formulario de contacto y distribuidores cercanos. Las páginas incluyen datos estructurados Store con horarios schema.org y una URL canónica, y redirigen con un 301 si cambian el nombre o la ciudad. Se añaden automáticamente al sitemap si el módulo Google Sitemap (gsitemap) está instalado.

Estadísticas

La página de configuración muestra la actividad de los últimos 30 días: distribuidores más contactados con el detalle de clics (web, teléfono, cómo llegar, compra online, solicitudes) y productos con más clics en Dónde comprar.

Integración en el tema

El botón se muestra automáticamente mediante el hook displayProductAdditionalInfo. Para colocarlo en otro lugar, usa el widget:

• buscador de distribuidores: {widget name='dfdealerlocator'}
• botón Dónde comprar de un producto: {widget name='dfdealerlocator' id_product=$product.id}

Solución de problemas

El mapa se queda gris

El servidor de teselas probablemente está bloqueado por una política de seguridad (CSP) o un cortafuegos. Autoriza el dominio del estilo elegido (basemaps.cartocdn.com o tile.openstreetmap.org) o usa un servidor propio.

El botón Dónde comprar no aparece

Comprueba que tu tema llama al hook displayProductAdditionalInfo en la ficha de producto y que el ajuste Productos afectados corresponde al producto probado. Si no, inserta el widget en la plantilla de producto.

No se encuentra una dirección

Indica al menos la ciudad o el código postal y el país, y haz clic en Buscar la posición a partir de la dirección. Si sigue sin encontrarse, coloca el marcador a mano en el mapa.

Error 404 en el directorio o en una página de distribuidor

Regenera el .htaccess guardando Tráfico y SEO y comprueba que la URL amigable de la página module-dfdealerlocator-directory está indicada en cada idioma.