DF Fitment Finder — Búsqueda por vehículo y compatibilidad de productos

DF Fitment Finder añade a su tienda PrestaShop una búsqueda por compatibilidad: el cliente selecciona su vehículo (o su aparato) y el catálogo solo le muestra los productos que le valen. Esta documentación cubre la instalación, la configuración, la alimentación de la base de vehículos y la visualización en el front.

Instalación

1. Vaya a Módulos > Gestor de módulos y haga clic en Subir un módulo.
2. Suelte el archivo dffitmentfinder.zip y ejecute la instalación.
3. Haga clic en Configurar para acceder a los ajustes.

La instalación crea tres tablas (base de vehículos, equivalencias de productos, garajes de clientes), registra los hooks necesarios y añade la pestaña Vehículos bajo el menú Catálogo. No se instala ninguna sobrecarga del núcleo ni se requiere dependencia de Composer.

Configuración

Niveles de búsqueda

El selector se basa en cuatro niveles: Marca, Modelo, Año y Motorización. Los dos primeros están siempre activos; los dos últimos se activan o desactivan según su catálogo.

• Usar el año: desactívelo para un catálogo sin noción de año (cartuchos de impresora, fundas de móvil, piezas de electrodomésticos).
• Usar la motorización: desactívelo si el nivel más fino de su base es el modelo.

La búsqueda sigue siendo posible en cuanto se indican marca y modelo: el cliente nunca está obligado a llegar al nivel más fino.

Etiquetas de los niveles

Cada nivel lleva una etiqueta modificable por idioma. Por defecto: Marca, Modelo, Año, Motorización. Adáptelas a su sector:

• Recambios de coche: Marca / Modelo / Año / Motorización
• Cartuchos de impresora: Marca / Serie / — / Referencia
• Fundas de móvil: Marca / Modelo
• Electrodomésticos: Fabricante / Gama / Año / Referencia

Zonas de visualización

• Mostrar en la cabecera: el selector aparece en la parte superior de todas las páginas.
• Mostrar en la portada: el selector aparece en el contenido de la página de inicio.
• Widget: coloque el selector donde quiera en su tema con la etiqueta Smarty {widget name='dffitmentfinder'}.

Ficha de producto

• Verificación de compatibilidad: muestra bajo el precio un aviso verde (el producto vale para el vehículo actual), rojo (no vale) o neutro (ningún vehículo seleccionado).
• Tabla de equivalencias: muestra al final de la ficha la lista completa de vehículos compatibles, agrupada por marca y plegable.

Resultados por página

Número de productos mostrados por página en la página de resultados. Valor por defecto: 12.

Alimentar la base de vehículos

Introducción manual

Vaya a Catálogo > Vehículos. El botón Añadir abre el formulario de un vehículo:

• Marca y Modelo: obligatorios.
• Año de inicio y Año de fin: opcionales. Si se dejan vacíos, el vehículo se considera válido para todos los años. Si se rellenan, definen un rango: un vehículo 2012–2019 aparecerá en cada uno de los años del rango en el selector.
• Motorización: opcional, es el nivel más fino (por ejemplo «1.2 PureTech»).
• Activo: un vehículo inactivo ya no aparece en el selector pero conserva sus equivalencias.

Asignar productos a un vehículo

Una vez guardado el vehículo, aparece un panel Productos compatibles al final de su formulario. Escriba al menos dos caracteres (nombre o referencia) en el campo de búsqueda, haga clic en un resultado y el producto queda asignado de inmediato. El campo Nota, opcional, permite precisar el alcance de la compatibilidad: «solo eje delantero», «caja manual», «a partir del bastidor n.º 12000»… Esta nota se muestra en la tabla de equivalencias de la ficha de producto.

Importación CSV

Para bases voluminosas, la importación CSV es la vía recomendada. El archivo esperado tiene seis columnas:

make;model;year_from;year_to;variant;references

Ejemplo:

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• El separador, punto y coma o coma, se detecta automáticamente.
• La columna references contiene las referencias de producto compatibles, separadas por una barra vertical.
• Las columnas de años y de motorización pueden quedar vacías.
• Un vehículo ya presente en la base no se duplica: sus equivalencias simplemente se completan.
• Al final de la importación, un informe indica cuántos vehículos se crearon, cuántas equivalencias se añadieron y cuántas líneas fallaron.

Exportación CSV

El botón Exportar a CSV, en la página de configuración del módulo, descarga la base completa en el mismo formato. Práctico para retrabajar los datos en una hoja de cálculo y volver a importarlos.

El recorrido del cliente

Selección del vehículo

El cliente elige su marca, luego su modelo, luego (si los niveles están activos) su año y su motorización. Cada menú se rellena a partir del anterior, sin recargar la página. El botón Buscar abre la página de resultados, que muestra los productos compatibles con las miniaturas nativas de su tema.

El vehículo seleccionado queda memorizado y se recuerda en todas las páginas, hasta que el cliente lo cambie o lo borre.

Mi garaje

El botón Añadir a mi garaje guarda el vehículo actual. La página Mi garaje, accesible desde el área de cliente, enumera los vehículos guardados y permite:

• designar un vehículo como vehículo actual;
• ver directamente los productos compatibles con un vehículo;
• eliminar un vehículo del garaje.

El garaje funciona también para los visitantes sin cuenta: sus vehículos se conservan y se asignan automáticamente a su cuenta en cuanto inician sesión o se registran.

En la ficha de producto

Si la verificación de compatibilidad está activada y hay un vehículo actual seleccionado, aparece un aviso bajo el precio: verde si el producto es compatible, rojo si no lo es. Sin vehículo seleccionado, un mensaje neutro invita al cliente a elegir uno.

Si la tabla de equivalencias está activada, la ficha muestra al final la lista completa de vehículos compatibles, agrupada por marca y plegable, con la nota de cada equivalencia cuando la haya.

Preguntas frecuentes

¿Puedo usar el módulo sin noción de vehículo?

Sí. Desactive los niveles Año y Motorización, cambie las etiquetas y el módulo se convierte en un selector Marca / Serie adecuado para cartuchos, fundas, piezas de electrodomésticos o cualquier catálogo en el que la compatibilidad condicione la compra.

¿Qué ocurre con una equivalencia cuando elimino un producto?

Se elimina automáticamente. La base no conserva líneas huérfanas.

¿El selector ralentiza mi sitio?

No. Los menús se rellenan por AJAX bajo demanda, en JavaScript nativo y sin dependencia de jQuery: solo la lista de marcas se carga en la primera visualización.

¿Es compatible con multitienda?

Sí. Las equivalencias de producto y los garajes de clientes respetan el contexto de tienda.