# Assistant de Choix Produit — Documentation > L'Assistant de Choix Produit (module dffinder) transforme un catalogue complexe en un parcours d'achat guidé. Vous construisez un arbre de questions dans le back-office ; le visiteur y répond étape… - Page: - Langue: fr - Mis à jour le: 2026-07-15 - Autres langues: [en](https://www.datafirefly.com/en/documentation/product-finder/index.md), [es](https://www.datafirefly.com/es/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) - Index: L'**Assistant de Choix Produit** (module `dffinder`) transforme un catalogue complexe en un parcours d'achat guidé. Vous construisez un arbre de questions dans le back-office ; le visiteur y répond étape par étape et arrive sur une sélection de produits filtrée, exactement comme le ferait un vendeur-conseil en boutique. ## Présentation Le module s'adresse aux catalogues où le client hésite : matelas, vélos, informatique, cosmétiques, pièces détachées. Chaque réponse du questionnaire est reliée à un ou plusieurs critères de votre catalogue (attributs, caractéristiques, catégories, fabricants, fourchettes de prix), et le module traduit les choix du visiteur en une recherche produit native. - Builder d'arbre de questions en glisser-déposer, sans code. - Questions à choix unique ou multiple, titres et libellés multilingues. - Compteur de produits correspondants en temps réel à chaque étape. - Page de résultats native (tri et pagination du thème) via `ProductSearchProviderInterface`. - Affichage en widget page d'accueil, balise widget ou page dédiée. - Compatible PrestaShop 8.0 à 9.x, multiboutique et multilingue. ## Installation 1. Rendez-vous dans _Modules > Gestionnaire de modules > Téléverser un module_. 2. Sélectionnez l'archive `dffinder-1.0.0.zip` et validez l'installation. 3. Le module crée ses tables, un onglet d'administration **DF Product Finder** et les routes réécrites `product-finder` et `product-finder/results`. Après l'installation, si les URL `product-finder` ne répondent pas, régénérez les liens : _Paramètres avancés > Performances > Vider le cache_, puis vérifiez que les URL simplifiées sont activées dans _Trafic & SEO_. ## Créer un premier finder Ouvrez _Modules > DF Product Finder_ et cliquez sur **Ajouter un finder**. Donnez-lui un nom interne et un texte d'introduction affiché en tête du questionnaire. Le builder s'organise en colonnes : les questions à gauche, les réponses de chaque question, et les mappings de chaque réponse. ### Ajouter des questions Cliquez sur **Ajouter une question**. Pour chaque question, renseignez : - le **titre** (ex. « Pour quel usage ? ») et un **texte d'aide** facultatif ; - le **type d'affichage** : choix unique (une seule réponse, avec auto-avance) ou choix multiple (plusieurs réponses cochables) ; - l'ordre, en faisant glisser la question à la position voulue. ### Ajouter des réponses Sous chaque question, ajoutez les réponses proposées au visiteur (ex. « Sport », « Ville », « Enfant »). Chaque réponse possède un libellé multilingue et se réordonne par glisser-déposer au sein de sa question. ### Mapper les réponses au catalogue C'est le cœur du module : chaque réponse pointe vers un ou plusieurs critères produit. Les types de mapping disponibles sont : - **Attribut** — une valeur d'attribut de déclinaison (taille, couleur…), recherchée sur les combinaisons produit ; - **Caractéristique** — une valeur de caractéristique produit ; - **Catégorie** — l'appartenance à une catégorie ; - **Fabricant** — la marque du produit ; - **Prix** — une fourchette `min`/`max` sur le prix de base de la boutique. Les champs attribut, caractéristique, catégorie et fabricant disposent d'une autocomplétion : saisissez quelques lettres pour retrouver la valeur. Une même réponse peut cumuler plusieurs mappings (par exemple une catégorie _et_ une fourchette de prix). Les fourchettes de prix filtrent sur le **prix de base hors taxes** du produit pour la boutique courante (`product_shop.price`). Les taxes et les prix spécifiques (promotions, prix par groupe) ne sont pas appliqués dans ce filtre. Quand votre arbre est prêt, cliquez sur **Enregistrer**. La sauvegarde est idempotente : l'arbre complet est reconstruit à chaque enregistrement, ce qui garantit un état cohérent. ## Comprendre le moteur de matching Le module combine les choix du visiteur selon deux règles simples : - **OU** entre les réponses d'une même question : cocher « Sport » et « Ville » élargit la sélection aux produits correspondant à l'une _ou_ l'autre. - **ET** entre les questions : les critères de chaque question franchie se cumulent pour resserrer la sélection. À chaque étape, le module recalcule en AJAX le nombre de produits correspondants et l'affiche au visiteur, ce qui évite d'aboutir à une sélection vide. ## Afficher le finder ### Widget page d'accueil Activez l'affichage en page d'accueil depuis la configuration du module. Le widget présente une carte d'appel à l'action menant au questionnaire. ### Balise widget Pour insérer le finder n'importe où dans un template de votre thème, utilisez la balise Smarty : ``` {widget name='dffinder' id_finder=1} ``` Remplacez `id_finder` par l'identifiant du finder souhaité (visible dans la liste du back-office). ### URL dédiées Le questionnaire est également accessible directement via des URL propres, pratiques pour vos campagnes : - `votre-boutique/product-finder` — le questionnaire ; - `votre-boutique/product-finder/results?answers=1,4,9` — la page de résultats. ## La page de résultats À la fin du questionnaire, le visiteur est dirigé vers une page de résultats qui étend le contrôleur de listing natif de PrestaShop. Concrètement, vous récupérez sans réglage supplémentaire : - le gabarit de liste produit de votre thème ; - le tri par date, prix ou nom ; - la pagination standard. Un lien **Recommencer** permet au visiteur de relancer le questionnaire depuis le début. ## Multiboutique et multilingue Le module est associé au contexte boutique : chaque finder appartient à la ou aux boutiques de votre choix. Tous les textes (nom, introduction, titres de questions, libellés de réponses) sont saisissables par langue grâce au sélecteur de langue d'édition présent en haut du builder. ## Dépannage **Le compteur affiche toujours zéro.** Vérifiez que les mappings pointent vers des valeurs réellement utilisées par vos produits (attribut/caractéristique bien affecté aux produits), et que les produits sont actifs et associés à la boutique courante. **La fourchette de prix ne filtre pas comme attendu.** Rappelez-vous que le filtre s'applique au prix de base hors taxes, sans prix spécifiques. Un produit en promotion reste filtré sur son prix catalogue. **Bonne pratique.** Commencez par une question générale (usage, profil) puis affinez (budget, taille). Limitez chaque question à quelques réponses claires pour garder un parcours fluide.