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 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.

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).

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