Productkeuze-assistent — Documentatie
De Productkeuze-assistent installeren en configureren: vragenlijstbuilder, antwoordmapping, matchingengine, frontweergave en resultatenpagina.
De Productkeuze-assistent (module dffinder) verandert een complexe catalogus in een begeleid kooptraject. U bouwt een vragenboom in de backoffice; de bezoeker beantwoordt de vragen stap voor stap en komt uit op een gefilterde productselectie, precies zoals een verkoopadviseur in de winkel zou doen.
Presentatie
De module is bedoeld voor catalogi waar de klant twijfelt: matrassen, fietsen, informatica, cosmetica, onderdelen. Elk antwoord in de vragenlijst is gekoppeld aan een of meer criteria van uw catalogus (attributen, kenmerken, categorieën, fabrikanten, prijsbereiken), en de module vertaalt de keuzes van de bezoeker naar een native productzoekopdracht.
- Vragenboombuilder met drag-and-drop, zonder code.
- Vragen met enkelvoudige of meervoudige keuze, meertalige titels en labels.
- Realtime teller van overeenkomende producten bij elke stap.
- Native resultatenpagina (sortering en paginering van het thema) via
ProductSearchProviderInterface. - Weergave als homepagewidget, widgettag of aparte pagina.
- Compatibel met PrestaShop 8.0 tot 9.x, multistore en meertalig.
Installatie
- Ga naar Modules > Modulebeheer > Een module uploaden.
- Selecteer het archief
dffinder-1.0.0.zipen bevestig de installatie. - De module maakt haar tabellen aan, een beheertabblad DF Product Finder en de herschreven routes
product-finderenproduct-finder/results.
Als de URL’s product-finder na de installatie niet reageren, regenereer dan de links: Geavanceerde instellingen > Prestaties > Cache legen, en controleer of de vriendelijke URL’s zijn ingeschakeld in Verkeer & SEO.
Een eerste finder aanmaken
Open Modules > DF Product Finder en klik op Finder toevoegen. Geef hem een interne naam en een introductietekst die boven de vragenlijst wordt getoond. De builder is georganiseerd in kolommen: de vragen links, de antwoorden van elke vraag, en de mappings van elk antwoord.
Vragen toevoegen
Klik op Vraag toevoegen. Vul voor elke vraag in:
- de titel (bijv. “Voor welk gebruik?”) en een optionele helptekst;
- het weergavetype: enkelvoudige keuze (één antwoord, met automatisch doorgaan) of meervoudige keuze (meerdere aanvinkbare antwoorden);
- de volgorde, door de vraag naar de gewenste positie te slepen.
Antwoorden toevoegen
Voeg onder elke vraag de antwoorden toe die aan de bezoeker worden voorgesteld (bijv. “Sport”, “Stad”, “Kind”). Elk antwoord heeft een meertalig label en kan binnen zijn vraag met drag-and-drop worden herordend.
Antwoorden mappen op de catalogus
Dit is het hart van de module: elk antwoord verwijst naar een of meer productcriteria. De beschikbare mappingtypes zijn:
- Attribuut: een attribuutwaarde van een variant (maat, kleur…), gezocht op de productcombinaties;
- Kenmerk: een waarde van een productkenmerk;
- Categorie: het behoren tot een categorie;
- Fabrikant: het merk van het product;
- Prijs: een bereik
min/maxop de basisprijs van de winkel.
De velden attribuut, kenmerk, categorie en fabrikant beschikken over autocomplete: typ enkele letters om de waarde terug te vinden. Eenzelfde antwoord kan meerdere mappings combineren (bijvoorbeeld een categorie en een prijsbereik).
De prijsbereiken filteren op de basisprijs exclusief btw van het product voor de huidige winkel (product_shop.price). Btw en specifieke prijzen (promoties, groepsprijzen) worden in dit filter niet toegepast.
Klik wanneer uw boom klaar is op Opslaan. De opslag is idempotent: de volledige boom wordt bij elke opslag opnieuw opgebouwd, wat een consistente staat garandeert.
De matchingengine begrijpen
De module combineert de keuzes van de bezoeker volgens twee eenvoudige regels:
- OF tussen de antwoorden van eenzelfde vraag: “Sport” en “Stad” aanvinken verbreedt de selectie naar producten die aan het ene of het andere voldoen.
- EN tussen de vragen: de criteria van elke doorlopen vraag stapelen zich op om de selectie te verfijnen.
Bij elke stap herberekent de module via AJAX het aantal overeenkomende producten en toont het aan de bezoeker, wat voorkomt dat men op een lege selectie uitkomt.
De finder tonen
Homepagewidget
Schakel de weergave op de homepage in via de moduleconfiguratie. De widget toont een call-to-actionkaart die naar de vragenlijst leidt.
Widgettag
Om de finder waar dan ook in een template van uw thema in te voegen, gebruikt u de Smarty-tag:
{widget name='dffinder' id_finder=1}Vervang id_finder door de identificatie van de gewenste finder (zichtbaar in de backofficelijst).
Aparte URL’s
De vragenlijst is ook rechtstreeks bereikbaar via nette URL’s, handig voor uw campagnes:
uw-winkel/product-finder: de vragenlijst;uw-winkel/product-finder/results?answers=1,4,9: de resultatenpagina.
De resultatenpagina
Aan het einde van de vragenlijst wordt de bezoeker naar een resultatenpagina geleid die de native listingcontroller van PrestaShop uitbreidt. Concreet krijgt u zonder extra instellingen:
- het productlijstsjabloon van uw thema;
- de sortering op datum, prijs of naam;
- de standaardpaginering.
Een link Opnieuw beginnen laat de bezoeker de vragenlijst vanaf het begin herstarten.
Multistore en meertalig
De module is gekoppeld aan de winkelcontext: elke finder behoort tot de winkel(s) van uw keuze. Alle teksten (naam, introductie, vraagtitels, antwoordlabels) zijn per taal invoerbaar dankzij de taalselector bovenaan de builder.
Probleemoplossing
De teller toont altijd nul. Controleer of de mappings verwijzen naar waarden die daadwerkelijk door uw producten worden gebruikt (attribuut/kenmerk correct aan de producten toegewezen), en of de producten actief zijn en aan de huidige winkel gekoppeld.
Het prijsbereik filtert niet zoals verwacht. Onthoud dat het filter geldt op de basisprijs exclusief btw, zonder specifieke prijzen. Een product in promotie blijft gefilterd op zijn catalogusprijs.
Goede praktijk. Begin met een algemene vraag (gebruik, profiel) en verfijn daarna (budget, maat). Beperk elke vraag tot enkele duidelijke antwoorden om het traject vlot te houden.