AI Product Descriptions
Das Modul für KI-Produktbeschreibungen ermöglicht die automatische Generierung von WooCommerce-Produktbeschreibungen über eine beliebige OpenAI-kompatible API. Die Beschreibungen sind für SEO optimiert und an den gewählten Kommunikationston angepasst.
Funktionsweise
Section titled “Funktionsweise”- Der Administrator öffnet die Bearbeitungsansicht eines WooCommerce-Produkts
- In der Meta-Box “AI Descriptions” wählt er ein Generierungsziel und einen Ton
- Das Plugin sendet den Produktkontext an die API
- Der generierte Text erscheint zur Vorschau in der Meta-Box
- Der Administrator akzeptiert oder bearbeitet den Text vor dem Speichern
Konfiguration
Section titled “Konfiguration”Gehen Sie zu WooCommerce > Einstellungen > Polski PRO > AI Descriptions.
Die Einstellungen werden in der Option gespeichert:
polski_pro_ai_descriptionsAPI-Einstellungen
Section titled “API-Einstellungen”| Einstellung | Beschreibung | Standard |
|---|---|---|
| API-Schlüssel | Autorisierungsschlüssel für die API | - |
| API-URL | Der chat/completions-Endpunkt | https://api.openai.com/v1/chat/completions |
| Modell | Das für die Generierung verwendete KI-Modell | gpt-4o-mini |
| Max tokens | Maximale Antwortlänge | 1024 |
Generierungseinstellungen
Section titled “Generierungseinstellungen”| Einstellung | Beschreibung | Standard |
|---|---|---|
| Ton | Kommunikationsstil | professional |
| Sprache | Sprache der generierten Beschreibungen | pl |
| SEO-Keywords | Keywords in die Beschreibung aufnehmen | Ja |
| Eigener Prompt | Zusätzliche Anweisungen für das KI-Modell | - |
Verfügbare Töne
Section titled “Verfügbare Töne”| Ton | Beschreibung |
|---|---|
professional | Formeller, sachlicher Geschäftsstil |
casual | Freundlicher, gesprächiger Stil |
persuasive | Überzeugend, verkaufsorientiert |
technical | Detaillierte, technische Beschreibung der Spezifikationen |
luxurious | Exklusiver, aspirativer Premium-Stil |
Generierungsziele
Section titled “Generierungsziele”Die Meta-Box in der Produktbearbeitungsansicht lässt Sie wählen, welcher Text generiert werden soll:
| Ziel | Beschreibung |
|---|---|
| Vollständige Beschreibung | Die Hauptproduktbeschreibung (post_content) |
| Kurzbeschreibung | Der Produktauszug (post_excerpt) |
| SEO-Titel | Der Meta-Titel für Suchmaschinen |
| SEO-Meta-Beschreibung | Die Meta-Beschreibung für Suchmaschinen |
SEO-Titel und -Beschreibungen werden automatisch in den Feldern des jeweiligen SEO-Plugins gespeichert (Yoast SEO oder RankMath).
Integration mit SEO-Plugins
Section titled “Integration mit SEO-Plugins”Das Modul erkennt das installierte SEO-Plugin und speichert die generierten Daten in den entsprechenden Meta-Feldern:
Yoast SEO
Section titled “Yoast SEO”- SEO-Titel gespeichert in
_yoast_wpseo_title - SEO-Meta-Beschreibung gespeichert in
_yoast_wpseo_metadesc
RankMath
Section titled “RankMath”- SEO-Titel gespeichert in
rank_math_title - SEO-Meta-Beschreibung gespeichert in
rank_math_description
Wenn kein SEO-Plugin aktiv ist, sind die Optionen zum Generieren des SEO-Titels und der Meta-Beschreibung nicht verfügbar.
Produktkontext
Section titled “Produktkontext”Bei jeder Generierungsanfrage sendet das Plugin die folgenden Produktdaten an die API:
- Produktname - der Produkttitel
- SKU - die Katalognummer
- Preis - der reguläre und der Aktionspreis
- Kategorien - die Liste der Produktkategorien
- Attribute - alle Attribute und ihre Werte
- Vorhandene Beschreibungen - die aktuelle vollständige und kurze Beschreibung (falls vorhanden)
Diese Daten ermöglichen es dem KI-Modell, eine treffende und kontextuell korrekte Beschreibung zu generieren.
Massengenerierung
Section titled “Massengenerierung”Das Modul unterstützt die Generierung von Beschreibungen für mehrere Produkte gleichzeitig:
- Gehen Sie zu Produkte > Alle Produkte
- Wählen Sie die Produkte aus, für die generiert werden soll
- Wählen Sie aus der Liste “Massenaktionen” den Eintrag KI-Beschreibungen generieren
- Wählen Sie das Generierungsziel und den Ton
- Klicken Sie auf “Anwenden”
Die Massengenerierung läuft asynchron über AJAX, jedes Produkt wird separat verarbeitet, und ein Fortschrittsbalken zeigt den Status des Vorgangs an. Das hilft, das Zeitlimit des Servers bei einer großen Anzahl von Produkten nicht zu überschreiten.
Limits
Section titled “Limits”- Jede Aufgabe ist ein separater API-Aufruf
- Sie sollten die Rate-Limiting-Grenzen des API-Dienstes berücksichtigen
- Bei einer großen Anzahl von Produkten kann die Generierung mehrere Minuten dauern
Anwendungsbeispiel
Section titled “Anwendungsbeispiel”Generierung einer Beschreibung für ein einzelnes Produkt
Section titled “Generierung einer Beschreibung für ein einzelnes Produkt”- Öffnen Sie die Produktbearbeitungsansicht
- Scrollen Sie zur Meta-Box AI Descriptions
- Wählen Sie das Ziel: “Vollständige Beschreibung”
- Wählen Sie den Ton: “persuasive”
- Klicken Sie auf Generieren
- Prüfen Sie den generierten Text
- Klicken Sie auf In Beschreibung einfügen, um den Text in den Editor zu übernehmen
Konfiguration eines eigenen Endpunkts
Section titled “Konfiguration eines eigenen Endpunkts”Wenn Sie ein lokales LLM-Modell oder einen anderen Anbieter verwenden:
- Ändern Sie die API-URL in die Adresse Ihres Endpunkts (er muss mit dem OpenAI-Format chat/completions kompatibel sein)
- Legen Sie das passende Modell fest (ein von Ihrem Endpunkt erkannter Modellname)
- Geben Sie den API-Schlüssel an (falls von Ihrem Endpunkt gefordert)
Modul aktivieren
Section titled “Modul aktivieren”Das Modul wird über einen Schalter in den PRO-Moduleinstellungen gesteuert:
WooCommerce > Einstellungen > Polski PRO > Module > AI DescriptionsAI-Act-Transparenz (Art. 50)
Section titled “AI-Act-Transparenz (Art. 50)”Produkttexte, die Sie aus diesem Modul übernehmen, werden als KI-generierte Inhalte behandelt. Wenn Sie generierten Text auf die Beschreibung oder Kurzbeschreibung eines Produkts anwenden, wird das Plugin:
- einen maschinenlesbaren Marker auf dem Produkt speichern (
_polski_ai_generated), und - einen kurzen Hinweis sowie einen versteckten
data-ai-generated-Marker auf der Einzelproduktseite anzeigen.
Ein AI Act Art. 50-Abzeichen erscheint zudem in der Meta-Box AI Descriptions, sobald ein Produkt markiert wurde.
Der Hinweis auf der Seite wird über eine einzige Option gesteuert, standardmäßig aktiviert, in den KI-Einstellungen des kostenlosen Plugins:
WooCommerce > Einstellungen > Polski > KI-Funktionen > KI-generierte Inhalte kennzeichnenDas Deaktivieren behält den maschinenlesbaren Eintrag auf dem Produkt bei, entfernt jedoch den Hinweis im Shop. SEO-Titel und Meta-Beschreibung werden nicht gekennzeichnet, da sie nicht als sichtbarer Produkttext gerendert werden.