PS PrestaShop PrestaShop Anfänger

Produkt-FAQ KI — Vollständige Installations- und Konfigurationsanleitung

Das Modul Produkt-FAQ KI installieren und konfigurieren: KI-Anbieter (OpenAI oder Claude), Prompt-Anpassung, Massengenerierung, FAQ-Editor und FAQPage Rich Snippets.

Aktualisiert Modulversion 3.0.0

Überblick

DataFirefly Produkt-FAQ KI generiert automatisch kontextbezogene FAQs für Ihre PrestaShop-8-Produktseiten über OpenAI oder Anthropic Claude und injiziert Schema.org-FAQPage-Rich-Snippets in den Head für Google Rich Results. Die FAQs werden in der Datenbank gespeichert (Tabelle ps_product_faq) — im Front-Office erfolgt kein API-Aufruf.

  • Kompatibilität: PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
  • Mehrsprachig: FAQs werden pro Sprache generiert und gespeichert
  • Multishop: unabhängige Konfiguration pro Sub-Shop

Installation

  1. Gehen Sie im Back-Office zu Module → Modul-Manager → Modul hochladen.
  2. Laden Sie productfaqai-3.0.0.zip hoch.
  3. Klicken Sie auf Installieren, dann auf Konfigurieren.

Upgrade von v2.x (Sash-Modul): Das Upgrade ist nicht destruktiv. Das Schema der Tabelle ps_product_faq bleibt unverändert — Ihre bestehenden FAQs bleiben erhalten. Installieren Sie einfach v3.0.0 darüber und konfigurieren Sie Ihren API-Schlüssel in der neuen Oberfläche neu.

1. KI-Anbieter & Modell

Erstes Formular auf der Konfigurationsseite.

  • KI-Anbieter: OpenAI oder Anthropic Claude. Das Modul wechselt automatisch zur richtigen API.
  • OpenAI-API-Schlüssel: von platform.openai.com (beginnt mit sk-).
  • Anthropic-API-Schlüssel: von console.anthropic.com (beginnt mit sk-ant-).
  • Modell: für OpenAI wird gpt-4o-mini empfohlen (am günstigsten). Für Anthropic wird claude-haiku-4-5 empfohlen.
  • Anzahl der Fragen: 1 bis 15 (Standard: 5).
  • Temperatur: 0 = deterministisch, 2 = sehr kreativ. Empfohlen: 0,7.
  • Max. Tokens: maximale Antwortlänge (Standard: 2000). Erhöhen Sie den Wert bei mehr als 8 Fragen.
  • Auto-Generierung: generiert die FAQ automatisch (Standardsprache) bei jeder Produkterstellung.

Richtwert Kosten: Die Generierung von 5 Fragen kostet ~0,0005 $ mit gpt-4o-mini und ~0,001 $ mit claude-haiku-4-5. 200 Produkte × 3 Sprachen ≈ 0,30 bis 0,60 $ insgesamt.

2. Prompt & Inhaltsvorgaben

Zweites Formular — steuert Qualität und Stil der generierten FAQs.

  • Tonfall: professionell, freundlich, locker, technisch, enthusiastisch oder beruhigend.
  • Zielgruppe (optional): Freitext, z. B. „B2B-Mediziner“, „Erstkäufer“. Die KI passt Vokabular und Detailtiefe an.
  • Benutzerdefinierter System-Prompt (optional): ersetzt die Standardanweisungen vollständig. Leer lassen, um den integrierten Prompt zu verwenden.
  • Zusätzliche Vorgaben (optional): an den Prompt angehängte Anweisungen, z. B. „immer die 2-Jahres-Garantie erwähnen“, „Fachjargon vermeiden“.
  • Kategorie / Hersteller / Eigenschaften einbeziehen: drei Schalter, die den an die KI gesendeten Kontext anreichern. Aktivieren Sie „Eigenschaften“ bei technischen Produkten — die Präzision der Antworten verbessert sich deutlich.

3. Anzeige & SEO

  • Anzeigeposition (Hook): Wählen Sie eine von 5 Positionen:
    • displayProductFooter — unter der gesamten Produktseite (Standard, funktioniert überall)
    • displayFooterProduct — Variante je nach Theme
    • displayProductAdditionalInfo — unter dem Kaufen-Button (sichtbarer)
    • displayReassurance — Vertrauensblock
    • displayAfterProductThumbs — unter den Miniaturansichten
  • FAQ-Titel: ein Feld pro Shop-Sprache. Standardwerte in FR/EN/ES/DE/IT/PT/NL vorhanden.
  • Akkordeon-Modus: aktiviert = einklappbare Fragen (erste geöffnet). Deaktiviert = alle Antworten sichtbar.
  • JSON-LD Rich Snippets: injiziert das Schema.org-FAQPage-Markup in den Head. Empfohlen: aktiviert.
  • Ausgeschlossene Kategorien: kommagetrennte IDs (z. B. 12,45,78). Produkte dieser Kategorien werden bei der Massengenerierung übersprungen.

Das Modul registriert bei der Installation alle 5 Hooks, rendert den Block aber nur am konfigurierten. Existiert ein Hook in Ihrem Theme nicht, wird der Block einfach nicht angezeigt — testen Sie zuerst mit dem Standard-Hook.

FAQs generieren

Einzelgenerierung

Im Panel „FAQs für Produkte generieren“ zeigt jede Produktzeile einen Generieren-Button. Wählen Sie zuerst die Zielsprache im Dropdown über der Tabelle. Die Anzahl vorhandener FAQs pro Sprache wird für jedes Produkt angezeigt.

Massengenerierung

  • Für alle Produkte generieren (aktuelle Sprache): verarbeitet alle Produkte ohne FAQ in der aktiven Sprache.
  • Für alle Produkte generieren (alle Sprachen): verarbeitet alle aktiven Shop-Sprachen.
  • Regenerierung erzwingen: aktivieren Sie diese Checkbox, um bestehende FAQs zu überschreiben — nützlich nach einer Änderung von Prompt, Tonfall oder Anbieter.

Dauer: Rechnen Sie mit ~1 Produkt/Sekunde pro Sprache (API-Latenz variiert). 100 Produkte × 3 Sprachen ≈ 5 Minuten. Schließen Sie den Tab während der Verarbeitung nicht. Produkte in ausgeschlossenen Kategorien werden automatisch übersprungen.

Auto-Generierung

Wenn im ersten Formular aktiviert, erhält jedes neue Produkt (Hook actionProductAdd) automatisch eine FAQ in der Standardsprache des Shops.

FAQ-Editor pro Produkt

Klicken Sie auf FAQs bearbeiten in einer Produktzeile, um den Editor zu öffnen:

  • Sprachauswahl oben — sofortiger Wechsel zwischen den Sprachen.
  • Position: numerisches Gewicht, aufsteigende Anzeigereihenfolge.
  • Frage / Antwort: direkte Textbearbeitung.
  • Status: Eintrag aktivieren/deaktivieren, ohne ihn zu löschen (ein inaktiver Eintrag erscheint weder auf der Seite noch im JSON-LD).
  • Löschen: endgültiges Entfernen eines Eintrags.
  • FAQ hinzufügen: manuelles Hinzufügen einer Frage/Antwort.

Klicken Sie auf Speichern, um alle Änderungen der Seite zu übernehmen.

FAQPage Rich Snippets

Wenn die JSON-LD-Option aktiviert ist, injiziert das Modul in den head jeder Produktseite mit mindestens einer aktiven FAQ einen application/ld+json-Block gemäß Schema.org FAQPage:

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

Überprüfen Sie das Markup mit dem Google-Test für Rich-Suchergebnisse. Die Anzeige in der SERP liegt bei Google und kann nach der Neuindexierung der Seite mehrere Tage dauern.

Fehlerbehebung

„Bitte konfigurieren Sie Ihren API-Schlüssel“

Der Schlüssel des ausgewählten Anbieters ist leer oder ungültig. Prüfen Sie, ob der Schlüssel zum aktiven Anbieter passt (OpenAI = sk-…, Anthropic = sk-ant-…).

Fehler bei der Massengenerierung

API-Fehler (Kontingent überschritten, widerrufener Schlüssel, Timeout) werden über PrestaShopLogger in Erweiterte Einstellungen → Logs protokolliert. Der Abschlussbericht zeigt die Aufschlüsselung Erfolge / Übersprungen / Fehler pro Sprache.

Die FAQ erscheint nicht auf der Produktseite

  1. Prüfen Sie, ob das Produkt mindestens eine aktive FAQ in der angezeigten Sprache hat.
  2. Prüfen Sie, ob der konfigurierte Hook in Ihrem Theme existiert — wechseln Sie zum Testen zurück zu displayProductFooter.
  3. Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen → Leistung).

Rich Snippets erscheinen nicht in Google

Das Markup kann gültig sein, ohne dass Google es anzeigt: Rich Results liegen im Ermessen von Google. Validieren Sie zuerst das Markup mit dem Rich-Results-Test und warten Sie dann die Neuindexierung ab.

Deinstallation

Die Deinstallation löscht die Tabelle ps_product_faq (alle generierten FAQs) und entfernt alle Konfigurationsschlüssel. Eine Bestätigung wird angefordert. Exportieren Sie Ihre Daten vorher, falls nötig.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren