Topdata Topdata Docs

TopdataCategoryFilterSW6 v3.0.0 - v3.1.1

Dies ist eine ältere Version des Handbuchs. Neueste Version anzeigen

Topdata Category Filter SW6 Benutzerhandbuch

Überblick

Das Topdata Category Filter SW6 Plugin erweitert die Filterfunktionen von Shopware, indem es einen leistungsfähigen Kategoriefilter hinzufügt. Dieser Filter ermöglicht es den Kunden, sich einfach durch die Produktkategorien zu navigieren, verbessert ihr Einkaufserlebnis und erhöht die Wahrscheinlichkeit, relevante Produkte zu finden.

Hauptmerkmale

  • Fortschrittliche Kategorienfilterung mit mehrstufiger Unterstützung
  • Anpassbare Filtererscheinung und -verhalten
  • Leistungsoptimierungsoptionen
  • Integration mit Elasticsearch für schnelle Suchen
  • Umfassende Konfigurationseinstellungen

Einstieg

Um mit dem Topdata Category Filter SW6 Plugin zu beginnen:

  1. Folgen Sie dem Installationshandbuch, um das Plugin zu installieren und zu aktivieren
  2. Passen Sie die Plugin-Einstellungen nach den Bedürfnissen Ihres Shops an, indem Sie den Einstellungsleitfaden verwenden
  3. Beziehen Sie sich auf die FAQ & Fehlerbehebung für häufige Probleme und Lösungen

Support

Für zusätzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unseren Support-Portal.

Versionshinweise

Version 1.0.0 (Juni 2024)

  • Erstveröffentlichung mit grundlegender Kategorienfilterfunktion
  • Integration mit Shopware 6.4
  • Elasticsearch-Unterstützung für schnelle Kategoriesuchen

Version 1.1.0 (September 2024)

  • Hinzugefügte Leistungsoptimierungseinstellungen
  • Verbesserte UI/UX mit ausklappbaren Unterkategorien
  • Erweiterte Konfigurationsoptionen

Version 1.2.0 (Dezember 2024)

  • Unterstützung für dynamische Produktgruppen
  • Bessere Verwaltung verborgener Kategorien
  • Verschiedene Fehlerbehebungen und Stabilitätsverbesserungen

Roadmap

  • Verbesserte Integration mit anderen Shopware-Plugins
  • Zusätzliche Anpassungsoptionen für die Filter-Benutzeroberfläche
  • Erweiterte Analyse- und Berichtsmerkmale

Topdata Category Filter SW6 Installationshandbuch

Systemanforderungen

  • Shopware 6.5.x oder höher
  • PHP 8.0 oder höher
  • Composer auf Ihrem Server installiert

Installationsschritte

1. Installation über Composer

Öffnen Sie Ihr Terminal und navigieren Sie zu Ihrem Shopware-Projektverzeichnis. Führen Sie den folgenden Befehl aus, um das Plugin zu installieren:

composer require topdata/topdata-category-filter-sw6

2. Aktivieren des Plugins

Nach Abschluss der Installation müssen Sie das Plugin aktivieren. Dies können Sie über das Shopware-Admin-Panel oder die Befehlszeile tun.

Option A: Über das Shopware-Admin-Panel

  1. Melden Sie sich bei Ihrem Shopware-Admin-Panel an
  2. Gehen Sie zu Erweiterungen > Meine Erweiterungen
  3. Finden Sie “Topdata Category Filter SW6” in der Liste
  4. Klicken Sie auf Aktivieren

Option B: Über die Befehlszeile

Führen Sie den folgenden Befehl in Ihrem Shopware-Projektverzeichnis aus:

bin/console plugin:install --activate TopdataCategoryFilterSW6

3. Cache leeren

Nach der Aktivierung des Plugins wird empfohlen, den Cache zu leeren, um sicherzustellen, dass alle Änderungen wirksam werden:

bin/console cache:clear

Verifikation

Um zu überprüfen, ob das Plugin korrekt installiert und aktiviert wurde:

  1. Gehen Sie zur Produktlisten-Seite in Ihrem Storefront
  2. Sie sollten den Kategoriefilter im Filterpanel sehen
  3. Testen Sie die Filterfunktion, indem Sie verschiedene Kategorien auswählen

Fehlerbehebung

Wenn Sie während der Installation auf Probleme stoßen:

  • Überprüfen Sie die Shopware-Fehlerprotokolle auf detaillierte Fehlermeldungen
  • Stellen Sie sicher, dass Ihr Server alle Systemanforderungen erfüllt
  • Überprüfen Sie, ob Composer die notwendigen Berechtigungen zum Installieren von Plugins hat

Topdata Category Filter SW6 Einstellungsleitfaden

Dieser Leitfaden bietet detaillierte Informationen zu allen Konfigurationsoptionen, die im Topdata Category Filter SW6 Plugin verfügbar sind.

Allgemeine Einstellungen

Kategoriefilterkonfiguration

EinstellungStandardBeschreibung
showCategoryFiltertrueAktiviert oder deaktiviert den Kategoriefilter im Storefront.
showNumbertrueZeigt die Anzahl der Produkte in jeder Kategorie an.
collapseSubcategoriestrueBlendet Unterkategorien im Filter zunächst ein. Benutzer können sie erweitern.
showFirsttrueZeigt den Kategoriefilter als ersten Filter im Panel an.
hideOtherBranchestrueBlendet Kategorien aus anderen Kategoriezweigen auf Kategorieseiten aus.
excludeHiddenfalseBlendet Kategorien aus, die als “In Navigation ausblenden” markiert sind.
hideSingleCategorytrueBlendet den Filter aus, wenn nur eine Kategorie verfügbar ist.
hideDynamicCategorytrueBlendet Kategorien mit dynamischen Produktgruppen aus.
popularCount0Zeigt nur Kategorien mit einer Mindestanzahl von Produkten an. Setzen Sie auf 0, um alle anzuzeigen.
hideParentsfalseBlendet übergeordnete Kategorien im Filter aus.
initialFilterStatecollapsedLegt fest, ob Filter-Akkordeons beim Laden der Seite zunächst ein- oder ausgeklappt sein sollen.
sortnoneLegt die Sortierreihenfolge der Kategorien fest (Name, Anzahl oder Standard).

Ansichtsoptionen

Kategoriefilter-Ansichtsoptionen

EinstellungStandardBeschreibung
manyMainCategoriestrueBehandelt Fälle, in denen es nur eine Hauptkategorie gibt, indem sie in Unterkategorien aufgeteilt wird.
joinParentsfalseKombiniert übergeordnete Kategorien in der Anzeige. Kategorienamen werden durch ”/” getrennt.
showParentCategory0Gibt an, wie viele Ebenen übergeordneter Kategorien angezeigt werden sollen (0 bis 20 oder “Alle”).

Leistungseinstellungen

Optimierungsoptionen

EinstellungStandardBeschreibung
hideUnpopularfalseEntfernt Kategorien mit geringer Produktanzahl, um die Leistung zu verbessern.
joinParentstrueVereinigt Elternkategorien mit nur einem Kind, um den Kategoriebbaum zu vereinfachen.
showParentCategory2Begrenzt die Anzahl der angezeigten Elternstufen in Kategorienamen für eine bessere Lesbarkeit.

Empfohlene Konfigurationen

  • Für Geschäfte mit einer tiefen Kategorienstruktur sollten Sie hideUnpopular aktivieren, um die Leistung zu verbessern.
  • Wenn Sie nur eine Hauptkategorie haben, aktivieren Sie manyMainCategories für eine bessere Visualisierung.
  • Für Geschäfte mit dynamischen Produktgruppen möchten Sie möglicherweise hideDynamicCategory deaktivieren.

Visuelle Beispiele

Standardansicht

Standard Kategoriefilter

Eingeklappte Unterkategorien

Eingeklappter Filter

Kombinierte Elternkategorien

Vereinigte Eltern

Topdata Category Filter SW6 FAQ & Fehlerbehebung

Häufige Probleme

SymptomWahrscheinliche UrsacheLösung
Fehlende KategorienAusgeblendete KategorienÜberprüfen Sie die Einstellung excludeHidden in der Plugin-Konfiguration.
Langsame FilterladezeitKomplexe BaumverarbeitungAktivieren Sie die Option hideUnpopular, um Kategorien mit geringer Produktanzahl zu entfernen.
Dynamische Kategorien fehlenMapping-ProblemStellen Sie sicher, dass die Eigenschaft streamCategories korrekt in Ihrem Elasticsearch-Index konfiguriert ist.
URL-Parameter funktionieren nichtVerarbeitung von AnforderungsparameternÜberprüfen Sie die Methode _getCategoryIdsFromRequest in der Subscriber-Klasse.

Fehlerbehebungsleitfaden

1. Fehlende Kategorien im Filter

Wenn Sie feststellen, dass einige Kategorien im Filter nicht angezeigt werden:

  1. Überprüfen Sie, ob die Einstellung excludeHidden aktiviert ist, die Kategorien ausblendet, die als “In Navigation ausblenden” markiert sind.
  2. Stellen Sie sicher, dass den Kategorien Produkte zugewiesen sind.
  3. Überprüfen Sie, ob der Elasticsearch-Index mit den neuesten Kategoriedaten aktualisiert ist.

2. Langsame Filterleistung

Wenn der Kategoriefilter langsam lädt:

  1. Aktivieren Sie die Einstellung hideUnpopular, um Kategorien mit geringer Produktanzahl zu entfernen.
  2. Erhöhen Sie ggf. den popularCount-Schwellenwert, um nur die beliebtesten Kategorien anzuzeigen.
  3. Aktivieren Sie das Caching für die Kategorienbaumdaten.

3. Dynamische Kategorien werden nicht angezeigt

Wenn dynamische Produktgruppen im Filter nicht angezeigt werden:

  1. Stellen Sie sicher, dass die Einstellung hideDynamicCategory deaktiviert ist.
  2. Überprüfen Sie, ob die Elasticsearch-Mapping die Eigenschaft streamCategories enthält.
  3. Stellen Sie sicher, dass Produkte korrekt dynamischen Kategorien zugewiesen sind.

4. URL-Parameter funktionieren nicht

Wenn Kategorienauswahlen in der URL nicht gespeichert werden:

  1. Überprüfen Sie die Methode _getCategoryIdsFromRequest in der Subscriber-Klasse.
  2. Stellen Sie sicher, dass der Filtername (tdxcats) korrekt in den Plugin-Einstellungen konfiguriert ist.
  3. Überprüfen Sie, ob JavaScript-Fehler die Filteraktualisierung der URL verhindern.

Best Practices

Kategorienverwaltung

  • Überprüfen und aktualisieren Sie regelmäßig Ihre Kategorienstruktur, um sicherzustellen, dass sie optimiert bleibt.
  • Verwenden Sie beschreibende Kategoriennamen, um den Kunden die Produktgruppen zu erläutern.
  • Berücksichtigen Sie die Tiefe Ihres Kategorienbaums und aktivieren Sie Einstellungen wie hideUnpopular für eine bessere Leistung.

Leistungsoptimierung

  • Aktivieren Sie das Caching für den Kategorienbaum, um die Verarbeitungszeit zu reduzieren.
  • Verwenden Sie die Einstellung popularCount, um die Anzahl der angezeigten Kategorien zu begrenzen.
  • Überlegen Sie, Kategorien-ID-Abfragen in Ihren Elasticsearch-Abfragen zu bündeln.

Konfigurationstipps

  • Für Geschäfte mit einer komplexen Kategorienstruktur aktivieren Sie joinParents, um die Anzeige zu vereinfachen.
  • Verwenden Sie die Einstellung showParentCategory, um zu steuern, wie viele Elternstufen in Kategorienamen angezeigt werden.
  • Überprüfen und aktualisieren Sie regelmäßig Ihre Konfigurationseinstellungen, um den Bedürfnissen Ihres Geschäfts gerecht zu werden.