Topdata Topdata Docs

TopdataColors

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

  1. Installation: Folgen Sie der Installationsanleitung in 10-installation.de.md
  2. Konfiguration: Richten Sie die Plugin-Einstellungen wie in 30-settings.de.md beschrieben ein
  3. Verwendung: Erfahren Sie, wie Sie Ihre Produkte in 50-usage.de.md konfigurieren
  4. Fehlerbehebung: Prüfen Sie die FAQ in 40-faq.de.md fü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

  1. Laden Sie das Plugin-Paket von Ihrer Quelle herunter
  2. 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:

  1. Kopieren Sie alle Plugin-Dateien nach /custom/plugins/topdata-colors-sw6/
  2. 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

  1. Melden Sie sich in Ihrer Shopware Administration an
  2. Navigieren Sie zu Erweiterungen > Meine Erweiterungen
  3. Überprüfen Sie, dass “Topdata Colors” in der Liste der installierten Plugins erscheint
  4. Prüfen Sie, dass der Plugin-Status als “Aktiv” angezeigt wird

Einrichtung nach der Installation

Nach erfolgreicher Installation:

  1. Plugin-Einstellungen konfigurieren: Gehen Sie zu Erweiterungen > Meine Erweiterungen > Topdata Colors > Konfigurieren
  2. Eigenschaftsgruppen einrichten: Konfigurieren Sie, welche Eigenschaftsgruppen für die Farbanzeige verwendet werden sollen
  3. 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:refresh aus, 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 fill angewendet
  • Ihr SVG sollte für die Verwendung mit dynamischen Füllfarben konzipiert sein
  • Eine CSS-Klasse own-svg wird 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.

ID-Überschreibung:

  • Sie können einer spezifischen Property-ID eine gezielte Farbe zuweisen, indem Sie die Property-ID als Schlüssel verwenden, z. B. 01992d6707037fd4bdb44e0d743ce6e0|#ff00ff. Dies überschreibt die Farbe für genau diese Property, unabhängig vom Property-Namen oder anderen Regeln.
  • Diese ID-basierte Zuordnung hat eine höhere Priorität als Namensabgleiche, wird jedoch weiterhin von colorOverwrite überschrieben, wenn dort ein passender Eintrag existiert.

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:

  1. Erstellen Sie zunächst Eigenschaftsgruppen unter Kataloge > Eigenschaften
  2. Fügen Sie farbbezogene Eigenschaften zu diesen Gruppen hinzu (z.B. “Farbe”, “Color”, “Hauptfarbe”)
  3. Wählen Sie die entsprechenden Eigenschaftsgruppen in diesem Konfigurationsfeld aus
  4. 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 rot zeigt drei rote Punkte an
  • Farbkombinationen: rot+blau (primär) oder rot/blau (legacy) für mehrfarbige Artikel
  • Gemischte Syntax: 2x rot+blau für zwei rot-blaue Kombinationspunkte

CSS-Anpassung

Sie können das Erscheinungsbild mit CSS weiter anpassen:

  • Zielen Sie auf .topdata-color für den Hauptcontainer
  • Verwenden Sie .color fü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:

  1. Stellen Sie sicher, dass Sie Eigenschaftsgruppen in der Plugin-Konfiguration ausgewählt haben
  2. Überprüfen Sie, dass Ihre Produkte Eigenschaften aus diesen Gruppen zugewiesen haben
  3. Stellen Sie sicher, dass die Eigenschaftsnamen mit Farben in der integrierten Datenbank oder Ihren benutzerdefinierten Überschreibungen übereinstimmen
  4. 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:

  1. Gehen Sie zu Kataloge > Eigenschaften in der Shopware Administration
  2. Erstellen Sie eine neue Eigenschaftsgruppe (z.B. “Farben”)
  3. Fügen Sie einzelne Farbeigenschaften zu dieser Gruppe hinzu (z.B. “Rot”, “Blau”, “Grün”)
  4. Wählen Sie in der Plugin-Konfiguration diese Eigenschaftsgruppe aus
  5. 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 rot zeigt drei rote Punkte an
  • 2x 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:

  1. Plugin-Konfiguration prüfen: Schauen Sie unter “Eigene/überschriebene Farben” nach. Eine Definition hier überschreibt alles andere.
  2. 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.
  3. Eigenschaftsnamen prüfen: Stellen Sie sicher, dass der Name der Eigenschaft exakt mit einem Eintrag in der integrierten Farbdatenbank übereinstimmt (Groß-/Kleinschreibung wird ignoriert).
  4. Cache leeren: Leeren Sie nach jeder Änderung den Shop- und Browser-Cache.

F: Plugin-Konfiguration wird nicht gespeichert

A:

  1. Überprüfen Sie Dateiberechtigungen der Shopware-Installation
  2. Überprüfen Sie die Datenbankverbindung
  3. Suchen Sie nach Fehlermeldungen in den Shopware-Logs
  4. 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:

  1. Plugin-Konfiguration prüfen: Schauen Sie unter “Eigene/überschriebene Farben” nach. Eine Definition hier überschreibt alles andere.
  2. 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.
  3. Eigenschaftsnamen prüfen: Stellen Sie sicher, dass der Name der Eigenschaft exakt mit einem Eintrag in der integrierten Farbdatenbank übereinstimmt (Groß-/Kleinschreibung wird ignoriert).
  4. Cache leeren: Leeren Sie nach jeder Änderung den Shop- und Browser-Cache.

F: Performance-Probleme bei vielen Produkten

A:

  1. Begrenzen Sie die Anzahl der ausgewählten Eigenschaftsgruppen
  2. Vermeiden Sie komplexe CSS-Verläufe für große Produktkataloge
  3. Erwägen Sie die Verwendung einfacher Hex-Farben anstelle von Verläufen
  4. 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.

F: Kann ich Farben gezielt für bestimmte Property-IDs zuweisen (ID-Überschreibung)?

A: Ja. Sie können eine bestimmte Property per ID ansprechen, indem Sie eine ID-basierte Zuordnung verwenden. Syntax:

property:<id>|<color>

Beispiel:

01992d6707037fd4bdb44e0d743ce6e0|#ff00ff

Dies erzwingt für die Property mit der ID 01992d6707037fd4bdb44e0d743ce6e0 die angegebene Farbe, unabhängig vom Namen oder anderen Zuordnungen. ID-basierte Zuordnungen haben Vorrang vor namensbasierten Zuordnungen, werden jedoch von Einträgen in der Plugin-Einstellung “Eigene/überschriebene Farben” überschrieben, falls dort ein entsprechender Eintrag vorhanden ist.

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

  1. Navigieren Sie zu Kataloge > Eigenschaften in Ihrer Shopware Administration
  2. Klicken Sie auf Eigenschaftsgruppe hinzufügen
  3. Geben Sie einen Namen für Ihre Farb-Eigenschaftsgruppe ein (z.B. “Produktfarben”, “Hauptfarbe”, “Akzentfarbe”)
  4. 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

  1. Öffnen Sie Ihre neu erstellte Eigenschaftsgruppe
  2. Klicken Sie auf Eigenschaft hinzufügen, um einzelne Farboptionen hinzuzufügen
  3. 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

  1. Gehen Sie zu Erweiterungen > Meine Erweiterungen > Topdata Colors > Konfigurieren
  2. Wählen Sie im Feld Farben Eigenschaften die von Ihnen erstellten Eigenschaftsgruppen aus
  3. Konfigurieren Sie andere Einstellungen nach Bedarf (siehe Konfigurationseinstellungen-Anleitung)
  4. Speichern Sie die Konfiguration

Schritt 4: Eigenschaften zu Produkten zuweisen

  1. Bearbeiten Sie ein Produkt unter Kataloge > Produkte
  2. Gehen Sie zum Tab Eigenschaften
  3. Wählen Sie die entsprechenden Farbeigenschaften für dieses Produkt aus
  4. 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:

  1. Property ID-Überschreibungen (Höchste Priorität)

    • Zuerst prüft das Plugin auf Zuordnungen, die gezielt eine Property-ID ansprechen (z. B. 01992d6707037fd4bdb44e0d743ce6e0|#ff00ff). Wenn eine passende Property-ID-Zuordnung vorhanden ist, wird diese verwendet.
    • Beispiel: 01992d6707037fd4bdb44e0d743ce6e0|#FF00FF erzwingt für die Property mit der ID 01992d6707037fd4bdb44e0d743ce6e0 die Darstellung in Pink, unabhängig vom Property-Namen oder anderen Einstellungen.
  2. Benutzerdefinierte Farbüberschreibungen

    • Als Nächstes prüft das Plugin, ob der Name der Eigenschaft in der Plugin-Konfiguration unter “Eigene/überschriebene Farben” definiert ist.
    • Beispiel: Wenn Sie rot|#FF00FF definieren, wird “Rot” angezeigt, sofern keine ID-Überschreibung vorhanden ist.
  3. Eigenschafts-Hex-Code

    • Wenn keine benutzerdefinierte Überschreibung oder ID-Zuordnung gefunden wurde, prüft das Plugin, ob für die Eigenschaft selbst ein “Farb-Hex-Code” in der Shopware-Administration (unter Kataloge > Eigenschaften) hinterlegt ist.
    • Beispiel: Hat die Eigenschaft “Rot” den Hex-Code #FFC0CB, wird dieser Wert verwendet.
  4. Integrierte Farbdatenbank (Niedrigste Priorität)

    • Wenn keine der oben genannten Bedingungen erfüllt sind, durchsucht das Plugin die integrierte Datenbank mit über 200 vordefinierten Farben.
    • Beispiel: Ist die Eigenschaft “Rot” nicht überschrieben, wird der Standardwert #ff0000 verwendet.

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 an
  • 2x 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 an
  • rot, 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

  1. Verwenden Sie Standardfarbnamen wenn möglich (rot, blau, grün, etc.)
  2. Seien Sie konsistent in Ihrem Produktkatalog
  3. Verwenden Sie beschreibende Namen für benutzerdefinierte Farben (z.B. “Waldgrün” statt “Grün1”)
  4. Berücksichtigen Sie Übersetzungen wenn Sie in mehreren Sprachen operieren

Organisation von Eigenschaftsgruppen

  1. 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
  2. Halten Sie Gruppen fokussiert - mischen Sie Farbeigenschaften nicht mit anderen Attributen

  3. Verwenden Sie klare Benennung, die für Ihr Team sinnvoll ist

Farbüberschreibungsstrategie

  1. Beginnen Sie mit integrierten Farben bevor Sie benutzerdefinierte Überschreibungen hinzufügen
  2. Dokumentieren Sie benutzerdefinierte Farben für Ihr Team
  3. Verwenden Sie Hex-Codes konsistent (#ff0000 Format)
  4. 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

  1. Überprüfen Sie die Eigenschaftsgruppenauswahl in der Plugin-Konfiguration
  2. Überprüfen Sie die Eigenschaftszuweisung zu Produkten
  3. Leeren Sie den Cache nach Konfigurationsänderungen
  4. Überprüfen Sie die Farbnamen-Schreibweise gegen die integrierte Datenbank

Falsche Farben werden angezeigt

  1. Überprüfen Sie Eigenschaftsnamen gegen Farbdatenbankeinträge
  2. Überprüfen Sie benutzerdefinierte Farbüberschreibungen auf Konflikte
  3. Überprüfen Sie Eigenschafts-Hex-Codes in der Eigenschaftskonfiguration
  4. Testen Sie mit einfachen Farbnamen zuerst

Performance-Optimierung

  1. Begrenzen Sie Eigenschaftsgruppen auf nur die für Farben benötigten
  2. Verwenden Sie einfache Farbnamen statt komplexer Überschreibungen wenn möglich
  3. Vermeiden Sie übermäßige benutzerdefinierte SVG-Komplexität
  4. Ü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:

  1. Überschreiben Sie Templates in Ihrem Theme falls nötig
  2. Fügen Sie benutzerdefiniertes CSS hinzu, um Farbanzeigen zu stylen
  3. Verwenden Sie bereitgestellte CSS-Klassen für das Styling:
    • .topdata-color - Hauptcontainer
    • .color - Einzelne Farbelemente
    • .group - Farbgruppen-Container

Testen Ihrer Einrichtung

  1. Erstellen Sie Testprodukte mit verschiedenen Farbkombinationen
  2. Überprüfen Sie verschiedene Seitentypen (Listing, Detail, Suche)
  3. Testen Sie mit verschiedenen Geräten und Bildschirmgrößen
  4. Überprüfen Sie die Farbgenauigkeit entspricht Ihren Erwartungen
  5. 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.