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.

Ubicaciones, icono y disposición (v1.1.0)

Desde la versión 1.1.0, los interruptores «Mostrar en la cabecera» y «Mostrar en la página de inicio» se sustituyen por un bloque Mostrar el selector en: siete casillas que cubren las ubicaciones habituales del tema (cabecera, barra bajo la cabecera, página de inicio, parte superior del contenido, columnas izquierda y derecha, encima del pie de página). El campo Hooks personalizados acepta además tus propios hooks display, separados por comas: se registran automáticamente al guardar. El widget {widget name='dffitmentfinder'} sigue funcionando, independientemente de estos ajustes.

• Icono de vehículo: seis modelos incluidos (coche, garaje, impresora, teléfono, llave, chip), sin icono, o tu propia imagen PNG, JPG o SVG subida desde la configuración. El icono aparece en el botón de guardado, la insignia del vehículo actual, la página del garaje y el verificador de la ficha de producto.
• Disposición en escritorio: horizontal (campos en una fila) o vertical (campos apilados). En móvil el selector siempre se apila verticalmente.

Filtro global por vehículo (v1.2.0)

El ajuste Filtrar las páginas de categoría por el vehículo seleccionado, activado por defecto, extiende la selección a toda la tienda: mientras haya un vehículo activo, las páginas de categorías, marcas y proveedores solo muestran productos compatibles, con la ordenación y la paginación nativas de tu tema.

Una barra aparece sobre el listado con el vehículo activo y dos acciones:

• Mostrar todos los productos: pausa el filtro durante 30 días (o hasta reactivarlo). La barra sigue visible y ofrece entonces reactivar el filtro.
• Cambiar de vehículo: enlaza de vuelta al selector.