# Koopgidsen PrestaShop 8 & 9: documentatie > Overzicht De module maakt koopgidspagina's op basis van je catalogus. Elke gids beantwoordt een vraag van de klant, bijvoorbeeld 'Welke robotstofzuiger kies je voor een appartement met huisdieren?'. Je kiest… - Pagina: - Taal: nl - Bijgewerkt op: 2026-09-24 - Andere talen: [fr](https://www.datafirefly.com/documentation/buying-guide-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/buying-guide-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/buying-guide-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/buying-guide-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/buying-guide-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/buying-guide-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/buying-guide-prestashop/index.md) - Index: ## Overzicht De module maakt koopgidspagina's op basis van je catalogus. Elke gids beantwoordt een vraag van de klant, bijvoorbeeld 'Welke robotstofzuiger kies je voor een appartement met huisdieren?'. Je kiest de vergeleken producten en de criteria, de module berekent voor elk product een score op 100, wijst drie keuzes aan en genereert de ranglijst, de vergelijkingstabel, de statistieken en de FAQ. De ranglijst wordt herberekend wanneer de catalogus verandert. ## Installatie 1. Klik in **Modules > Modulebeheer** op **Een module uploaden** en kies `dfbuyingguide-1.1.0.zip`. 2. De installatie maakt het tabblad **Catalogus > Koopgidsen**, de moduletabellen en de map `img/dfbuyingguide/` voor de omslagafbeeldingen. 3. De knop **Configureren** van de module opent dit tabblad direct. Vanaf versie 1.0.0 upload je gewoon de ZIP 1.1.0: het updatescript voegt de kolommen en statistiektabellen toe zonder je gidsen te wijzigen. ## Algemene instellingen Het paneel **Instellingen** onder de lijst met gidsen bevat: - **URL-prefix**: standaard `guides`. De gidsen staan op `/guides/url-van-de-gids` en het overzicht van alle gidsen op `/guides`. - **Maximale leeftijd van een ranglijst**: standaard 12 uur. Daarna wordt een ranglijst bij het volgende bezoek herberekend, ook zonder cataloguswijziging, zodat geplande acties worden gevolgd. - **Geanalyseerde producten per gids**: standaard 300. De best verkochte producten van het bereik worden eerst geanalyseerd. Verhoog de waarde voor grote categorieën, tot 5.000. - **Gidsbadge op productpagina's tonen**: producten met een keuze of een plaats in de top 3 tonen een link naar de gids. - **Gidsen op categoriepagina's tonen**: een blok onderaan de categorieën toont de gidsen waarvan het bereik de categorie bevat. - **Bereik en verkopen meten**: schakelt de statistieken en de toewijzingscookie `dfbg_attr` in (zie verderop). ## Een gids maken Klik op **Koopgids toevoegen**. De belangrijkste velden: - **Titel**: schrijf hem als de vraag van de klant. Een gids wordt alleen gepubliceerd in de talen waarin hij een titel heeft. - **Vriendelijke URL**: wordt uit de titel gemaakt als het veld leeg blijft. - **Omslagafbeelding**: getoond bovenaan de gids, op de gidsenpagina en bij delen op sociale media. Liggend formaat, minstens 1.200 px breed. De afbeelding wordt verkleind tot maximaal 1.600 px breed. - **Auteur** en **Functie van de auteur**: getoond onder de titel en opgenomen in de gestructureerde data. - **Inleiding**: voor wie de gids bedoeld is en wat telt bij dit gebruik. - **Vergeleken producten**: de categorieën van het bereik. Geen categorie aangevinkt betekent de hele catalogus. **Subcategorieën meenemen** staat standaard aan. - **Minimumprijs** en **Maximumprijs**: 0 betekent geen grens. Het gaat om de prijs die bezoekers zien, in de standaardvaluta. Handig voor een gids als 'de beste modellen onder € 300'. - **Alleen producten op voorraad**: sluit uitverkochte producten uit wanneer voorraadbeheer aan staat. - **Producten in de ranglijst**: 1 tot 20, standaard 5. De keuzes worden altijd getoond, ook buiten deze ranglijst. - **Drempel van de keuze klein budget**: standaard 50% (zie 'De drie keuzes'). - **Bezoekers de ranglijst laten aanpassen**, **Vergelijkingstabel tonen**, **FAQ tonen**. - **Extra vragen**: één vraag per regel, in de vorm `Vraag | Antwoord`. Ze worden na de gegenereerde vragen toegevoegd. - **Conclusie**, **Metatitel** en **Metabeschrijving**: de titel en het begin van de inleiding dienen als standaardwaarden. - **Gepubliceerd**: een niet-gepubliceerde gids kun je vanuit de back-office als voorbeeld bekijken. Klik op **Opslaan en blijven**: onder het formulier verschijnen de panelen voor criteria, huidige ranglijst, bereik en geschiedenis. ## De criteria Zonder criteria worden de producten op verkopen gerangschikt. Klik op **Criterium toevoegen** en kies een soort. ### Soorten criteria - **Kenmerk: voorkeurswaarden**: je geeft 0 tot 100 punten aan elke waarde van een kenmerk, bijvoorbeeld Materiaal: roestvrij staal 100, aluminium 70, kunststof 30. Na de eerste keer opslaan toont het formulier alle waarden van het kenmerk met een schuifregelaar en knoppen om alle waarden in één keer in te vullen. Een product met meerdere waarden houdt de beste. - **Kenmerk: numerieke waarde**: de module leest het getal in de waarde ('90 min', '1.200 W', '2,5 kg') en vergelijkt de producten. Kies bij **Voorkeurswaarden** of hoger of lager beter is. **Minimumwaarde** en **Maximumwaarde** sluiten producten buiten het bereik of zonder waarde uit. **Eenheid** wordt toegevoegd aan de getallen in de statistieken. - **Prijs (lager is beter)**. - **Verkoop (populariteit)**: op basis van de verkochte aantallen. - **Nieuwe producten**: op basis van de datum waarop het product is toegevoegd. ### Gewicht, verplichting en teksten - **Gewicht**: 0 tot 10. Gewicht 0 toont het criterium in de vergelijkingstabel zonder het in de score mee te tellen. - **Verplicht** (kenmerkcriteria): producten zonder dit kenmerk, of met een waarde van 0 punten, worden uit de gids gelaten. - **Label getoond aan bezoekers**: blijft het leeg, dan wordt de naam van het kenmerk gebruikt. - **Koopadvies**: legt uit waarom dit criterium telt. Het verschijnt in de sectie 'Hoe kiezen', boven de catalogusstatistieken. Met de pijlen in de lijst met criteria wijzig je hun volgorde in de vergelijkingstabel en in de sectie 'Hoe kiezen'. ## Berekening van de score Voor elk criterium worden de waarden van de producten op een schaal van 0 tot 100 gebracht: bij numerieke criteria, prijs, verkopen en nieuwheid krijgt het beste product van het bereik 100 en het zwakste 0, bij waardecriteria gelden de punten die je hebt gegeven. De totaalscore is het gemiddelde van de scores, gewogen naar het gewicht van de criteria. Prijzen worden in de standaardvaluta vergeleken. Het paneel **Huidige ranglijst** toont de eerste 20 producten met hun totaalscore, prijs, keuze en een scorekolom per criterium. Gebruik het om de gewichten af te stemmen vóór publicatie. ## De drie keuzes - **Beste keuze**: het product op de eerste plaats. - **Beste prijs-kwaliteitverhouding**: onder de producten die goedkoper zijn dan de beste keuze en minstens 60% van diens score halen, het product met de beste verhouding tussen score en prijs. - **Beste bij klein budget**: het goedkoopste product dat het in **Drempel van de keuze klein budget** ingestelde percentage van de score van de beste keuze haalt, als het goedkoper is dan de twee andere keuzes. Een keuze verschijnt alleen als een product aan de voorwaarde voldoet. De sterke punten van een product zijn zijn criteria met 70 of meer (maximaal 3), de aandachtspunten die met 30 of minder (maximaal 2). ## Bijwerken van de ranglijsten Een wijziging van een product, een specifieke prijs, een kenmerkwaarde of een categorie markeert de ranglijsten voor herberekening. Een voorraadwijziging markeert alleen de gidsen met 'Alleen producten op voorraad'. De herberekening gebeurt: - bij het volgende bezoek aan de gids; - via de cronjob, als je die inplant; - met de knop **Nu herberekenen** van een gids of **Alle ranglijsten nu herberekenen** in de lijst. ### Cronjob De cron-URL staat boven de lijst met gidsen. Roep hem elk uur aan zodat bezoekers nooit op een herberekening wachten. Voeg `&force=1` toe om alle gidsen te herberekenen. De knop **Nieuw token** vervangt het token, waarna de oude URL niet meer werkt. Voorbeeld: ``` 0 * * * * curl -s "https://jouw-winkel.nl/index.php?fc=module&module=dfbuyingguide&controller=cron&token=JOUW_TOKEN" > /dev/null ``` ### Getoonde datum en geschiedenis De datum 'Ranglijst bijgewerkt op' die bezoekers zien, verandert alleen als de top van de ranglijst of de keuzes veranderen. Het paneel **Geschiedenis van de aanbevelingen** toont deze wijzigingen met de eerste 5 producten per datum. De hooks van een module worden niet uitgevoerd voor een medewerker wiens profiel geen recht 'Bekijken' op de module heeft. Bewerkt je team de catalogus met zo'n profiel, dan dienen de cronjob en de maximale leeftijd van de ranglijsten als vangnet. ## De gidspagina In deze volgorde: titel, auteur, aantal vergeleken producten en updatedatum, omslagafbeelding, inleiding, inhoudsopgave, keuzes, ranglijst, vergelijkingstabel, sectie 'Hoe kiezen', conclusie, FAQ, een toelichting op de methode en verwante gidsen (gepubliceerde gidsen die een categorie delen). ### De ranglijst aanpassen Staat de optie aan en heeft de gids minstens 2 gewogen criteria, dan biedt een paneel boven de ranglijst een schuifregelaar voor het belang van elk criterium en een schuifregelaar voor het maximale budget. De ranglijst wordt in de browser herberekend onder de 20 beste producten, zonder herladen, en een link zet de ranglijst van de gids terug. Zonder JavaScript blijft het paneel verborgen. Zoekmachines zien altijd de ranglijst van de gids. ### In winkelwagen Producten die direct in de winkelwagen kunnen, zonder te kiezen combinatie, tonen een knop **In winkelwagen** die de winkelwagenfunctie van het thema gebruikt. De andere tonen **Bekijk het product**. In catalogusmodus wordt geen winkelwagenknop getoond. ### Voorbeeld van een niet-gepubliceerde gids De knop **Voorbeeld van de gids** opent de pagina met een voorbeeldbanner. De link bevat een token voor die gids, de pagina staat op `noindex` en de statistieken tellen niet mee. ### Kleuren aanpassen De kleuren zijn vastgelegd in CSS-variabelen die je thema kan overschrijven: `--dfbg-accent`, `--dfbg-accent-soft`, `--dfbg-muted`, `--dfbg-line`, `--dfbg-surface`, `--dfbg-low` en `--dfbg-radius`. De lettertypen komen uit het thema. ## Plaatsingen en SEO - **Overzicht van de gidsen**: `/guides`, met de omslagafbeelding of het product op de eerste plaats van elke gids. - **Categoriepagina's**: hook `displayFooterCategory`. - **Productpagina's**: hook `displayProductAdditionalInfo`, keuzebadge of 'Plaats X' met link naar de gids. - **Vrije plaatsing**: `{hook h='displayDfBuyingGuides' id_category=12}` in een template van het thema. Zonder `id_category` worden alle gidsen getoond. - **Sitemap**: als de standaardmodule gsitemap is geïnstalleerd, worden het overzicht en de gidsen toegevoegd met de datum van hun laatste aanbevelingswijziging. - **Gestructureerde data**: Article (met auteur en afbeelding), ItemList van de ranglijst en FAQPage. Open Graph-tags worden in de head toegevoegd. - **Meertalig**: canonical, hreflang naar elke taal waarin de gids een titel heeft, en 301-redirect wanneer een URL in een andere taal wordt geopend. ## Bereik en verkopen De lijst met gidsen toont weergaven en omzet van de laatste 30 dagen, en bovenaan vier algemene indicatoren. Elke gids heeft een paneel **Bereik en verkopen** voor 30 dagen en sinds het begin: - **Weergaven**: één per bezoeker, per gids en per dag, zonder bots. - **Productklikken** en klikratio ten opzichte van de weergaven. - **Klikken op In winkelwagen** vanuit de ranglijst. - **Bezoekers die de ranglijst aanpasten**. - **Bestellingen** en conversieratio ten opzichte van de weergaven. - **Omzet excl. btw**: bedrag excl. btw van de producten die uit de gids kwamen, omgerekend naar de standaardvaluta. ### Toewijzing van verkopen Klikt een bezoeker vanuit een gids op een product, dan onthoudt de eigen cookie `dfbg_attr` het product en de gids 30 dagen. Komt het product in de winkelwagen, dan wordt de toewijzing naar de winkelwagen gekopieerd. Bij de validatie van de bestelling, ook via een betaalwebhook, worden de bestelling en het bedrag excl. btw van dat product aan de gids toegekend. Alleen gevalideerde bestellingen (status betaald of gelijkwaardig) tellen mee. De cookie `dfbg_attr` wordt bij het klikken geplaatst zonder via je toestemmingsbeheer te gaan. Vermeld hem in je cookiebeleid of schakel **Bereik en verkopen meten** uit. ## Een gids dupliceren De actie **Dupliceren** in de lijst kopieert de gids met zijn criteria, punten per waarde, winkels en afbeelding. De kopie wordt niet-gepubliceerd aangemaakt, met een URL met achtervoegsel, en opent direct om te bewerken. ## Multistore Elke gids wordt gekoppeld aan de winkels die in zijn formulier zijn gekozen. Ranglijsten, geschiedenis en statistieken worden per winkel berekend. ## Probleemoplossing - **'Er past momenteel geen product bij deze gids'**: controleer de categorieën, het prijsbereik, de voorraadoptie en de verplichte criteria of criteria met grenzen. - **Een verwacht product ontbreekt**: het moet actief zijn, zichtbaar in de catalogus en bij de geanalyseerde producten horen. Verhoog 'Geanalyseerde producten per gids' voor grote categorieën. - **De gids geeft een 404-fout**: hij is niet gepubliceerd, heeft geen titel in deze taal of is niet aan deze winkel gekoppeld. - **De ranglijst volgt een wijziging niet**: klik op 'Nu herberekenen' en plan de cronjob in. - **De omslagafbeelding wordt geweigerd**: controleer of de map `img/dfbuyingguide/` schrijfbaar is.