# 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… - Página: - Idioma: es - Actualizado el: 2026-09-15 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dffitmentfinder/index.md), [en](https://www.datafirefly.com/en/documentation/dffitmentfinder/index.md), [de](https://www.datafirefly.com/de/documentation/dffitmentfinder/index.md), [it](https://www.datafirefly.com/it/documentation/dffitmentfinder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffitmentfinder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffitmentfinder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffitmentfinder/index.md) - Índice: 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. Compatible con PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3, tanto en tienda única como en multitienda. ## 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. Si la Navegación por facetas (ps_facetedsearch) está activa, el filtro de vehículo toma temporalmente el control de esas páginas mientras haya un vehículo seleccionado: la paginación, los contadores y la ordenación siguen siendo exactos. Los filtros por facetas vuelven en cuanto el cliente pausa el filtro o borra su vehículo.