Topdata Colors SW6
Einführung
Topdata Colors SW6 ist ein leistungsstarkes Shopware 6 Plugin, das Ihren Online-Shop durch die Anzeige visueller Farbindikatoren für Produkte erweitert. Das Plugin generiert automatisch Farbpunkte oder benutzerdefinierte Formen basierend auf Produkteigenschaften und erleichtert es Kunden, Produkte anhand ihrer Farbe zu identifizieren und auszuwählen.
Hauptvorteile
- Verbesserte Benutzererfahrung: Kunden können Produktfarben auf einen Blick schnell identifizieren
- Visuelle Produktdifferenzierung: Heben Sie sich von der Konkurrenz durch klare Farbvisualisierung ab
- Flexible Konfiguration: Wählen Sie aus mehreren Anzeigestilen oder erstellen Sie Ihre eigenen
- Nahtlose Integration: Funktioniert automatisch mit bestehenden Shopware Templates
- Mehrsprachige Unterstützung: Unterstützt sowohl deutsche als auch englische Farbnamen
Funktionsweise
Das Plugin liest Farbinformationen aus Produkteigenschaften und zeigt entsprechende Farbpunkte an in:
- Produktlistenseiten
- Produktdetailseiten
- Suchergebnissen
- Cross-Selling-Bereichen
Farben werden automatisch über eine umfangreiche integrierte Datenbank mit über 200 Farbnamen zugeordnet, oder Sie können Ihre eigenen benutzerdefinierten Farbzuordnungen definieren.
Erste Schritte
- Installation: Folgen Sie der Installationsanleitung in
10-installation.de.md - Konfiguration: Richten Sie die Plugin-Einstellungen wie in
30-settings.de.mdbeschrieben ein - Verwendung: Erfahren Sie, wie Sie Ihre Produkte in
50-usage.de.mdkonfigurieren - Fehlerbehebung: Prüfen Sie die FAQ in
40-faq.de.mdfür häufige Fragen
Support
Für technischen Support und zusätzliche Ressourcen besuchen Sie TopData Software GmbH.
Installationsanleitung
Systemanforderungen
Bevor Sie Topdata Colors SW6 installieren, stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt:
- Shopware Version: 6.6.* oder 6.7.*
- PHP Version: 8.1 oder höher
- Server-Anforderungen: Standard Shopware 6 Server-Anforderungen
Installationsschritte
1. Download und Entpacken
- Laden Sie das Plugin-Paket von Ihrer Quelle herunter
- Entpacken Sie die Plugin-Dateien in Ihr Shopware-Installationsverzeichnis:
/custom/plugins/topdata-colors-sw6/
2. Installation über Composer (Empfohlen)
Falls Sie das Plugin über Composer verfügbar haben:
composer require topdata/topdata-colors
3. Manuelle Installation
Bei manueller Installation:
- Kopieren Sie alle Plugin-Dateien nach
/custom/plugins/topdata-colors-sw6/ - Stellen Sie sicher, dass die richtigen Dateiberechtigungen gesetzt sind
4. Plugin-Installationsbefehle
Führen Sie die folgenden Befehle in Ihrem Shopware-Stammverzeichnis aus:
# Plugin-Liste aktualisieren
bin/console plugin:refresh
# Plugin installieren
bin/console plugin:install --activate TopdataColors
# Cache leeren
bin/console cache:clear
5. Installation überprüfen
- Melden Sie sich in Ihrer Shopware Administration an
- Navigieren Sie zu Erweiterungen > Meine Erweiterungen
- Überprüfen Sie, dass “Topdata Colors” in der Liste der installierten Plugins erscheint
- Prüfen Sie, dass der Plugin-Status als “Aktiv” angezeigt wird
Einrichtung nach der Installation
Nach erfolgreicher Installation:
- Plugin-Einstellungen konfigurieren: Gehen Sie zu Erweiterungen > Meine Erweiterungen > Topdata Colors > Konfigurieren
- Eigenschaftsgruppen einrichten: Konfigurieren Sie, welche Eigenschaftsgruppen für die Farbanzeige verwendet werden sollen
- Anzeige testen: Erstellen Sie ein Testprodukt mit Farbeigenschaften, um zu überprüfen, ob das Plugin korrekt funktioniert
Fehlerbehebung bei der Installation
Plugin nicht sichtbar
- Stellen Sie sicher, dass sich die Dateien im korrekten Verzeichnis befinden:
/custom/plugins/topdata-colors-sw6/ - Führen Sie
bin/console plugin:refreshaus, um die Plugin-Liste zu aktualisieren - Überprüfen Sie die Dateiberechtigungen
Installation schlägt fehl
- Überprüfen Sie die Shopware-Versionskompatibilität (6.6.* oder 6.7.*)
- Prüfen Sie die PHP-Versionsanforderungen
- Überprüfen Sie die Server-Fehlerprotokolle auf spezifische Fehlermeldungen
- Stellen Sie ausreichend Festplattenspeicher und Arbeitsspeicher sicher
Cache-Probleme
- Leeren Sie alle Caches:
bin/console cache:clear - Falls Sie Redis oder andere Cache-Systeme verwenden, leeren Sie diese ebenfalls
- Starten Sie den Webserver bei Bedarf neu
Deinstallation
Um das Plugin zu entfernen:
# Plugin deaktivieren
bin/console plugin:deactivate TopdataColors
# Plugin deinstallieren
bin/console plugin:uninstall TopdataColors
# Cache leeren
bin/console cache:clear
Hinweis: Die Deinstallation des Plugins entfernt standardmäßig nicht Ihre Konfigurationsdaten. Wenn Sie alle Plugin-Daten vollständig entfernen möchten, verwenden Sie das Flag --keep-user-data=false:
bin/console plugin:uninstall --keep-user-data=false TopdataColors
Konfigurationseinstellungen
Greifen Sie auf die Plugin-Konfiguration über Erweiterungen > Meine Erweiterungen > Topdata Colors > Konfigurieren in Ihrer Shopware Administration zu.
Konfigurationsoptionen
1. Farben Darstellung
Feldname: colorStyle
Typ: Einfachauswahl
Standardwert: drop
Wählen Sie den visuellen Stil für die Anzeige von Farbindikatoren:
- Tropfen: Tropfenförmige Farbindikatoren
- Punkt: Kreisförmige Farbpunkte
- Quadrat: Quadratische Farbindikatoren
- Kursiv Quadrat: Geneigte quadratische Farbindikatoren
Jeder Stil verwendet eine vordefinierte SVG-Form, die mit der entsprechenden Farbe gefüllt wird. Der ausgewählte Stil gilt für alle Farbanzeigen in Ihrem Shop.
2. Eigenes Farben SVG
Feldname: ownSvg
Typ: Textbereich
Standardwert: Leer
Laden Sie Ihren eigenen benutzerdefinierten SVG-Code für die Farbanzeige hoch. Wenn dieses Feld SVG-Code enthält, wird die Auswahl “Farben Darstellung” oben ignoriert.
Wichtige Hinweise:
- Die Farbe wird über die CSS-Eigenschaft
fillangewendet - Ihr SVG sollte für die Verwendung mit dynamischen Füllfarben konzipiert sein
- Eine CSS-Klasse
own-svgwird automatisch auf benutzerdefinierte SVG-Elemente angewendet - Stellen Sie sicher, dass Ihr SVG ordnungsgemäß formatiert und gültig ist
Beispiel SVG-Struktur:
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.2" baseProfile="tiny" xmlns="http://www.w3.org/2000/svg"
viewBox="0 0 1280 1280" xml:space="preserve">
<path d="M6094.9,12800L6094.9,12800L40,0h12760"/>
</svg>
3. Eigene/überschriebene Farben
Feldname: colorOverwrite
Typ: Textbereich
Standardwert: Leer
Definieren Sie benutzerdefinierte Farbzuordnungen oder überschreiben Sie bestehende Farbdefinitionen.
Wichtiger Hinweis: Diese Einstellung hat die höchste Priorität. Eine hier definierte Farbe überschreibt sowohl den in einer Eigenschaft gesetzten Hex-Code als auch die integrierte Farbdatenbank des Plugins.
Dies ermöglicht es Ihnen:
- Neue Farbnamen hinzuzufügen, die nicht in der integrierten Datenbank enthalten sind
- Bestehende Farbdefinitionen mit anderen Hex-Codes zu überschreiben
- Mehrfarbige Kombinationen zu erstellen
Erweiterte Farbdefinitionen:
- Einzelfarbe:
rot|#ff0000 - Mehrfarbig:
regenbogen|#ff0000/#00ff00/#0000ff - CSS-Verläufe:
verlauf|linear-gradient(45deg, #ff0000, #0000ff) - Muster-Überschreibungen:
streifen|repeating-linear-gradient(45deg, #000, #000 2px, #fff 2px, #fff 4px)
4. Farben Eigenschaften
Feldname: colorPropertyGroups
Typ: Mehrfachauswahl Entity-Selektor
Entity: Eigenschaftsgruppen
Standardwert: Leer
Wählen Sie aus, welche Eigenschaftsgruppen für die Farbanzeige verwendet werden sollen. Nur Eigenschaften aus den ausgewählten Gruppen werden für die Farbvisualisierung verarbeitet.
Einrichtungsprozess:
- Erstellen Sie zunächst Eigenschaftsgruppen unter Kataloge > Eigenschaften
- Fügen Sie farbbezogene Eigenschaften zu diesen Gruppen hinzu (z.B. “Farbe”, “Color”, “Hauptfarbe”)
- Wählen Sie die entsprechenden Eigenschaftsgruppen in diesem Konfigurationsfeld aus
- Weisen Sie diese Eigenschaften Ihren Produkten zu
Best Practices:
- Erstellen Sie dedizierte Eigenschaftsgruppen speziell für Farben
- Verwenden Sie klare, beschreibende Namen für Farbeigenschaften
- Erwägen Sie separate Gruppen für verschiedene Farbtypen (Hauptfarbe, Akzentfarbe, etc.)
- Stellen Sie sicher, dass Eigenschaftsnamen mit der integrierten Farbdatenbank oder Ihren benutzerdefinierten Überschreibungen übereinstimmen
Integrierte Farbdatenbank
Das Plugin enthält eine umfangreiche Datenbank mit über 200 Farbnamen und entsprechenden Hex-Codes, die sowohl englische als auch deutsche Farbnamen unterstützt:
Beispiele unterstützter Farben:
- Grundfarben:
red,blue,green,yellow,black,white - Deutsche Farben:
rot,blau,grün,gelb,schwarz,weiß - Erweiterte Farben:
aquamarine,kornblumenblau,dunkelschiefergrau - Spezielle Kombinationen:
multicolor,transparent,3-farbig
Erweiterte Konfigurationstipps
Mehrfarbige Produkte
Das Plugin unterstützt komplexe Farbkombinationen mit spezieller Syntax:
- Anzahl-Präfix:
3x rotzeigt drei rote Punkte an - Farbkombinationen:
rot+blau(primär) oderrot/blau(legacy) für mehrfarbige Artikel - Gemischte Syntax:
2x rot+blaufür zwei rot-blaue Kombinationspunkte
CSS-Anpassung
Sie können das Erscheinungsbild mit CSS weiter anpassen:
- Zielen Sie auf
.topdata-colorfür den Hauptcontainer - Verwenden Sie
.colorfür einzelne Farbelemente - Wenden Sie Stile auf spezifische Form-Klassen an:
.drop,.circle,.quad,.cursivequad,.own-svg
Performance-Überlegungen
- Begrenzen Sie die Anzahl der ausgewählten Eigenschaftsgruppen zur Verbesserung der Performance
- Verwenden Sie die integrierte Farbdatenbank wenn möglich, anstatt umfangreiche benutzerdefinierte Überschreibungen
- Berücksichtigen Sie Cache-Auswirkungen bei der Verwendung komplexer CSS-Verläufe oder Muster
Häufig gestellte Fragen
Allgemeine Fragen
F: Was ist der Zweck dieses Plugins?
A: Topdata Colors SW6 zeigt visuelle Farbindikatoren (Punkte, Formen) auf Produktlisten und Detailseiten basierend auf Produkteigenschaften an. Dies hilft Kunden, Produktfarben schnell zu identifizieren, ohne Textbeschreibungen lesen zu müssen.
F: Welche Shopware-Versionen werden unterstützt?
A: Das Plugin unterstützt Shopware 6.6.* und 6.7.* Versionen.
F: Funktioniert das Plugin mit benutzerdefinierten Themes?
A: Ja, das Plugin integriert sich in Shopwares Template-System und sollte mit den meisten benutzerdefinierten Themes funktionieren. Die Farbanzeigen werden über Template-Erweiterungen hinzugefügt, die das Styling Ihres Themes respektieren.
Einrichtung und Konfiguration
F: Warum sehe ich keine Farbpunkte bei meinen Produkten?
A: Überprüfen Sie folgende Punkte:
- Stellen Sie sicher, dass Sie Eigenschaftsgruppen in der Plugin-Konfiguration ausgewählt haben
- Überprüfen Sie, dass Ihre Produkte Eigenschaften aus diesen Gruppen zugewiesen haben
- Stellen Sie sicher, dass die Eigenschaftsnamen mit Farben in der integrierten Datenbank oder Ihren benutzerdefinierten Überschreibungen übereinstimmen
- Leeren Sie den Cache nach Konfigurationsänderungen
F: Wie füge ich eine neue Farbe hinzu, die nicht in der integrierten Datenbank enthalten ist?
A: Verwenden Sie das Feld “Eigene/überschriebene Farben” in der Plugin-Konfiguration:
meineneufarbe|#ff5733
Jede Farbdefinition sollte in einer separaten Zeile stehen, wobei Farbname und Hex-Code durch ein Pipe-Symbol (|) getrennt sind.
F: Kann ich benutzerdefinierte Farbnamen in verschiedenen Sprachen verwenden?
A: Ja, Sie können benutzerdefinierte Farbnamen in jeder Sprache mit der Farbüberschreibungsfunktion definieren:
rouge|#ff0000
azul|#0000ff
F: Wie erstelle ich mehrfarbige Indikatoren?
A: Verwenden Sie Pluszeichen, um mehrere Farben zu trennen (primärer Trenner):
regenbogen|#ff0000+#00ff00+#0000ff
Schrägstriche werden weiterhin aus Gründen der Abwärtskompatibilität unterstützt:
regenbogen|#ff0000/#00ff00/#0000ff
Dies erstellt mehrere Farbpunkte für eine einzelne Eigenschaft.
Eigenschaftseinrichtung
F: Wie richte ich Eigenschaftsgruppen für Farben ein?
A:
- Gehen Sie zu Kataloge > Eigenschaften in der Shopware Administration
- Erstellen Sie eine neue Eigenschaftsgruppe (z.B. “Farben”)
- Fügen Sie einzelne Farbeigenschaften zu dieser Gruppe hinzu (z.B. “Rot”, “Blau”, “Grün”)
- Wählen Sie in der Plugin-Konfiguration diese Eigenschaftsgruppe aus
- Weisen Sie diese Eigenschaften Ihren Produkten zu
F: Kann ich mehrere Eigenschaftsgruppen für Farben verwenden?
A: Ja, Sie können mehrere Eigenschaftsgruppen in der Plugin-Konfiguration auswählen. Das Plugin verarbeitet Eigenschaften aus allen ausgewählten Gruppen.
F: Was passiert, wenn ein Produkt mehrere Farbeigenschaften hat?
A: Alle Farbeigenschaften aus den ausgewählten Gruppen werden angezeigt. Jede Eigenschaft erstellt ihren eigenen Farbindikator.
Erweiterte Funktionen
F: Wie funktioniert die Anzahl-Syntax (z.B. “3x rot”)?
A: Das Plugin erkennt Anzahl-Präfixe:
3x rotzeigt drei rote Punkte an2x blau+weißzeigt zwei blau-weiße Kombinationspunkte an- Das Format ist
[Zahl]x [Farbe]
F: Kann ich CSS-Verläufe oder Muster verwenden?
A: Ja, Sie können jeden gültigen CSS-Farbwert in den Farbüberschreibungen verwenden:
verlauf|linear-gradient(45deg, #ff0000, #0000ff)
streifen|repeating-linear-gradient(45deg, #000, #000 2px, #fff 2px, #fff 4px)
F: Wie verwende ich benutzerdefinierte SVG-Formen?
A: Fügen Sie Ihren SVG-Code in das Feld “Eigenes Farben SVG” in der Plugin-Konfiguration ein. Das SVG sollte für die Verwendung mit der CSS-Eigenschaft fill für die Farbgebung konzipiert sein.
Fehlerbehebung
F: Farben werden nicht korrekt angezeigt
A: Dies liegt normalerweise an der Prioritätenreihenfolge, in der Farben zugewiesen werden. Überprüfen Sie die folgenden Punkte in dieser Reihenfolge:
- Plugin-Konfiguration prüfen: Schauen Sie unter “Eigene/überschriebene Farben” nach. Eine Definition hier überschreibt alles andere.
- Eigenschafts-Hex-Code prüfen: Kontrollieren Sie, ob bei der Eigenschaft selbst (unter Kataloge > Eigenschaften) ein Farb-Hex-Code hinterlegt ist. Dieser überschreibt die integrierte Datenbank.
- Eigenschaftsnamen prüfen: Stellen Sie sicher, dass der Name der Eigenschaft exakt mit einem Eintrag in der integrierten Farbdatenbank übereinstimmt (Groß-/Kleinschreibung wird ignoriert).
- Cache leeren: Leeren Sie nach jeder Änderung den Shop- und Browser-Cache.
F: Plugin-Konfiguration wird nicht gespeichert
A:
- Überprüfen Sie Dateiberechtigungen der Shopware-Installation
- Überprüfen Sie die Datenbankverbindung
- Suchen Sie nach Fehlermeldungen in den Shopware-Logs
- Stellen Sie sicher, dass Sie über ordnungsgemäße Admin-Berechtigungen verfügen
F: Farben erscheinen, aber mit falschen Farben
A: Dies liegt normalerweise an der Prioritätenreihenfolge, in der Farben zugewiesen werden. Überprüfen Sie die folgenden Punkte in dieser Reihenfolge:
- Plugin-Konfiguration prüfen: Schauen Sie unter “Eigene/überschriebene Farben” nach. Eine Definition hier überschreibt alles andere.
- Eigenschafts-Hex-Code prüfen: Kontrollieren Sie, ob bei der Eigenschaft selbst (unter Kataloge > Eigenschaften) ein Farb-Hex-Code hinterlegt ist. Dieser überschreibt die integrierte Datenbank.
- Eigenschaftsnamen prüfen: Stellen Sie sicher, dass der Name der Eigenschaft exakt mit einem Eintrag in der integrierten Farbdatenbank übereinstimmt (Groß-/Kleinschreibung wird ignoriert).
- Cache leeren: Leeren Sie nach jeder Änderung den Shop- und Browser-Cache.
F: Performance-Probleme bei vielen Produkten
A:
- Begrenzen Sie die Anzahl der ausgewählten Eigenschaftsgruppen
- Vermeiden Sie komplexe CSS-Verläufe für große Produktkataloge
- Erwägen Sie die Verwendung einfacher Hex-Farben anstelle von Verläufen
- Stellen Sie sicher, dass ordnungsgemäßes Caching aktiviert ist
Integrationsfragen
F: Funktioniert dies mit Produktvarianten?
A: Ja, das Plugin funktioniert mit Produktvarianten. Jede Variante kann ihre eigenen Farbeigenschaften haben und wird entsprechend angezeigt.
F: Kann ich das CSS-Styling anpassen?
A: Ja, Sie können benutzerdefiniertes CSS hinzufügen, um das Erscheinungsbild zu ändern:
.topdata-color- Hauptcontainer.color- Einzelne Farbelemente.drop,.circle,.quad,.cursivequad,.own-svg- Formspezifische Klassen
F: Beeinflusst dies die Suchfunktionalität?
A: Nein, das Plugin fügt nur visuelle Elemente hinzu und ändert nicht Shopwares Suchfunktionalität.
F: Kann ich Farben für bestimmte Produkte deaktivieren?
A: Weisen Sie einfach keine Farbeigenschaften zu Produkten zu, bei denen keine Farbanzeigen erscheinen sollen.
Migration und Updates
F: Was passiert mit meiner Konfiguration beim Update des Plugins?
A: Ihre Konfigurationseinstellungen bleiben bei Plugin-Updates erhalten. Sichern Sie jedoch immer Ihre Konfiguration vor dem Update.
F: Kann ich Farbkonfigurationen exportieren/importieren?
A: Derzeit gibt es keine integrierte Export-/Import-Funktion. Sie können die Konfigurationswerte manuell aus den Plugin-Einstellungen kopieren.
F: Wie migriere ich von einer älteren Version?
A: Folgen Sie dem Standard-Shopware-Plugin-Update-Prozess. Überprüfen Sie das Changelog auf Breaking Changes oder erforderliche Migrationsschritte.
Support
F: Wo kann ich zusätzlichen Support erhalten?
A: Kontaktieren Sie TopData Software GmbH über ihre Website unter https://www.topdata.de für technischen Support und zusätzliche Ressourcen.
F: Wie melde ich Bugs oder fordere Features an?
A: Kontaktieren Sie den Plugin-Entwickler über die offiziellen Support-Kanäle von TopData Software GmbH.
Verwendungsanleitung
Diese Anleitung erklärt, wie Sie die Farbanzeigefunktionalität in Ihrem Shopware-Shop einrichten und verwenden.
Einrichtung von Produkteigenschaften
Schritt 1: Eigenschaftsgruppen erstellen
- Navigieren Sie zu Kataloge > Eigenschaften in Ihrer Shopware Administration
- Klicken Sie auf Eigenschaftsgruppe hinzufügen
- Geben Sie einen Namen für Ihre Farb-Eigenschaftsgruppe ein (z.B. “Produktfarben”, “Hauptfarbe”, “Akzentfarbe”)
- Konfigurieren Sie die Gruppeneinstellungen:
- Anzeigetyp: Wählen Sie, wie Eigenschaften in Filtern angezeigt werden sollen
- Sortierungstyp: Legen Sie fest, wie Farboptionen sortiert werden sollen
- Filterbar: Aktivieren Sie dies, wenn Kunden nach Farben filtern können sollen
Schritt 2: Farbeigenschaften hinzufügen
- Öffnen Sie Ihre neu erstellte Eigenschaftsgruppe
- Klicken Sie auf Eigenschaft hinzufügen, um einzelne Farboptionen hinzuzufügen
- Für jede Farbeigenschaft:
- Name: Geben Sie den Farbnamen ein (z.B. “Rot”, “Blau”, “Waldgrün”)
- Farb-Hex-Code: Setzen Sie optional einen spezifischen Hex-Code (dies überschreibt die integrierten Farben des Plugins)
- Position: Legen Sie die Anzeigereihenfolge fest
- Medien: Fügen Sie optional ein Farbmuster-Bild hinzu
Schritt 3: Plugin-Einstellungen konfigurieren
- Gehen Sie zu Erweiterungen > Meine Erweiterungen > Topdata Colors > Konfigurieren
- Wählen Sie im Feld Farben Eigenschaften die von Ihnen erstellten Eigenschaftsgruppen aus
- Konfigurieren Sie andere Einstellungen nach Bedarf (siehe Konfigurationseinstellungen-Anleitung)
- Speichern Sie die Konfiguration
Schritt 4: Eigenschaften zu Produkten zuweisen
- Bearbeiten Sie ein Produkt unter Kataloge > Produkte
- Gehen Sie zum Tab Eigenschaften
- Wählen Sie die entsprechenden Farbeigenschaften für dieses Produkt aus
- Speichern Sie das Produkt
Verstehen der Farbanzeige-Logik
Prioritäten der Farbzuordnung
Das Plugin ermittelt die Farbe für eine Eigenschaft anhand einer klaren Prioritätenreihenfolge. Sobald eine passende Farbe gefunden wird, werden die nachfolgenden Schritte ignoriert:
-
Benutzerdefinierte Farbüberschreibungen (Höchste Priorität)
- Das Plugin prüft zuerst, ob der Name der Eigenschaft in der Plugin-Konfiguration unter “Eigene/überschriebene Farben” definiert ist.
- Beispiel: Wenn Sie
rot|#FF00FFdefinieren, wird “Rot” immer als Pink angezeigt, unabhängig von anderen Einstellungen.
-
Eigenschafts-Hex-Code
- Wenn keine benutzerdefinierte Überschreibung gefunden wird, prüft das Plugin, ob für die Eigenschaft selbst ein “Farb-Hex-Code” in der Shopware-Administration (unter Kataloge > Eigenschaften) hinterlegt ist.
- Beispiel: Wenn die Eigenschaft “Rot” den Hex-Code
#FFC0CBhat, wird dieser verwendet.
-
Integrierte Farbdatenbank (Niedrigste Priorität)
- Wenn keine der oben genannten Bedingungen zutrifft, sucht das Plugin den Eigenschaftsnamen in seiner integrierten Datenbank mit über 200 vordefinierten Farben.
- Beispiel: Wenn die Eigenschaft “Rot” heißt und nirgendwo überschrieben wurde, wird der Standardwert
#ff0000verwendet.
Farbnamen-Zuordnung
Farbnamen werden case-insensitiv zugeordnet. Diese funktionieren alle gleich:
- “Rot” → entspricht der integrierten roten Farbe
- “rot” → entspricht der integrierten roten Farbe
- “ROT” → entspricht der integrierten roten Farbe
Mehrfarben-Syntax
Das Plugin unterstützt erweiterte Farbkombinationen:
Anzahl-Präfixe
3x rot→ Zeigt 3 rote Punkte an2x blau→ Zeigt 2 blaue Punkte an
Farbkombinationen
rot+blau→ Zeigt rote und blaue Punkte zusammen an (primärer Trenner)rot/blau→ Legacy-Trenner (weiterhin aus Gründen der Abwärtskompatibilität unterstützt)rot+blau+grün→ Zeigt drei Farben zusammen an
Komplexe Beispiele
2x rot+blau→ Zeigt 2 Kombinationspunkte an (jeweils mit rot und blau)3x mehrfarbig→ Zeigt 3 mehrfarbige Punkte anrot, blau, grün→ Zeigt separate Farbgruppen an (kommagetrennt)
Produkteinrichtungsbeispiele
Beispiel 1: Einfaches einfarbiges Produkt
Produkt: Rotes T-Shirt Eigenschaftszuweisung: “Rot” aus der Gruppe “Produktfarben” Ergebnis: Einzelner roter Punkt wird angezeigt
Beispiel 2: Mehrfarbiges Produkt
Produkt: Gestreiftes Hemd Eigenschaftszuweisung: “Rot+Blau” aus der Gruppe “Produktfarben” Ergebnis: Rote und blaue Punkte werden zusammen angezeigt
Beispiel 3: Produkt mit mehreren Farboptionen
Produkt: In mehreren Farben verfügbar Eigenschaftszuweisung: “Rot”, “Blau”, “Grün” aus der Gruppe “Produktfarben” Ergebnis: Drei separate Farbpunkte werden angezeigt
Beispiel 4: Produkt mit Farbvariationen
Produkt: Jacke mit Akzentfarben Eigenschaftszuweisung:
- “Schwarz” aus der Gruppe “Hauptfarbe”
- “Rot” aus der Gruppe “Akzentfarbe” Ergebnis: Schwarzer Punkt und roter Punkt werden angezeigt
Best Practices
Eigenschaftsbenennung
- Verwenden Sie Standardfarbnamen wenn möglich (rot, blau, grün, etc.)
- Seien Sie konsistent in Ihrem Produktkatalog
- Verwenden Sie beschreibende Namen für benutzerdefinierte Farben (z.B. “Waldgrün” statt “Grün1”)
- Berücksichtigen Sie Übersetzungen wenn Sie in mehreren Sprachen operieren
Organisation von Eigenschaftsgruppen
-
Erstellen Sie spezifische Gruppen für verschiedene Farbtypen:
- “Hauptfarbe” für primäre Produktfarben
- “Akzentfarbe” für sekundäre Farben
- “Musterfarben” für mehrfarbige Muster
-
Halten Sie Gruppen fokussiert - mischen Sie Farbeigenschaften nicht mit anderen Attributen
-
Verwenden Sie klare Benennung, die für Ihr Team sinnvoll ist
Farbüberschreibungsstrategie
- Beginnen Sie mit integrierten Farben bevor Sie benutzerdefinierte Überschreibungen hinzufügen
- Dokumentieren Sie benutzerdefinierte Farben für Ihr Team
- Verwenden Sie Hex-Codes konsistent (#ff0000 Format)
- Testen Sie Farbkombinationen bevor Sie live gehen
Anzeigeorte
Farben erscheinen automatisch in:
Produktlistenseiten
- Kategorienseiten
- Suchergebnisse
- Markenseiten
- Tag-Seiten
Produktdetailseiten
- Hauptproduktinformationsbereich
- Variantenauswahl (falls zutreffend)
Cross-Selling-Bereiche
- Verwandte Produkte
- Empfohlene Produkte
- Kürzlich angesehene Produkte
Vergleichsfunktionen
- Produktvergleichs-Popups
- Wunschlistenanzeigen
Fehlerbehebung häufiger Probleme
Farben erscheinen nicht
- Überprüfen Sie die Eigenschaftsgruppenauswahl in der Plugin-Konfiguration
- Überprüfen Sie die Eigenschaftszuweisung zu Produkten
- Leeren Sie den Cache nach Konfigurationsänderungen
- Überprüfen Sie die Farbnamen-Schreibweise gegen die integrierte Datenbank
Falsche Farben werden angezeigt
- Überprüfen Sie Eigenschaftsnamen gegen Farbdatenbankeinträge
- Überprüfen Sie benutzerdefinierte Farbüberschreibungen auf Konflikte
- Überprüfen Sie Eigenschafts-Hex-Codes in der Eigenschaftskonfiguration
- Testen Sie mit einfachen Farbnamen zuerst
Performance-Optimierung
- Begrenzen Sie Eigenschaftsgruppen auf nur die für Farben benötigten
- Verwenden Sie einfache Farbnamen statt komplexer Überschreibungen wenn möglich
- Vermeiden Sie übermäßige benutzerdefinierte SVG-Komplexität
- Überwachen Sie Seitenladezeiten bei vielen Farbeigenschaften
Erweiterte Verwendung
Benutzerdefinierte Farbdefinitionen
Für Farben, die nicht in der integrierten Datenbank enthalten sind, fügen Sie sie zu den Farbüberschreibungen hinzu:
firmen-blau|#1e3a8a
marken-rot|#dc2626
benutzerdefiniert-grün|#059669
Muster- und Verlaufsfarben
Erstellen Sie spezielle visuelle Effekte:
regenbogen|linear-gradient(45deg, #ff0000, #00ff00, #0000ff)
streifen|repeating-linear-gradient(45deg, #000, #000 2px, #fff 2px, #fff 4px)
Mehrsprachige Unterstützung
Definieren Sie Farbnamen in mehreren Sprachen:
rot|#ff0000
rouge|#ff0000
rojo|#ff0000
Integration mit Themes
Das Plugin funktioniert mit den meisten Shopware-Themes. Falls Sie das Erscheinungsbild anpassen müssen:
- Überschreiben Sie Templates in Ihrem Theme falls nötig
- Fügen Sie benutzerdefiniertes CSS hinzu, um Farbanzeigen zu stylen
- Verwenden Sie bereitgestellte CSS-Klassen für das Styling:
.topdata-color- Hauptcontainer.color- Einzelne Farbelemente.group- Farbgruppen-Container
Testen Ihrer Einrichtung
- Erstellen Sie Testprodukte mit verschiedenen Farbkombinationen
- Überprüfen Sie verschiedene Seitentypen (Listing, Detail, Suche)
- Testen Sie mit verschiedenen Geräten und Bildschirmgrößen
- Überprüfen Sie die Farbgenauigkeit entspricht Ihren Erwartungen
- Testen Sie die Performance mit realistischen Produktkatalogen
Durch das Befolgen dieser Anleitung sollten Sie in der Lage sein, die Farbanzeigefunktionalität erfolgreich in Ihrem Shopware-Shop zu implementieren und zu verwenden.