DataFirefly AI Product-FAQ voor WooCommerce: documentatie

DataFirefly AI Product-FAQ genereert automatisch contextuele FAQ’s voor uw WooCommerce-productpagina’s met behulp van OpenAI of Anthropic Claude, en injecteert de Schema.org FAQPage rich snippets in de head-tag voor verrijkte resultaten in Google. Deze handleiding behandelt de installatie, de volledige configuratie en het dagelijkse gebruik.

Vereisten

• WordPress 6.0 of hoger (getest tot 6.6)
• WooCommerce 7.0 of hoger (getest tot 9.4), compatibel met HPOS
• PHP 7.4 tot 8.3
• Een API-sleutel van OpenAI (platform.openai.com/api-keys) of van Anthropic (console.anthropic.com)
• Optioneel: Polylang of WPML voor meertaligheid

Installatie

1. Download het bestand dffaqai-1.0.0.zip vanuit uw DataFirefly-account.
2. Ga in het WordPress-beheer naar Plugins → Nieuwe plugin → Plugin uploaden, selecteer de ZIP en klik op Nu installeren.
3. Klik op Activeren. De plugin maakt de opslagtabel voor de FAQ’s aan en zet de standaardinstellingen klaar.

De AI-provider instellen

Ga naar AI FAQ → Instellingen → tabblad Provider.

OpenAI of Anthropic Claude kiezen

• OpenAI: plak uw API-sleutel en kies daarna een model: gpt-4o-mini (het voordeligste, aanbevolen), gpt-4o, gpt-4-turbo of gpt-3.5-turbo.
• Anthropic Claude: plak uw API-sleutel en kies daarna claude-haiku-4-5 (voordelig, aanbevolen), claude-sonnet-4-6 of claude-opus-4-7.

De plugin stuurt de aanvraag automatisch naar de juiste API op basis van de geselecteerde provider. U kunt op elk moment wisselen: al gegenereerde FAQ’s blijven behouden.

Generatie-instellingen

• Aantal vragen per product: 1 tot 15 (standaard 5).
• Temperatuur: 0 (deterministisch) tot 2 (zeer creatief). Standaard 0,7.
• Max tokens: maximale lengte van het AI-antwoord. Standaard 2000.

Tabblad Prompt: de gegenereerde inhoud aanpassen

Tone of voice

Zes vooraf ingestelde stijlen: professioneel, vriendelijk, ontspannen, technisch, enthousiast en geruststellend. De toon verandert de formulering van de antwoorden zonder dat u iets hoeft te programmeren.

Doelgroep

Vrije tekst, bijvoorbeeld “zorgprofessionals (B2B)”, “eerste kopers” of “doe-het-zelvers”. De AI past de woordkeuze, de verwijzingen en het detailniveau aan.

Aangepaste systeemprompt

Laat dit leeg om de standaardprompt te gebruiken die op basis van toon en doelgroep wordt opgebouwd. Vult u het in, dan vervangt het de standaardinstructies volledig, wat handig is voor winkels met een strikte redactionele huisstijl.

Aanvullende richtlijnen

Instructies die aan elke prompt worden toegevoegd, bijvoorbeeld “vermeld altijd de garantie van 2 jaar”, “vermijd overtreffende trappen” of “vergelijk niet met concurrenten”.

Productcontext om mee te sturen

Drie selectievakjes verrijken de context die naar de AI gaat: hoofdcategorie, merk (de taxonomieën product_brand, pwb-brand en yith_product_brand worden automatisch herkend) en WooCommerce-attributen. Bij technische producten verbetert het meesturen van de attributen de relevantie van de vragen aanzienlijk.

Tabblad Weergave en SEO

Weergavepositie

Keuze uit vijf WooCommerce-hooks:

• woocommerce_after_single_product_summary: onder de tabbladen (standaard)
• woocommerce_single_product_summary: binnen de productsamenvatting
• woocommerce_product_meta_end: aan het einde van de productmeta
• woocommerce_after_single_product: na de volledige productzone
• woocommerce_before_single_product: vóór de volledige productzone

De prioriteit van de hook (standaard 15) is instelbaar om samen te werken met andere plugins.

Weergavemodus

Accordeon (eerste vraag open, ARIA-toetsenbordnavigatie) of alle antwoorden uitgeklapt.

FAQPage rich snippets

Als deze optie actief is, injecteert de plugin de Schema.org FAQPage JSON-LD in de head-tag van elke productpagina met minstens één actieve FAQ. De codering gebruikt JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS en JSON_HEX_QUOT en komt door de Rich Results Test van Google.

FAQ-titel per taal

Eén titelveld per actieve taal van de site, met standaardwaarden voor FR, EN, ES, DE, IT, PT en NL.

Uitgesloten categorieën

Lijst met identificaties van WooCommerce-categorieën, gescheiden door komma’s. Producten uit deze categorieën worden overgeslagen bij bulkgeneratie en bij automatische generatie (virtuele producten, cadeaubonnen en dergelijke).

De FAQ-metabox op de productpagina

Op het bewerkscherm van elk product biedt de metabox AI FAQ volledige controle:

• Genereren met AI: maakt een set vragen en antwoorden voor de geselecteerde taal.
• Vraag toevoegen: voeg op elk moment handmatig een vraag toe.
• Bewerken van een vraag of antwoord: de regel wordt automatisch opgeslagen zodra het veld de focus verliest.
• Herordenen met slepen en neerzetten via de greep links van elke regel.
• In- of uitschakelen van een item zonder het te verwijderen.
• Verwijderen van een item, definitief.

Met een taalkiezer boven in de metabox schakelt u direct tussen de Polylang- of WPML-vertalingen van het product: elke vertaling heeft haar eigen set FAQ’s.

Bulkgeneratie

Menu AI FAQ → Bulkgeneratie:

1. Kies de doeltaal: standaardtaal, een specifieke taal, of alle actieve talen.
2. Vink eventueel Regeneratie forceren aan om bestaande FAQ’s te overschrijven (handig na een wijziging van toon of provider).
3. Klik op Starten.

De verwerking verloopt sequentieel (ongeveer één product per seconde, afhankelijk van de API-latentie) met een voortgangsbalk in realtime, een teller van verwerkte producten en een foutenlogboek per product. De knop Stoppen onderbreekt netjes tussen twee producten. Alleen gepubliceerde producten worden verwerkt; uitgesloten categorieën worden overgeslagen.

Automatisch genereren bij het aanmaken van een product

Optie op het tabblad Provider: als deze actief is, genereert de plugin automatisch een FAQ in de standaardtaal telkens wanneer een product wordt opgeslagen dat er nog geen heeft. Bestaande FAQ’s worden door dit mechanisme nooit overschreven.

Meertaligheid met Polylang en WPML

De plugin herkent Polylang (pll_languages_list, pll_get_post_translations) en WPML (wpml_active_languages, wpml_object_id) automatisch. Elke vertaling van een product krijgt een eigen set FAQ’s, rechtstreeks in de doeltaal gegenereerd; het is dus geen vertaling van het origineel. De bulkgeneratie met de optie “alle talen” doorloopt elke vertaling van elk product.

De rich snippets controleren

1. Open een productpagina met minstens één actieve FAQ.
2. Bekijk de broncode en zoek naar application/ld+json: er moet een blok "@type":"FAQPage" aanwezig zijn.
3. Test de URL in de Rich Results Test van Google: de detectie “FAQ” moet geldig zijn.

Probleemoplossing

“De API-sleutel van de AI-provider is niet ingesteld”

Vul de sleutel van de actieve provider in op het tabblad Provider. Controleer of er geen spatie voor of na de sleutel staat.

API-fout tijdens de generatie

Raadpleeg WooCommerce → Status → Logs en selecteer de bron dffaqai: elke API-fout wordt daar vastgelegd met de HTTP-code en de melding van de provider (ongeldige sleutel, quotum overschreden, onbekend model en zo verder).

Het FAQ-blok verschijnt niet

Controleer of het product minstens één actieve FAQ heeft in de getoonde taal en of het thema de gekozen hook uitvoert. Twijfelt u, keer dan terug naar de standaardhook woocommerce_after_single_product_summary, die in alle standaard WooCommerce-thema’s aanwezig is.

De gegenereerde vragen staan in de verkeerde taal

De generatietaal volgt de vertaling van het product (Polylang/WPML) of de locale van de site bij een eentalige installatie. Controleer de taalkiezer in de metabox voordat u genereert.

Verwijderen

Deactiveren behoudt alle gegevens. Het verwijderen van de plugin voert uninstall.php uit: de SQL-tabel met de FAQ’s en alle opties dffaqai_* worden definitief gewist.

Support

Ondersteuning verloopt per e-mail met een reactie binnen 24 werkuren (FR/EN). Voeg indien mogelijk het logboek dffaqai en de versies van WordPress, WooCommerce en PHP toe.