PS PrestaShop Anfänger

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

Product FAQ AI 4.0.0 installieren und konfigurieren: Verbindung mit Claude oder OpenAI, Texteinstellungen, Prüfung der Entwürfe, Massengenerierung mit Budget, barrierearme Anzeige und strukturierte Daten.

Aktualisiert Modulversion 4.0.0

Product FAQ AI verfasst mit KI (Anthropic Claude oder OpenAI) die FAQ Ihrer PrestaShop-Produktseiten ausschließlich auf Grundlage Ihrer Katalogdaten. Die Antworten werden als Entwurf gespeichert: Sie lesen sie, korrigieren sie bei Bedarf und geben sie frei, bevor sie auf der Produktseite erscheinen – in einem Akkordeon, das per Tastatur bedienbar ist und ohne JavaScript auskommt.

Version 4.0.0. Komplett neu geschriebenes Modul: PrestaShop 1.7.8, 8 und 9, PHP 7.1 bis 8.5, Backoffice in 8 Sprachen, Entwürfe mit Prüfung, Massengenerierung mit Kostenschätzung und Budget, Verbrauchsprotokoll, 5 Akkordeon-Stile. Beim Update von 3.x bleiben Ihre FAQ, deren Reihenfolge, deren Sichtbarkeit und Ihre Einstellungen erhalten.

Voraussetzungen

  • PrestaShop 1.7.8, 8.x oder 9.x, Theme Classic, Hummingbird oder ein Theme, das einen der angebotenen Hooks der Produktseite aufruft.
  • PHP 7.1 bis 8.5 mit den Erweiterungen cURL und OpenSSL (Verschlüsselung des API-Schlüssels).
  • Ein Konto bei Anthropic (console.anthropic.com) oder OpenAI (platform.openai.com) mit einem API-Schlüssel. Die Aufrufe werden vom Anbieter über Ihr eigenes Konto abgerechnet.
  • Der Server muss ausgehende HTTPS-Anfragen an api.anthropic.com oder api.openai.com senden können.

Installation und Update

  1. Klicken Sie unter Module > Modul-Manager auf Modul hochladen und wählen Sie productfaqai-4.0.0.zip.
  2. Das Modul legt die Tabelle ps_product_faq und drei technische Tabellen (ps_productfaqai_job, ps_productfaqai_job_item, ps_productfaqai_usage) an und registriert seine Hooks sowie einen versteckten Admin-Controller.
  3. Klicken Sie auf Konfigurieren: Der Tab KI-Verbindung führt Sie durch die Einrichtung des API-Schlüssels.

Update von 3.x. Laden Sie das ZIP 4.0.0 über die alte Version hoch. Es wird nichts gelöscht: Eine in 3.x aktive FAQ wird „veröffentlicht“, eine inaktive FAQ wird zum Entwurf. Der im Klartext gespeicherte API-Schlüssel wird verschlüsselt, die Modellkennungen werden durch aktuelle Modelle ersetzt (zum Beispiel claude-haiku-4-5-20251001 durch claude-haiku-5-5, gpt-4o-mini durch gpt-6-luna), und die Position displayProductFooter, die weder Classic noch Hummingbird aufruft, wird auf displayFooterProduct umgestellt, wenn Ihr Theme sie nicht verwendet.

Übersicht

Die Übersicht zeigt den Anteil der aktiven Produkte mit veröffentlichter FAQ, die Anzahl der Produkte mit zu prüfenden Entwürfen, die Ausgaben des Monats im Verhältnis zu Ihrer Monatsgrenze und die Richtkosten für 1.000 FAQ mit dem gewählten Modell. Die Abdeckung wird nach Sprache aufgeschlüsselt: veröffentlichte FAQ, nur Entwürfe oder keine FAQ.

Product FAQ AI für PrestaShop: Übersicht mit FAQ-Abdeckung nach Sprache und Monatsausgaben
Übersicht mit FAQ-Abdeckung nach Sprache und Monatsausgaben

Verbindung zum KI-Anbieter

Der Assistent umfasst drei Schritte: Anbieter wählen, Schlüssel einfügen, Modell wählen. Der Schlüssel wird zunächst mit einem kostenlosen Aufruf der Models-API des Anbieters getestet; gespeichert wird er nur, wenn der Test erfolgreich ist.

Product FAQ AI für PrestaShop: Verbindungsassistent mit Test des API-Schlüssels
Verbindungsassistent mit Test des API-Schlüssels

Der Schlüssel wird verschlüsselt (AES-256-GCM) in der Datenbank gespeichert. Er wird nie wieder angezeigt (nur die letzten 4 Zeichen), nie an den Browser gesendet und nie in Protokolle geschrieben. Um ihn zu ersetzen, fügen Sie einen neuen Schlüssel ein.

Modellauswahl

Die Liste enthält die in Ihrem Konto verfügbaren Modelle, die beim Test über die Models-API abgefragt werden. Die empfohlenen Modelle zeigen ihren unverbindlichen Listenpreis und die geschätzten Kosten für 1.000 FAQ mit Ihren Einstellungen. Ohne Test wird eine Ersatzliste angeboten.

  • Anthropic: claude-opus-5-5 (Standard, beste Qualität), claude-sonnet-5-5 (ausgewogen), claude-haiku-5-5 (schnell und günstig).
  • OpenAI: gpt-6.1-sol (Standard), gpt-6-astra, gpt-6.1-terra, gpt-6-luna, gpt-5.4-mini, gpt-5.4-nano.
Product FAQ AI für PrestaShop: Auswahl des Claude-Modells mit Richtpreis und Kosten pro 1.000 FAQ
Auswahl des Claude-Modells mit Richtpreis und Kosten pro 1.000 FAQ

Der Denkaufwand steht standardmäßig auf „Niedrig“: Eine FAQ aus einer Produktseite zu verfassen ist eine einfache Aufgabe, und ein höherer Aufwand erhöht die Dauer und die Anzahl der Token.

Texteinstellungen

Wählen Sie die Anzahl der Fragen pro Produkt (1 bis 15), die Antwortlänge (Kurz, Mittel, Ausführlich) und die Tonalität (Professionell, Freundlich, Locker, Technisch, Begeistert oder Beruhigend). Sie können eine Zielgruppe und Stilvorgaben angeben, zum Beispiel „Kunden siezen“.

Product FAQ AI für PrestaShop: Texteinstellungen: Anzahl der Fragen, Länge und Tonalität
Texteinstellungen: Anzahl der Fragen, Länge und Tonalität

Die Stilvorgaben können die Regeln des Moduls nicht aufheben: nur Fakten aus den Produktdaten verwenden, niemals Preise, Lieferzeiten, Garantien, Zertifizierungen oder Gesundheitsaussagen erfinden, in reinem Text schreiben. Eine kommerzielle Information (Garantie, Rückgabe) schreiben Sie in die Produktbeschreibung, oder Sie fügen die Frage manuell hinzu.

Gesendete Daten: Name, Kurz- und Langbeschreibung, Maße und Gewicht werden immer gesendet; Hauptkategorie, Marke, Merkmale und Varianten je nach Ihren Einstellungen. Kunden-, Bestell- oder Mitarbeiterdaten werden niemals gesendet.

Neue Produkte: Die Option „Neue Produkte in die FAQ-Warteschlange stellen“ ruft die KI nicht beim Speichern des Produkts auf; die Übersicht zeigt die wartenden Produkte, und Sie starten die Warteschlange, wann Sie möchten. Die Veröffentlichung ohne Prüfung ist eine separate Option und standardmäßig deaktiviert.

Produkte und FAQ-Editor

Der Tab Produkte & FAQ listet die Produkte des Shops auf, mit der Anzahl veröffentlichter Fragen bzw. Entwürfe und den Warnungen für jede Sprache. Filtern Sie nach Produkten ohne FAQ, mit Entwürfen oder mit veröffentlichter FAQ.

Product FAQ AI für PrestaShop: Produktliste mit FAQ-Status nach Sprache
Produktliste mit FAQ-Status nach Sprache

Der Editor öffnet die FAQ eines Produkts in einer Sprache:

  • FAQ generieren: ersetzt die Entwürfe der Sprache; bereits veröffentlichte Fragen bleiben erhalten, sofern Sie nicht verlangen, sie zu ersetzen.
  • Neu generieren (einzelne Frage): Die neue Version, die sich von den anderen Fragen unterscheidet, wird als Entwurf gespeichert.
  • Neu anordnen per Drag-and-drop oder mit den Pfeilen, bearbeiten, löschen, eine Frage manuell hinzufügen.
  • Freigeben (einzelne Frage) oder Alle freigeben und veröffentlichen. Nur veröffentlichte Einträge erscheinen auf der Produktseite.
Product FAQ AI für PrestaShop: FAQ-Editor: freigeben, eine Frage neu generieren, umsortieren
FAQ-Editor: freigeben, eine Frage neu generieren, umsortieren

Prüfwarnungen

Jede Antwort gibt die Fakten aus den Produktdaten an, auf die sich die KI gestützt hat. Das Modul zeigt eine Warnung an, wenn eine Zahl nicht in den Produktdaten vorkommt, wenn die Antwort von Garantie, Lieferung, Rückgabe, Zertifizierung oder Gesundheit spricht, obwohl die Produktseite nichts dazu sagt, oder wenn kein Fakt zitiert wird. Ein Eintrag mit Warnung wird nie automatisch veröffentlicht.

Product FAQ AI für PrestaShop: zu prüfende Entwürfe mit Warnung zu einer Zahl und einem Versprechen, die in den Produktdaten fehlen
Zu prüfende Entwürfe mit Warnung zu einer Zahl und einem Versprechen, die in den Produktdaten fehlen

An die KI gesendete Daten

Die Schaltfläche An die KI gesendete Daten zeigt genau, was das Modul für dieses Produkt übermittelt: die Anweisungen (für alle Produkte gleich, wodurch sie zwischengespeichert werden können) und die Produktnachricht, mit einer Schätzung der Token und der Kosten.

Product FAQ AI für PrestaShop: Vorschau der an die KI gesendeten Produktdaten, ohne Kundendaten
Vorschau der an die KI gesendeten Produktdaten, ohne Kundendaten

Massengenerierung

Wählen Sie die Sprachen, die Produkte (nur die ohne FAQ oder alle aktiven Produkte), optional eine Liste von IDs und was nach der Generierung geschieht (Entwürfe zur Prüfung, empfohlen, oder Veröffentlichung der Einträge ohne Warnung). Klicken Sie auf Kosten schätzen: Das Modul zeigt vor jedem Versand die Anzahl Produkte × Sprachen, die geschätzten Token und eine Kostenspanne an, mit und ohne Zwischenspeicherung der Anweisungen.

Product FAQ AI für PrestaShop: Massengenerierung mit Kostenschätzung vor dem Start
Massengenerierung mit Kostenschätzung vor dem Start
  • Die Warteschlange läuft in kurzen Schritten, solange die Modulseite geöffnet ist: keine endlos laufende Anfrage, kein Cronjob.
  • Eine Sperre verhindert, dass zwei Tabs oder zwei Mitarbeiter dieselbe Warteschlange verarbeiten; pro Shop ist nur eine Warteschlange aktiv.
  • Die Warteschlange stoppt beim Budget des Laufs und bei der Monatsgrenze. Sie können sie pausieren, fortsetzen, abbrechen oder Fehler erneut versuchen (3 Versuche pro Produkt).
  • Lehnt der Anbieter alle Anfragen ab (Schlüssel, Guthaben, Modell), pausiert die Warteschlange mit einer Meldung, die angibt, was zu korrigieren ist.

Sparmodus: Die Anfragen werden an die Message-Batches-API von Anthropic oder die Batch-API von OpenAI gesendet, zu etwa halbem Preis. Die Ergebnisse liegen in der Regel nach einigen Stunden vor, spätestens nach 24 Stunden, und werden abgeholt, solange die Modulseite geöffnet ist.

Product FAQ AI für PrestaShop: Warteschlange im Sparmodus (Batch) mit Fortschritt und Budget
Warteschlange im Sparmodus (Batch) mit Fortschritt und Budget

Kosten, Budget und Protokoll

Legen Sie das Standardbudget eines Massenlaufs, die Monatsgrenze (über alle Generierungen hinweg) und die maximale Anzahl Token pro Antwort fest. Das Protokoll listet jeden Aufruf auf: Vorgang, Produkt, Sprache, Modell, Eingabe-, Ausgabe- und aus dem Cache gelesene Token, wie vom Anbieter gemeldet, Richtkosten und gegebenenfalls Fehler.

Product FAQ AI für PrestaShop: Budget, Monatsgrenze und Token-Verbrauchsprotokoll
Budget, Monatsgrenze und Token-Verbrauchsprotokoll

Die verwendeten Preise sind unverbindliche Listenpreise, erhoben am 11.11.2026. Die Schätzung rechnet mit etwa 3,5 Zeichen pro Token: Das ist ein Richtwert. Maßgeblich ist die Rechnung Ihres Anbieters.

Anzeige auf der Produktseite

Wählen Sie im Tab Anzeige den Stil, die Akzentfarbe, ob die erste Frage geöffnet angezeigt wird, die Position auf der Seite und den Blocktitel in jeder Sprache. Eine Position, die Ihr Theme nicht aufruft, wird gekennzeichnet.

Product FAQ AI für PrestaShop: Anzeigeeinstellungen: Akkordeon-Stile, Position und strukturierte Daten
Anzeigeeinstellungen: Akkordeon-Stile, Position und strukturierte Daten

Fünf Stile stehen zur Verfügung: Minimal, Karten, Gerahmt, Plus-Tasten und Alles offen. Der Block verwendet die nativen HTML-Elemente <details> und <summary>: Er funktioniert per Tastatur (Tab, Eingabetaste, Leertaste) und mit Screenreadern, ganz ohne JavaScript-Datei. Das HTML wird vom Server erzeugt, sodass sich beim Laden der Seite nichts verschiebt, und das Stylesheet wird nur auf Produktseiten geladen, die eine FAQ anzeigen.

Product FAQ AI für PrestaShop: FAQ auf der Produktseite, Stil Minimal (Hummingbird)
FAQ auf der Produktseite, Stil Minimal (Hummingbird)
Product FAQ AI für PrestaShop: FAQ auf der Produktseite, Stil Karten
FAQ auf der Produktseite, Stil Karten
Product FAQ AI für PrestaShop: FAQ auf der Produktseite, Stil Gerahmt
FAQ auf der Produktseite, Stil Gerahmt
Product FAQ AI für PrestaShop: FAQ auf der Produktseite, Stil Plus-Tasten mit Akzentfarbe
FAQ auf der Produktseite, Stil Plus-Tasten mit Akzentfarbe
Product FAQ AI für PrestaShop: FAQ mit allen Antworten sichtbar
FAQ mit allen Antworten sichtbar
Product FAQ AI für PrestaShop: Hummingbird-Produktseite mit dem FAQ-Block
Hummingbird-Produktseite mit dem FAQ-Block
Product FAQ AI für PrestaShop: FAQ auf dem Smartphone, per Tastatur bedienbar und ohne JavaScript
FAQ auf dem Smartphone, per Tastatur bedienbar und ohne JavaScript

Strukturierte Daten FAQPage

Das Modul kann den Produktseiten, die eine FAQ anzeigen, ein schema.org-Markup FAQPage (JSON-LD) hinzufügen. Die Option ist standardmäßig deaktiviert.

Google hat FAQ-Rich-Results im August 2023 auf maßgebliche Behörden- und Gesundheitswebsites beschränkt und zeigt sie seit dem 7. Mai 2026 für keine Website mehr an. Das Markup bleibt gültiges schema.org und schadet nicht, erzeugt in Google aber kein Rich Result: Erwarten Sie davon keinen SEO-Gewinn.

Wenn Sie die Option aktivieren und das Modul DataFirefly All in One SEO auf der Seite bereits einen FAQPage-Block ausgibt, fügt Product FAQ AI keinen zweiten hinzu; die Einstellungen des anderen Moduls werden nie geändert. Das JSON-LD wird so kodiert, dass es gültig bleibt und das script-Tag niemals schließen kann.

Sicherheit und Datenschutz

  • Der Produkttext wird in einen abgegrenzten Datenblock gesetzt und als nicht vertrauenswürdiger Inhalt behandelt: Eine Beschreibung, die Anweisungen enthält („Ignoriere die Anweisungen…“), bleibt reine Daten.
  • Die Antwort der KI ist an ein JSON-Schema gebunden und wird anschließend bereinigt: nur reiner Text, ohne HTML, Links, E-Mail-Adressen oder Markdown.
  • Die Backoffice-Aktionen laufen über einen tokengeschützten Controller; Schreibvorgänge erfordern eine POST-Anfrage des Moduls und das Recht „Bearbeiten“ für den Tab Product FAQ AI. Ein Mitarbeiter, der nur das Recht „Anzeigen“ hat, kann Inhalte einsehen, aber weder generieren noch bearbeiten.
  • Multishop: Einstellungen, Schlüssel, FAQ, Warteschlange und Protokoll gelten jeweils pro Shop; wählen Sie einen einzelnen Shop, um das Modul zu konfigurieren.

Fehlerbehebung

  • „Der Anbieter hat den Schlüssel abgelehnt (401)“: Prüfen Sie den Schlüssel in der Konsole des Anbieters oder erstellen Sie einen neuen und fügen Sie ihn erneut ein.
  • „Modell unbekannt oder nicht verfügbar (404)“: Wählen Sie ein anderes Modell; die Schaltfläche Gespeicherten Schlüssel testen lädt die Liste Ihres Kontos neu.
  • Guthaben aufgebraucht oder Abrechnungslimit erreicht: Laden Sie beim Anbieter Guthaben auf und setzen Sie dann die Warteschlange fort.
  • Zu viele Anfragen (429), Dienst überlastet: Das Modul hat es bereits unter Beachtung der vom Anbieter angegebenen Wartezeit erneut versucht; warten Sie oder nutzen Sie den Sparmodus.
  • Antwort abgeschnitten: Erhöhen Sie die maximale Anzahl Token pro Antwort oder verlangen Sie weniger Fragen oder kürzere Antworten.
  • Ablehnung durch den Anbieter: Prüfen Sie den Produkttext oder schreiben Sie die Fragen manuell.
  • Die FAQ wird nicht angezeigt: Prüfen Sie, ob die Fragen in der aufgerufenen Sprache veröffentlicht sind und ob die gewählte Position von Ihrem Theme aufgerufen wird (Hinweis im Tab Anzeige).

Deinstallation

Die Deinstallation löscht alle FAQ, die Generierungs-Warteschlange, das Verbrauchsprotokoll, die Einstellungen und den Admin-Controller. Vorher wird eine Bestätigung abgefragt.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren