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:
- Folgen Sie dem Installationshandbuch, um das Plugin zu installieren und zu aktivieren
- Passen Sie die Plugin-Einstellungen nach den Bedürfnissen Ihres Shops an, indem Sie den Einstellungsleitfaden verwenden
- 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
- Melden Sie sich bei Ihrem Shopware-Admin-Panel an
- Gehen Sie zu Erweiterungen > Meine Erweiterungen
- Finden Sie “Topdata Category Filter SW6” in der Liste
- 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:
- Gehen Sie zur Produktlisten-Seite in Ihrem Storefront
- Sie sollten den Kategoriefilter im Filterpanel sehen
- 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
| Einstellung | Standard | Beschreibung |
|---|---|---|
showCategoryFilter | true | Aktiviert oder deaktiviert den Kategoriefilter im Storefront. |
showNumber | true | Zeigt die Anzahl der Produkte in jeder Kategorie an. |
collapseSubcategories | true | Blendet Unterkategorien im Filter zunächst ein. Benutzer können sie erweitern. |
showFirst | true | Zeigt den Kategoriefilter als ersten Filter im Panel an. |
hideOtherBranches | true | Blendet Kategorien aus anderen Kategoriezweigen auf Kategorieseiten aus. |
excludeHidden | false | Blendet Kategorien aus, die als “In Navigation ausblenden” markiert sind. |
hideSingleCategory | true | Blendet den Filter aus, wenn nur eine Kategorie verfügbar ist. |
hideDynamicCategory | true | Blendet Kategorien mit dynamischen Produktgruppen aus. |
popularCount | 0 | Zeigt nur Kategorien mit einer Mindestanzahl von Produkten an. Setzen Sie auf 0, um alle anzuzeigen. |
hideParents | false | Blendet übergeordnete Kategorien im Filter aus. |
initialFilterState | collapsed | Legt fest, ob Filter-Akkordeons beim Laden der Seite zunächst ein- oder ausgeklappt sein sollen. |
sort | none | Legt die Sortierreihenfolge der Kategorien fest (Name, Anzahl oder Standard). |
Ansichtsoptionen
Kategoriefilter-Ansichtsoptionen
| Einstellung | Standard | Beschreibung |
|---|---|---|
manyMainCategories | true | Behandelt Fälle, in denen es nur eine Hauptkategorie gibt, indem sie in Unterkategorien aufgeteilt wird. |
joinParents | false | Kombiniert übergeordnete Kategorien in der Anzeige. Kategorienamen werden durch ”/” getrennt. |
showParentCategory | 0 | Gibt an, wie viele Ebenen übergeordneter Kategorien angezeigt werden sollen (0 bis 20 oder “Alle”). |
Leistungseinstellungen
Optimierungsoptionen
| Einstellung | Standard | Beschreibung |
|---|---|---|
hideUnpopular | false | Entfernt Kategorien mit geringer Produktanzahl, um die Leistung zu verbessern. |
joinParents | true | Vereinigt Elternkategorien mit nur einem Kind, um den Kategoriebbaum zu vereinfachen. |
showParentCategory | 2 | Begrenzt die Anzahl der angezeigten Elternstufen in Kategorienamen für eine bessere Lesbarkeit. |
Empfohlene Konfigurationen
- Für Geschäfte mit einer tiefen Kategorienstruktur sollten Sie
hideUnpopularaktivieren, um die Leistung zu verbessern. - Wenn Sie nur eine Hauptkategorie haben, aktivieren Sie
manyMainCategoriesfür eine bessere Visualisierung. - Für Geschäfte mit dynamischen Produktgruppen möchten Sie möglicherweise
hideDynamicCategorydeaktivieren.
Visuelle Beispiele
Standardansicht

Eingeklappte Unterkategorien

Kombinierte Elternkategorien

Topdata Category Filter SW6 FAQ & Fehlerbehebung
Häufige Probleme
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Fehlende Kategorien | Ausgeblendete Kategorien | Überprüfen Sie die Einstellung excludeHidden in der Plugin-Konfiguration. |
| Langsame Filterladezeit | Komplexe Baumverarbeitung | Aktivieren Sie die Option hideUnpopular, um Kategorien mit geringer Produktanzahl zu entfernen. |
| Dynamische Kategorien fehlen | Mapping-Problem | Stellen Sie sicher, dass die Eigenschaft streamCategories korrekt in Ihrem Elasticsearch-Index konfiguriert ist. |
| URL-Parameter funktionieren nicht | Verarbeitung 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:
- Überprüfen Sie, ob die Einstellung
excludeHiddenaktiviert ist, die Kategorien ausblendet, die als “In Navigation ausblenden” markiert sind. - Stellen Sie sicher, dass den Kategorien Produkte zugewiesen sind.
- Überprüfen Sie, ob der Elasticsearch-Index mit den neuesten Kategoriedaten aktualisiert ist.
2. Langsame Filterleistung
Wenn der Kategoriefilter langsam lädt:
- Aktivieren Sie die Einstellung
hideUnpopular, um Kategorien mit geringer Produktanzahl zu entfernen. - Erhöhen Sie ggf. den
popularCount-Schwellenwert, um nur die beliebtesten Kategorien anzuzeigen. - Aktivieren Sie das Caching für die Kategorienbaumdaten.
3. Dynamische Kategorien werden nicht angezeigt
Wenn dynamische Produktgruppen im Filter nicht angezeigt werden:
- Stellen Sie sicher, dass die Einstellung
hideDynamicCategorydeaktiviert ist. - Überprüfen Sie, ob die Elasticsearch-Mapping die Eigenschaft
streamCategoriesenthält. - Stellen Sie sicher, dass Produkte korrekt dynamischen Kategorien zugewiesen sind.
4. URL-Parameter funktionieren nicht
Wenn Kategorienauswahlen in der URL nicht gespeichert werden:
- Überprüfen Sie die Methode
_getCategoryIdsFromRequestin der Subscriber-Klasse. - Stellen Sie sicher, dass der Filtername (
tdxcats) korrekt in den Plugin-Einstellungen konfiguriert ist. - Ü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
hideUnpopularfü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.