# Asistente de Elección de Producto — Documentación > El módulo Asistente de Elección de Producto (dffinder) convierte un catálogo complejo en un recorrido de compra guiado. Construyes un árbol de preguntas en el back office; el visitante responde… - Página: - Idioma: es - Actualizado el: 2026-07-15 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/product-finder/index.md), [en](https://www.datafirefly.com/en/documentation/product-finder/index.md), [de](https://www.datafirefly.com/de/documentation/product-finder/index.md), [it](https://www.datafirefly.com/it/documentation/product-finder/index.md), [pl](https://www.datafirefly.com/pl/documentation/asystent-wyboru-produktu-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/product-finder/index.md), [pt](https://www.datafirefly.com/pt/documentation/product-finder/index.md) - Índice: El módulo **Asistente de Elección de Producto** (`dffinder`) convierte un catálogo complejo en un recorrido de compra guiado. Construyes un árbol de preguntas en el back office; el visitante responde paso a paso y llega a una selección de productos filtrada, igual que haría un vendedor en tienda. ## Presentación El módulo está pensado para catálogos donde el cliente duda: colchones, bicicletas, informática, cosmética, recambios. Cada respuesta del cuestionario se enlaza con uno o varios criterios de tu catálogo (atributos, características, categorías, fabricantes, rangos de precios), y el módulo traduce las elecciones del visitante en una búsqueda de productos nativa. - Constructor de árbol de preguntas por arrastrar y soltar, sin código. - Preguntas de elección única o múltiple, títulos y etiquetas multiidioma. - Contador de productos coincidentes en tiempo real en cada paso. - Página de resultados nativa (ordenación y paginación del tema) mediante `ProductSearchProviderInterface`. - Visualización como widget de inicio, etiqueta widget o página dedicada. - Compatible con PrestaShop 8.0 a 9.x, multitienda y multiidioma. ## Instalación 1. Ve a _Módulos > Gestor de módulos > Subir un módulo_. 2. Selecciona el archivo `dffinder-1.0.0.zip` y confirma la instalación. 3. El módulo crea sus tablas, una pestaña de administración **DF Product Finder** y las rutas reescritas `product-finder` y `product-finder/results`. Tras la instalación, si las URL `product-finder` no responden, regenera los enlaces: _Parámetros avanzados > Rendimiento > Vaciar caché_, y comprueba que las URL amigables estén activadas en _Tráfico & SEO_. ## Crea tu primer finder Abre _Módulos > DF Product Finder_ y haz clic en **Añadir un finder**. Dale un nombre interno y un texto de introducción que se muestra en la parte superior del cuestionario. El constructor se organiza en columnas: las preguntas a la izquierda, las respuestas de cada pregunta y los mapeos de cada respuesta. ### Añadir preguntas Haz clic en **Añadir una pregunta**. Para cada pregunta, indica: - el **título** (p. ej. «¿Para qué uso?») y un **texto de ayuda** opcional; - el **tipo de visualización**: elección única (una sola respuesta, con avance automático) o elección múltiple (varias respuestas marcables); - el orden, arrastrando la pregunta a la posición deseada. ### Añadir respuestas Bajo cada pregunta, añade las respuestas ofrecidas al visitante (p. ej. «Deporte», «Ciudad», «Niño»). Cada respuesta tiene una etiqueta multiidioma y se puede reordenar por arrastrar y soltar dentro de su pregunta. ### Mapear las respuestas al catálogo Este es el núcleo del módulo: cada respuesta apunta a uno o varios criterios de producto. Los tipos de mapeo disponibles son: - **Atributo** — un valor de atributo de combinación (talla, color…), buscado en las combinaciones de producto; - **Característica** — un valor de característica de producto; - **Categoría** — la pertenencia a una categoría; - **Fabricante** — la marca del producto; - **Precio** — un rango `min`/`max` sobre el precio base de la tienda. Los campos atributo, característica, categoría y fabricante disponen de autocompletado: escribe unas letras para encontrar el valor. Una misma respuesta puede combinar varios mapeos (por ejemplo una categoría _y_ un rango de precios). Los rangos de precios filtran sobre el **precio base sin impuestos** del producto para la tienda actual (`product_shop.price`). Los impuestos y los precios específicos (promociones, precios por grupo) no se aplican en este filtro. Cuando tu árbol esté listo, haz clic en **Guardar**. El guardado es idempotente: el árbol completo se reconstruye en cada guardado, lo que garantiza un estado coherente. ## Entender el motor de coincidencia El módulo combina las elecciones del visitante con dos reglas sencillas: - **O** entre las respuestas de una misma pregunta: marcar «Deporte» y «Ciudad» amplía la selección a los productos que coinciden con una u otra. - **Y** entre preguntas: los criterios de cada pregunta superada se acumulan para acotar la selección. En cada paso, el módulo recalcula mediante AJAX el número de productos coincidentes y lo muestra al visitante, lo que evita llegar a una selección vacía. ## Mostrar el finder ### Widget de inicio Activa la visualización en la página de inicio desde la configuración del módulo. El widget muestra una tarjeta de llamada a la acción que lleva al cuestionario. ### Etiqueta widget Para insertar el finder en cualquier lugar de una plantilla de tu tema, usa la etiqueta Smarty: ``` {widget name='dffinder' id_finder=1} ``` Sustituye `id_finder` por el identificador del finder deseado (visible en la lista del back office). ### URL dedicadas El cuestionario también es accesible directamente mediante URL limpias, prácticas para tus campañas: - `tu-tienda/product-finder` — el cuestionario; - `tu-tienda/product-finder/results?answers=1,4,9` — la página de resultados. ## La página de resultados Al final del cuestionario, el visitante es dirigido a una página de resultados que extiende el controlador de listado nativo de PrestaShop. En concreto, obtienes sin configuración adicional: - la plantilla de lista de productos de tu tema; - la ordenación por fecha, precio o nombre; - la paginación estándar. Un enlace **Reiniciar** permite al visitante relanzar el cuestionario desde el principio. ## Multitienda y multiidioma El módulo está vinculado al contexto de tienda: cada finder pertenece a la o las tiendas que elijas. Todos los textos (nombre, introducción, títulos de preguntas, etiquetas de respuestas) se pueden introducir por idioma gracias al selector de idioma de edición situado en la parte superior del constructor. ## Resolución de problemas **El contador siempre muestra cero.** Comprueba que los mapeos apunten a valores realmente usados por tus productos (atributo/característica bien asignado a los productos) y que los productos estén activos y asociados a la tienda actual. **El rango de precios no filtra como se espera.** Recuerda que el filtro se aplica al precio base sin impuestos, sin precios específicos. Un producto en promoción se sigue filtrando por su precio de catálogo. **Buena práctica.** Empieza con una pregunta general (uso, perfil) y luego afina (presupuesto, talla). Limita cada pregunta a unas pocas respuestas claras para mantener un recorrido fluido.