Asistente de Elección de Producto — Documentación
Instala y configura el Asistente de Elección de Producto: constructor de cuestionario, mapeo de respuestas, motor de coincidencia, visualización front y página de resultados.
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
- Ve a Módulos > Gestor de módulos > Subir un módulo.
- Selecciona el archivo
dffinder-1.0.0.zipy confirma la instalación. - El módulo crea sus tablas, una pestaña de administración DF Product Finder y las rutas reescritas
product-finderyproduct-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/maxsobre 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.