PS PrestaShop PrestaShop Beginner

Product-FAQ met AI: volledige installatie- en configuratiegids

De module Product-FAQ met AI installeren en configureren: AI-aanbieder (OpenAI of Claude), eigen prompt, bulkgeneratie, FAQ-editor en FAQPage rich snippets.

Bijgewerkt Moduleversie 3.0.0

Overzicht

DataFirefly Product-FAQ met AI maakt automatisch contextuele FAQ’s aan voor uw PrestaShop 8-productfiches, via OpenAI of Anthropic Claude, met de injectie van Schema.org-FAQPage-opmaak in de head voor de rijke resultaten van Google. De FAQ’s worden in de database bewaard (tabel ps_product_faq): er gaat geen enkele API-aanroep uit aan de frontzijde.

  • Compatibiliteit: PrestaShop 8.0 tot 8.99, PHP 7.2 tot 8.3
  • Meertalig: de FAQ’s worden per taal aangemaakt en bewaard
  • Multistore: een aparte configuratie per subwinkel

Installatie

  1. Ga in uw backoffice naar Modules → Modulebeheer → Een module installeren.
  2. Upload productfaqai-3.0.0.zip.
  3. Klik op Installeren en daarna op Configureren.

Bijwerken vanaf v2.x (de Sash-module): de upgrade is niet destructief. Het schema van de tabel ps_product_faq blijft gelijk, dus uw bestaande FAQ’s blijven behouden. Installeer v3.0.0 er gewoon overheen en stel daarna uw API-sleutel in de nieuwe interface opnieuw in.

1. AI-aanbieder en model

Het eerste formulier van de configuratiepagina.

  • AI-aanbieder: OpenAI of Anthropic Claude. De module schakelt automatisch naar de juiste API.
  • OpenAI API-sleutel: via platform.openai.com (begint met sk-).
  • Anthropic API-sleutel: via console.anthropic.com (begint met sk-ant-).
  • Model: voor OpenAI is gpt-4o-mini aan te raden (het zuinigst). Voor Anthropic is claude-haiku-4-5 aan te raden.
  • Aantal vragen: 1 tot 15 (standaard 5).
  • Temperatuur: 0 is deterministisch, 2 is zeer creatief. Aanbevolen: 0,7.
  • Max tokens: de maximale lengte van het antwoord (standaard 2000). Verhoog die als u meer dan 8 vragen laat aanmaken.
  • Automatisch aanmaken: maakt bij elke nieuwe product automatisch een FAQ aan (in de standaardtaal).

Indicatieve kosten: vijf vragen aanmaken kost ongeveer 0,0005 $ met gpt-4o-mini en ongeveer 0,001 $ met claude-haiku-4-5. 200 producten × 3 talen komt zo op 0,30 tot 0,60 $ in totaal.

2. Prompt en inhoudelijke richtlijnen

Het tweede formulier, dat de kwaliteit en de stijl van de aangemaakte FAQ’s bepaalt.

  • Toon: professioneel, vriendelijk, ontspannen, technisch, enthousiast of geruststellend.
  • Doelpubliek (optioneel): vrije tekst, bijvoorbeeld « medische professionals B2B » of « eerste kopers ». De AI stemt woordkeuze en detailniveau daarop af.
  • Eigen systeemprompt (optioneel): vervangt de standaardinstructies volledig. Laat leeg om de ingebouwde prompt te gebruiken.
  • Bijkomende richtlijnen (optioneel): instructies die aan de prompt worden toegevoegd, bijvoorbeeld « vermeld altijd de garantie van 2 jaar » of « vermijd jargon ».
  • Categorie, fabrikant en kenmerken meenemen: drie schakelaars die de context verrijken die naar de AI gaat. Zet « kenmerken » aan voor technische producten: de antwoorden worden merkbaar nauwkeuriger.

3. Weergave en SEO

  • Weergavepositie (hook): kies uit 5 plaatsen:
    • displayProductFooter: onder de hele fiche (standaard, werkt overal)
    • displayFooterProduct: een variant, afhankelijk van het thema
    • displayProductAdditionalInfo: onder de aankoopknop (beter zichtbaar)
    • displayReassurance: het vertrouwensblok
    • displayAfterProductThumbs: onder de miniaturen
  • Titel van de FAQ: één veld per taal van de winkel. Er zijn standaardwaarden voorzien in FR/EN/ES/DE/IT/PT/NL.
  • Accordeonmodus: aan betekent inklapbare vragen (de eerste staat open). Uit betekent dat alle antwoorden zichtbaar zijn.
  • JSON-LD rich snippets: injecteert de Schema.org-opmaak FAQPage in de head. Aanbevolen: aan.
  • Uitgesloten categorieën: ID’s gescheiden door komma’s (bijvoorbeeld 12,45,78). Producten uit die categorieën worden bij de bulkgeneratie overgeslagen.

De module registreert bij de installatie alle 5 de hooks, maar toont het blok alleen op de ingestelde hook. Bestaat een hook niet in uw thema, dan verschijnt het blok eenvoudigweg niet: test eerst met de standaardhook.

FAQ’s aanmaken

Eén product tegelijk

In het paneel « FAQ’s aanmaken voor de producten » heeft elke productregel een knop Aanmaken. Kies eerst de doeltaal in de keuzelijst boven aan de tabel. Per product ziet u hoeveel FAQ’s er per taal al bestaan.

Bulkgeneratie

  • Aanmaken voor alle producten (huidige taal): verwerkt alle producten zonder FAQ in de actieve taal.
  • Aanmaken voor alle producten (alle talen): verwerkt alle actieve talen van de winkel.
  • Opnieuw aanmaken afdwingen: vink dit aan om de bestaande FAQ’s te overschrijven, handig na een wijziging van de prompt, de toon of de aanbieder.

Duur: reken op ongeveer 1 product per seconde per taal (de API-latentie varieert). 100 producten × 3 talen komt zo op ongeveer 5 minuten. Sluit het tabblad niet tijdens de verwerking. Producten uit de uitgesloten categorieën worden automatisch overgeslagen.

Automatisch aanmaken

Staat die optie in het eerste formulier aan, dan krijgt elk nieuw product (hook actionProductAdd) automatisch een FAQ in de standaardtaal van de winkel.

FAQ-editor per product

Klik op een productregel op FAQ’s bewerken om de editor te openen:

  • Taalkiezer bovenaan, om meteen tussen de talen te wisselen.
  • Positie: een numeriek gewicht, in oplopende weergavevolgorde.
  • Vraag en antwoord: de tekst is rechtstreeks te bewerken.
  • Status: een item in- of uitschakelen zonder het te verwijderen (een inactief item verschijnt niet op de fiche en niet in de JSON-LD).
  • Verwijderen: een item definitief wissen.
  • Een FAQ toevoegen: zelf een vraag met antwoord toevoegen.

Klik op Opslaan om alle wijzigingen van de pagina te bevestigen.

FAQPage rich snippets

Staat de JSON-LD-optie aan, dan injecteert de module in de head van elke productfiche met minstens één actieve FAQ een blok application/ld+json volgens Schema.org FAQPage:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}

Controleer de opmaak met de test voor rijke resultaten van Google. Of het in de zoekresultaten verschijnt, hangt van Google af en kan enkele dagen duren na het opnieuw indexeren van de pagina.

Problemen oplossen

« Stel uw API-sleutel in »

De sleutel van de gekozen aanbieder is leeg of ongeldig. Controleer of de sleutel bij de actieve aanbieder hoort (OpenAI is sk-…, Anthropic is sk-ant-…).

Fouten bij de bulkgeneratie

API-fouten (quotum overschreden, ingetrokken sleutel, timeout) komen via PrestaShopLogger in Geavanceerde parameters → Logboeken terecht. Het verslag na de verwerking toont per taal het detail van de geslaagde, overgeslagen en mislukte generaties.

De FAQ verschijnt niet op de productfiche

  1. Controleer of het product minstens één actieve FAQ heeft in de bekeken taal.
  2. Controleer of de ingestelde hook in uw thema bestaat, en schakel ter controle terug naar displayProductFooter.
  3. Leeg de PrestaShop-cache (Geavanceerde parameters → Prestaties).

De rich snippets verschijnen niet in Google

De opmaak kan geldig zijn zonder dat Google die toont: het weergeven van rijke resultaten blijft een beslissing van Google. Controleer eerst de opmaak met de test voor rijke resultaten en wacht daarna de herindexering af.

Verwijderen

Bij het verwijderen worden de tabel ps_product_faq (met alle aangemaakte FAQ’s) en alle configuratiesleutels gewist. Er wordt om bevestiging gevraagd. Exporteer uw gegevens vooraf als dat nodig is.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support