Zurück zur Software
Virtual Try-On für WooCommerce - Dokumentation
Vollständige Einrichtungs- und Konfigurationsanleitung für das KI-gestützte Virtual Try-On Plugin
Inhaltsverzeichnis
Was ist Virtual Try-On für WooCommerce?
Virtual Try-On für WooCommerce ist ein KI-gestütztes WordPress-Plugin, das es Kunden ermöglicht, Produkte (Brillen, Sonnenbrillen, Schmuck usw.) auf ihren eigenen Fotos vor dem Kauf zu betrachten. Das Plugin integriert sich nahtlos in WooCommerce und verwendet fortschrittliche KI-Bildverarbeitung zur Generierung realistischer Try-On-Vorschauen.
Hauptvorteile
- Erhöhte Konversionsraten: Kunden können sehen, wie Produkte an ihnen aussehen, bevor sie kaufen
- Reduzierte Rücksendungen: Bessere Produktvisualisierung führt zu selbstbewussteren Käufen
- Verbesserte Benutzererfahrung: Moderne, intuitive Benutzeroberfläche mit Kamera- und Upload-Optionen
- Datenschutzorientiert: Alle Verarbeitung erfolgt auf Ihrem Server mit Ihrem gewählten KI-Anbieter
- Mehrsprachige Unterstützung: Eingebaute Übersetzungen für Englisch, Griechisch und Deutsch
Plugin-Funktionen
Kernfunktionalität
- KI-gestütztes Try-On: Generierung realistischer Produktvorschauen mit Google Gemini oder benutzerdefinierten KI-Endpunkten
- Flexible Bildeingabe: Unterstützung für Datei-Uploads und Live-Kamera-Aufnahme
- Produktebenen-Kontrolle: Try-On pro Produkt aktivieren/deaktivieren mit optionalen benutzerdefinierten Rahmenbildern
- Moderne Modal-Benutzeroberfläche: Responsive, barrierefreie UI mit sanften Animationen
- Generierungszähler: Verfolgung von Nutzungsstatistiken im Admin-Dashboard
- Debug-Modus: Umfassende Protokollierung zur Fehlerbehebung
- Benutzereinverständnis-Verwaltung: Fordert Benutzererlaubnis zur Speicherung ihres Fotos für einfache Wiederverwendung bei mehreren virtuellen Anproben
- Virtual Try-On Galerie: Zeigt alle virtuellen Anproben in einem Rasterformat für einfachen Vergleich mit "Jetzt kaufen"-Buttons für schnelle Bestellung
- Temporäre Fotospeicherung: Fotos werden temporär für 24 Stunden gespeichert mit automatischer Löschung nach Ablauf
- Bulk-Kategorie-Aktivierung: Virtual Try-On für alle Produkte in bestimmten Kategorien aktivieren (große zeitsparende Funktion!)
Benutzeroberflächen-Funktionen
- Responsive Design: Funktioniert auf Desktop-, Tablet- und Mobilgeräten
- Barrierefreiheit: ARIA-Labels, Tastaturnavigation, Screenreader-Unterstützung
- Mehrsprachige UI: Dynamisches Sprachenwechseln (Englisch/Griechisch/Deutsch)
- Einverständnis-Verwaltung: Benutzereinverständnis-Checkbox vor KI-Verarbeitung
- Echtzeit-Feedback: Ladezustände, Fortschrittsanzeigen, Fehlermeldungen
Admin-Funktionen
- Einstellungs-Dashboard: Zentralisierte Konfiguration in WooCommerce-Einstellungen
- Lizenz-Verwaltung: Eingebaute Lizenzvalidierung und Statusüberwachung
- Kategorie-Überschreibungen: Verschiedene Shop-Typen für spezifische Produktkategorien festlegen
- Produkt-Meta-Felder: Pro-Produkt Try-On-Einstellungen und benutzerdefinierte Rahmenbilder
- Nutzungsanalysen: Generierungszähler und Debug-Protokolle
Systemanforderungen
WordPress & WooCommerce
- WordPress: 6.0 oder höher
- WooCommerce: 6.0 oder höher (getestet bis 9.0)
- PHP: 7.4 oder höher
- MySQL: 5.6 oder höher
Server-Anforderungen
- SSL-Zertifikat: Erforderlich für Kamerazugriff (HTTPS)
- Datei-Upload: Mindestens 10MB Upload-Limit empfohlen
- Speicher: 256MB PHP-Speicherlimit minimum
- Ausführungszeit: 60 Sekunden empfohlen für KI-Verarbeitung
KI-Anbieter-Anforderungen
- Google Gemini: API-Schlüssel mit Gemini 2.5 Flash Image Preview Zugang
- Benutzerdefinierter Endpunkt: RESTful API mit Bildverarbeitungsunterstützung
Installationsanleitung
Methode 1: WordPress Admin (Empfohlen)
- 1Plugin-ZIP-Datei aus Ihrem Lizenzportal herunterladen
- 2Zu Plugins → Neues hinzufügen → Plugin hochladen gehen
- 3ZIP-Datei auswählen und auf Jetzt installieren klicken
- 4Auf Plugin aktivieren klicken
Methode 2: FTP-Upload
- 1Plugin-ZIP-Datei extrahieren
- 2virtual-try-on-for-woocommerce Ordner nach /wp-content/plugins/ hochladen
- 3Zu Plugins im WordPress-Admin gehen
- 4"Virtual Try-On für WooCommerce" finden und auf Aktivieren klicken
Nach-Installations-Setup
- 1Zu WooCommerce → Virtual Try-On navigieren
- 2Lizenzschlüssel eingeben und auf Lizenz validieren klicken
- 3KI-Anbieter-Einstellungen konfigurieren
- 4Funktionalität auf einer Produktseite testen
Konfigurationseinstellungen
Einstellungen über WooCommerce → Virtual Try-On zugreifen:
Lizenz-Konfiguration
- Lizenzschlüssel: Ihren gekauften Lizenzschlüssel eingeben
- Lizenzstatus: Zeigt aktuellen Validierungsstatus an
- Aktionen: Lizenz validieren und speichern Buttons
KI-Anbieter-Einstellungen
- Anbieter: Zwischen "Google Gemini" oder "Benutzerdefiniert" wählen
- API-Schlüssel: Ihr KI-Anbieter API-Schlüssel
- Modell: KI-Modellname (Standard: gemini-2.5-flash-image-preview)
- Benutzerdefinierter Endpunkt: URL für benutzerdefinierten KI-Anbieter (falls Benutzerdefiniert verwendet)
Wie Kunden das Plugin verwenden
Kundenerfahrung
- 1Produktseite: Kunde besucht ein Produkt mit aktiviertem Try-On
- 2Try-On-Button: Auf "Anprobieren"-Button unter dem In-den-Warenkorb-Formular klicken
- 3Modal-Benutzeroberfläche: Foto hochladen ODER Kamera verwenden, Einverständnis-Checkbox akzeptieren, auf "Vorschau generieren" klicken
- 4Verarbeitung: 10-30 Sekunden auf KI-Generierung warten
- 5Ergebnis: Try-On-Vorschaubild betrachten
- 6Aktionen: Modal schließen oder erneut mit anderem Foto versuchen
Admin-Überwachung
- Generierungszähler: Gesamte Try-On-Generierungen in Einstellungen verfolgen
- Debug-Protokolle: Verarbeitung in Server-Fehlerprotokollen überwachen (falls Debug aktiviert)
- Lizenzstatus: Regelmäßige Validierung gewährleistet fortgesetzte Funktionalität
KI-Anbieter-Setup
Google Gemini (Empfohlen)
Setup:
- Google Cloud Projekt erstellen: Gehen Sie zur Google Cloud Console, klicken Sie auf "Projekt erstellen", geben Sie einen Projektnamen ein und klicken Sie auf "Erstellen"
- Gemini API aktivieren: Navigieren Sie in Ihrem Projekt-Dashboard zu "APIs & Services" → "Bibliothek", suchen Sie nach "Generative AI API" oder "Gemini API" und klicken Sie auf "Aktivieren"
- API-Schlüssel generieren: Gehen Sie zu "APIs & Services" → "Anmeldedaten", klicken Sie auf "Anmeldedaten erstellen" → "API-Schlüssel", kopieren Sie den generierten Schlüssel und beschränken Sie ihn optional für die Sicherheit
- Modell auf gemini-2.5-flash-image-preview in den Plugin-Einstellungen setzen
Funktionen:
- Hochwertige Bildgenerierung
- Schnelle Verarbeitung (10-20 Sekunden)
- Zuverlässige Betriebszeit
- Eingebaute Sicherheitsfilter
Einschränkungen:
- Erfordert Google Cloud-Konto
- Nutzungsbasierte Preisgestaltung
- Ratenlimits gelten
Benutzerdefinierter Endpunkt
Anforderungen:
- RESTful API-Endpunkt
- Akzeptiert POST-Anfragen mit Bilddaten
- Gibt JSON-Antwort mit generiertem Bild zurück
Häufige Probleme & Lösungen
Try-On-Button wird nicht angezeigt
- Prüfen: Produkt hat "Optisches Try-On aktivieren" angehakt
- Prüfen: WooCommerce ist aktiv und aktualisiert
- Prüfen: Theme-Kompatibilität (Standard-Theme versuchen)
500 Interner Server-Fehler
- Prüfen: PHP-Fehlerprotokolle für spezifische Fehler
- Prüfen: Speicherlimit (auf 256MB+ erhöhen)
- Prüfen: Ausführungszeit-Limit (60+ Sekunden)
- Prüfen: Datei-Upload-Limits
Kamera funktioniert nicht
- Prüfen: HTTPS ist aktiviert (erforderlich für Kamerazugriff)
- Prüfen: Browser-Berechtigungen erteilt
- Prüfen: Gerät hat verfügbare Kamera
KI-Generierung schlägt fehl
- Prüfen: API-Schlüssel ist gültig und hat Guthaben
- Prüfen: Netzwerkverbindung zum KI-Anbieter
- Prüfen: Bilddateigröße (unter 10MB empfohlen)
- Prüfen: Debug-Protokolle für spezifische Fehlermeldungen
Debug-Modus
Debug-Modus in Einstellungen aktivieren, um detaillierte Protokolle zu erhalten:
- 1Zu WooCommerce → Virtual Try-On gehen
- 2Debug-Modus ankreuzen
- 3Einstellungen speichern
- 4Server-Fehlerprotokolle für detaillierte Informationen prüfen