Installationsanleitung

Diese umfassende Anleitung führt Sie durch die Installation und Erstkonfiguration des FEL AI Product Advisor Plugins für Ihren Shopware 6 Shop.

Voraussetzungen

Systemanforderungen

Bevor Sie den FEL AI Product Advisor installieren, stellen Sie sicher, dass Ihr System diese Anforderungen erfüllt:

• Shopware Version: 6.6.3 oder höher (6.7.x empfohlen)
• PHP: 8.2 oder höher
• MySQL: 5.7 oder höher
• Erforderliches Plugin: FEL OAI Assistants Manager (muss zuerst installiert werden)

OpenAI Account Einrichtung

Sie benötigen einen aktiven OpenAI Account mit:

• API-Zugang: Aktiver OpenAI API-Schlüssel
• API-Schlüssel: Erhältlich über OpenAI Platform
• Unterstützte Modelle: GPT-4o-mini, GPT-4o, GPT-5-mini und alle aktuellen Reasoning-Modelle
• Konfigurierter Assistant: Mindestens ein OpenAI Assistant erstellt

Modellauswahl

Das Plugin unterstützt alle aktuellen OpenAI-Modelle einschließlich GPT-4o-mini, GPT-5-mini und Reasoning-Modelle. Mini-Modelle bieten exzellente Leistung zu sehr günstigen Kosten. Premium-Modelle bieten erweiterte Funktionen, erfordern jedoch eine Überwachung der Token-Nutzung.

Abhängigkeit: FEL OAI Assistants Manager

Der FEL AI Product Advisor benötigt das FEL OAI Assistants Manager Basis-Plugin, das zuerst installiert und konfiguriert werden muss. Dieses Basis-Plugin verwaltet die gesamte OpenAI API-Kommunikation.

Basis-Plugin Installation überprüfen

1. Navigieren Sie zu Einstellungen → System → Plugins
2. Suchen Sie nach "FEL OAI Assistants Manager"
3. Stellen Sie sicher, dass es installiert und aktiviert ist
4. Klicken Sie auf die drei Punkte (...) → Konfiguration
5. Überprüfen Sie, dass ein gültiger OpenAI API-Schlüssel eingegeben ist
6. Testen Sie die Verbindung mit der Schaltfläche "API Test"

Installationsschritte

Schritt 1: Plugin installieren

Via Kommandozeile (Empfohlen)

# Navigieren Sie zu Ihrem Shopware Root-Verzeichnis
cd /pfad/zu/ihrem/shopware

# Plugin in Plugins-Verzeichnis entpacken
cd custom/plugins/

# Plugin-Liste aktualisieren
bin/console plugin:refresh

# Plugin installieren und aktivieren
bin/console plugin:install FelAIProductAdvisor --activate

# Cache leeren
bin/console cache:clear

Via Shopware Administration

1. Melden Sie sich in Ihrer Shopware Administration an
2. Navigieren Sie zu Erweiterungen → Meine Erweiterungen
3. Klicken Sie auf Erweiterung hochladen
4. Laden Sie die Plugin-ZIP-Datei hoch
5. Klicken Sie nach Abschluss des Uploads auf Installieren
6. Aktivieren Sie das Plugin durch Klicken auf den Umschalter

Schritt 2: Assets kompilieren

Nach der Installation müssen Sie die Shopware-Assets kompilieren, um die Frontend-Komponenten des Plugins einzubinden.

# Administration kompilieren (falls Sie das Plugin konfigurieren)
bin/build-administration.sh

# Storefront kompilieren (erforderlich für Chatbot-Anzeige)
bin/build-storefront.sh

Wichtig

Das Überspringen der Asset-Kompilierung führt dazu, dass der Chatbot nicht korrekt angezeigt wird oder überhaupt nicht erscheint.

Überprüfung

Plugin-Installation überprüfen

1. Navigieren Sie zu Einstellungen → System → Plugins
2. Überprüfen Sie, dass "FEL AI Product Advisor" aufgelistet und aktiviert ist
3. Prüfen Sie die Plugin-Version (sollte 2.0.0 oder höher sein)

Verfügbarkeit des CMS-Elements überprüfen

Um zu bestätigen, dass die Installation erfolgreich war:

1. Navigieren Sie zu Inhalte → Erlebniswelten
2. Bearbeiten Sie eine vorhandene Seite oder erstellen Sie eine neue
3. Suchen Sie im CMS-Layout-Editor nach dem "KI Produktberater" (AI Product Advisor) Element
4. Das Element sollte in der "Commerce" Kategorie verfügbar sein

Erfolg!

Wenn Sie das "KI Produktberater" Element im CMS-Editor sehen können, war Ihre Installation erfolgreich!

Konfiguration nach der Installation

Nach erfolgreicher Installation ist keine zusätzliche API-Konfiguration auf Plugin-Ebene erforderlich. Der FEL AI Product Advisor verwendet die API-Einstellungen des Basis-Plugins (FEL OAI Assistants Manager).

Optional: Plugin-Einstellungen

Sie können auf optionale Plugin-Einstellungen zugreifen:

1. Navigieren Sie zu Einstellungen → System → Plugins
2. Finden Sie "FEL AI Product Advisor"
3. Klicken Sie auf die drei Punkte (...) → Konfiguration

Verfügbare globale Einstellungen umfassen:

Einstellung	Beschreibung	Standard
Plugin aktivieren	Chatbot global aktivieren/deaktivieren	✅ Aktiviert
Nur für authentifizierte Nutzer	Chatbot auf angemeldete Kunden beschränken	❌ Deaktiviert
Kundengruppen	Zugang auf bestimmte Kundengruppen beschränken	Alle
Maximale Eingabelänge	Maximale Zeichen pro Kundennachricht	400
Suchergebnis-Limit	Maximale Produkte in internen Suchen	8
Max. Beschreibungslänge	Zeichenlimit für Produktbeschreibungen	500
Max. Produkte im Chat	Anzahl der direkt angezeigten Produkte	4

Konfigurationsstrategie

Die meiste Konfiguration erfolgt auf CMS-Element-Ebene, wenn Sie den Chatbot zu einer Seite hinzufügen. Dies ermöglicht es Ihnen, verschiedene Chatbots für verschiedene Seiten mit einzigartigen Einstellungen zu erstellen.

Fehlerbehebung bei Installationsproblemen

Plugin erscheint nicht in der Administration

Mögliche Lösungen:

1. ✅ Cache leeren: bin/console cache:clear
2. ✅ Plugin-Liste aktualisieren: bin/console plugin:refresh
3. ✅ Browser-Cache leeren (Strg + F5)
4. ✅ Shopware-Logs prüfen: var/log/prod-*.log

CMS-Element nicht verfügbar

Mögliche Lösungen:

1. ✅ Überprüfen, dass Plugin aktiviert ist (Einstellungen → Plugins)
2. ✅ Storefront-Assets neu erstellen: bin/build-storefront.sh
3. ✅ Cache leeren: bin/console cache:clear
4. ✅ Browser-Konsole auf JavaScript-Fehler prüfen (F12)
5. ✅ Shopware-Versionskompatibilität überprüfen (6.6.3+)

Checkboxen in Konfiguration nicht sichtbar (Shopware 6.7)

Lösung:

Das Plugin verwendet moderne Shopware 6.7 type="bool" Felder. Wenn Checkboxen nicht erscheinen:

# Administration neu erstellen
bin/build-administration.sh

# Cache leeren
bin/console cache:clear

Asset-Kompilierungsfehler

Wenn Sie Fehler während der Asset-Kompilierung erhalten:

# Zuerst alle Caches leeren
rm -rf var/cache/*

# Erneut kompilieren
bin/build-storefront.sh

Verbindungsprobleme mit Basis-Plugin

Überprüfen:

1. ✅ FEL OAI Assistants Manager ist installiert und aktiviert
2. ✅ OpenAI API-Schlüssel ist im Basis-Plugin konfiguriert
3. ✅ API-Verbindungstest erfolgreich (Schaltfläche "API Test" klicken)
4. ✅ OpenAI-Account hat ausreichend Credits
5. ✅ Server kann https://api.openai.com erreichen

Wichtig

Der FEL AI Product Advisor kann nicht funktionieren ohne das ordnungsgemäß konfigurierte FEL OAI Assistants Manager Basis-Plugin.

Nächste Schritte

Nachdem Sie den FEL AI Product Advisor erfolgreich installiert haben, fahren Sie fort mit:

1. Konfiguration - Richten Sie Ihre Plugin-Einstellungen und API-Konfiguration ein
2. Ihren ersten Advisor erstellen - Fügen Sie den Chatbot zu einer CMS-Seite hinzu
3. Design-Anpassung - Wählen Sie aus 6 professionellen Themes
4. Best Practices - Lernen Sie, wie Sie Ihren Chatbot für beste Ergebnisse optimieren

Bereit loszulegen!

Sie sind jetzt bereit, Ihren ersten KI-gestützten Produktberater zu erstellen. Gehen Sie zur Anleitung Produktberater erstellen, um loszulegen!

Benötigen Sie Hilfe?

Wenn Sie weiterhin Probleme haben:

• E-Mail:info@5-elements-design.de
• Bitte angeben: Shopware-Version, PHP-Version, Fehlermeldungen und Schritte zur Reproduktion
• Logs: Prüfen Sie var/log/prod-*.log für detaillierte Fehlerinformationen