Willkommen beim Benutzerhandbuch fĂŒr das Topdata TopFinder Pro Plugin fĂŒr Shopware 6.
Dieses Plugin bietet Ihren Kunden eine leistungsstarke und intuitive Möglichkeit, Produkte zu finden, die mit ihren spezifischen GerĂ€ten kompatibel sind. Es ist ideal fĂŒr Shops, die Zubehör, Ersatzteile oder Verbrauchsmaterialien wie Druckertinte und -toner verkaufen, bei denen die KompatibilitĂ€t entscheidend ist.
Mit einer hochgradig konfigurierbaren Finder-Leiste, dedizierten GerÀteseiten und erweiterten Suchfunktionen macht es TopFinder Pro den Kunden leicht, genau das zu finden, was sie benötigen. Dies verbessert die Benutzererfahrung und steigert den Umsatz.
1. Systemanforderungen
- Shopware 6.7.x oder höher
- PHP 8.2 oder höher
- Alle weiteren Systemanforderungen fĂŒr Ihre Shopware-Version
2. Plugin-AbhÀngigkeiten
Vor der Installation von Topdata TopFinder Pro mĂŒssen Sie die folgenden beiden Plugins installieren und aktivieren, da diese fĂŒr die korrekte Funktion von TopFinder erforderlich sind:
- Topdata Foundation (
TopdataFoundationSw6) - Topdata Connector (
TopdataConnectorSw6)
Stellen Sie sicher, dass diese Plugins installiert und aktiviert sind, bevor Sie fortfahren.
3. Installationsschritte
-
Plugin herunterladen: Besorgen Sie sich die ZIP-Datei des Plugins.
-
In Shopware hochladen: Melden Sie sich in Ihrem Shopware-Adminbereich an, navigieren Sie zu
Erweiterungen > Meine Erweiterungenund klicken Sie auf den Button Erweiterung hochladen. WĂ€hlen Sie die ZIP-Datei aus. -
Installieren & Aktivieren: Nach dem Hochladen erscheint das Plugin in Ihrer Liste der Erweiterungen.
- Klicken Sie auf den
...-Button neben âTopdata TopFinder Proâ und wĂ€hlen Sie Installieren. - Nachdem die Installation abgeschlossen ist, aktivieren Sie den Schalter in der Spalte âStatusâ, um das Plugin zu aktivieren.
- Klicken Sie auf den
-
Cache leeren: Nach der Aktivierung ist es entscheidend, den Cache Ihres Shops zu leeren, um sicherzustellen, dass alle Ănderungen korrekt angewendet werden. Sie können dies im Admin unter
Einstellungen > Caches & Indizestun, indem Sie auf Caches leeren klicken, oder indem Sie den folgenden Befehl im Hauptverzeichnis Ihrer Shopware-Installation ĂŒber die Kommandozeile ausfĂŒhren:bin/console cache:clear
Das Plugin ist nun installiert und bereit zur Konfiguration.
Alle Einstellungen fĂŒr das Topdata TopFinder Pro Plugin finden Sie in Ihrem Shopware Admin unter Erweiterungen > Meine Erweiterungen > ... > Konfigurieren. Die Konfiguration ist zur Ăbersichtlichkeit in mehrere Abschnitte unterteilt.
Auswahl Felder
Dieser Abschnitt steuert die Haupt-Finder-Leiste, die in Ihrem Storefront angezeigt wird.
- Angezeigte Dropdown-MenĂŒs auswĂ€hlen: Definiert die Struktur des Finders.
- Optionen:
Hersteller - Serie - GerÀte: Ein dreistufiger Auswahlprozess.Hersteller - Typen - GerÀte: Ein alternativer dreistufiger Prozess.Hersteller - Typen/Serie - GerÀte: (Standard) Ein dreistufiger Prozess mit einem Schalter zum Wechseln zwischen Serie und Typ.Hersteller - GerÀte: Ein vereinfachter zweistufiger Prozess.
- Optionen:
- Auswahlfelder anzeigen: Bestimmt, wo die Finder-Leiste erscheint.
- Optionen:
auf alle Seiten(Standard),nur auf Topfinder Seiten,nicht anzeigen.
- Optionen:
- Nach Auswahl die Seite âMarke / Serie / Typâ anzeigen: Wenn aktiviert, navigiert die Auswahl einer Option (z.B. einer Marke) den Benutzer zur Seite dieser Marke, anstatt nur das nĂ€chste Dropdown zu laden. Standard:
Deaktiviert. - Verlauf der gesuchten GerĂ€te anzeigen: Wenn aktiviert, wird ein Dropdown mit kĂŒrzlich angesehenen GerĂ€ten in der Finder-Leiste angezeigt. Standard:
Aktiviert. - Benutzer darf Dropdown-MenĂŒs ausblenden: Wenn aktiviert, können Benutzer die Finder-Leiste einklappen. Standard:
Aktiviert. - Dropdowns Spalten Klasse: Geben Sie die Bootstrap-Spaltenklassen ein, um das Layout der Dropdowns zu steuern (z.B.
col-sm-4 col-mdfĂŒr ein horizontales Layout,col-sm-12fĂŒr ein vertikales). Standard:col-sm-4 col-md. - Lade-Spinner Anzeigemodus: Wie die Ladeanzeige bei AJAX-Anfragen dargestellt wird.
- Optionen:
Keine,Overlay(Standard).
- Optionen:
- Position der Finder-Leiste: Steuert, wo die Finder-Leiste auf der Seite gerendert wird.
- Optionen:
Seitenanfang (ĂŒber dem Header)(Standard),Ăber der Hauptnavigation (unter der Suchleiste),Unter der Hauptnavigation.
- Optionen:
ABC Leiste
Dies steuert die A-Z-Navigationsleiste.
- ABC Leiste anzeigen: Schaltet die Sichtbarkeit der A-Z-Navigationsleiste um. Standard:
Aktiviert. - Zeige GerĂ€te satt Marken bei der Suche ĂŒber die ABC-Leiste: Wenn aktiviert, fĂŒhrt ein Klick auf einen Buchstaben zu einer Liste von GerĂ€ten. Wenn deaktiviert, wird eine Liste von Marken angezeigt. Standard:
Deaktiviert. - Leere Buchstaben deaktivieren: Wenn aktiviert, werden Buchstaben in der A-Z-Leiste, die keine zugehörigen Marken/GerÀte haben, ausgegraut und sind nicht klickbar. Standard:
Aktiviert.
Druckerverlauf und Slider
Dies steuert die FunktionalitÀt des GerÀteverlaufs.
- Anzahl der zuletzt gesuchten GerĂ€te festlegen: Wie viele kĂŒrzlich angesehene GerĂ€te gespeichert werden. Standard:
10. - Den Verlauf der zuletzt gesuchten GerĂ€te auf allen Seiten anzeigen: Wenn aktiviert, erscheint ein Slider mit kĂŒrzlich angesehenen GerĂ€ten im Storefront. Standard:
Aktiviert. - Slider mit den zuletzt gesuchten Druckern (Historie) ausgeblenden: Wenn aktiviert, können Benutzer den Slider des GerÀteverlaufs ausblenden. Standard:
Aktiviert.
GerÀte-Finder-Popup
Dies steuert den modal-basierten Finder.
- ZusÀtzliches Popup mit Druckerfinder anzeigen: Schaltet den Button im Header um, der das Popup öffnet. Standard:
Aktiviert. - Angezeigte Dropdown-MenĂŒs im Druckerfinder auswĂ€hlenâŠ: Legt die Dropdown-Struktur innerhalb des Popups fest (dieselben Optionen wie die Haupt-Finder-Leiste). Standard:
Hersteller - Typen/Serie - GerÀte. - Verlauf der gesuchten GerÀte anzeigen: Schaltet die Verlaufsfunktion innerhalb des Popups um. Standard:
Aktiviert. - Farbeinstellungen: Eine Reihe von FarbwÀhlern (
Background dark,Background light, etc.), um das visuelle Erscheinungsbild des Popup-Finders an Ihr Theme anzupassen.
Produktdetailseite
Dies steuert Funktionen auf der Produktdetailseite.
- Kompatible GerĂ€te anzeigen lassen: Schaltet den Tab âKompatible GerĂ€teâ um. Standard:
Aktiviert. - Gruppierung der kompatiblen GerĂ€teâŠ: Wie GerĂ€te innerhalb des Tabs gruppiert werden.
- Optionen:
Gruppe nach Serie(Standard),Gruppe nach Hersteller,Keine Gruppierung.
- Optionen:
- Legen Sie fest, wie die GerÀtenamen dargestellt werden sollen: Wie GerÀtenamen in Listen formatiert werden.
- Optionen:
Drucker,Marke + Drucker(Standard),Marke + Neue Zeile + Drucker.
- Optionen:
- Anzeigen der Unternavigation (
fixProductBreadcrumbs): Passt den Breadcrumb-Pfad auf Produktseiten fĂŒr einen besseren Kontext an. Standard:Aktiviert.
Suche
Dies steuert die GerÀtesuch-Integration.
- Suche Eingabefeld:
- Optionen:
Kombiniert mit Produktsuche(Standard): Ergebnisse der GerĂ€tesuche werden neben den regulĂ€ren Produktsuch-Ergebnissen angezeigt.eignenes Suchfeld: Eine separate Suchleiste fĂŒr GerĂ€te wird angezeigt.deaktiviert: Die GerĂ€tesuche ist deaktiviert.
- Optionen:
- Wenn keine GerÀt gefunden, Resultat nicht anzeigen: Verbirgt den Abschnitt mit den GerÀteergebnissen in der kombinierten Suche, wenn keine GerÀte gefunden werden. Standard:
Aktiviert.
Device List
Dies steuert die Funktion fĂŒr eingeloggte Kunden.
- Persönliche GerĂ€teliste aktivieren: Aktiviert die Funktion âMeine GerĂ€telisteâ, die es eingeloggten Kunden ermöglicht, ihre GerĂ€te zu speichern. Standard:
Aktiviert.
GerÀteansicht im Kompaktmodus
Diese Einstellungen definieren den Schwellenwert, ab dem eine detaillierte Ansicht zu einer kompakteren Listenansicht wechselt, um Platz zu sparen.
- Anzahl der Suchergebnisse: Standard
10. - Anzahl der GerÀte auf Ihrer persönlichen GerÀteliste: Standard
10. - Anzahl der kompatiblen Drucker auf der Produktdetailseite: Standard
3.
Seite mit GerÀtedetails
Dies steuert die Produktlistings auf den automatisch generierten GerÀteseiten.
- Eigenschaft zum Gruppieren von Produkten nach Registerkarten: Ermöglicht die Auswahl einer Produkteigenschaftsgruppe (z.B. âZustandâ). Produkte auf der GerĂ€teseite werden basierend auf den Werten dieser Eigenschaft in Tabs aufgeteilt (z.B. ein Tab fĂŒr âOriginalâ und ein Tab fĂŒr âKompatibelâ).
- Standard-Produktsortierung: Legt die standardmĂ€Ăige Sortierreihenfolge fĂŒr Produkte auf GerĂ€teseiten fest. Standard:
Topseller. - Produkte pro Seite: Legt die Anzahl der pro Seite anzuzeigenden Produkte fest. Standard:
10. - Css-Klasse fĂŒr Produktbox in Produktliste: Geben Sie die Bootstrap-Spaltenklassen ein, um das Layout des Produktgitters auf den GerĂ€teseiten zu steuern. Standard:
col-sm-6 col-lg-4 col-xl-3.
Warenkorb Einstellungen
- Zuletzt verwendetes kompatibles GerĂ€t im Warenkorb anzeigen: Wenn aktiviert, wird dem Kunden beim HinzufĂŒgen eines Produkts zum Warenkorb angezeigt, mit welchem seiner kĂŒrzlich angesehenen GerĂ€te dieses Produkt kompatibel ist. Dies bietet dem Kunden eine zusĂ€tzliche BestĂ€tigung. Standard:
Deaktiviert.
Dieser Abschnitt bietet einen detaillierteren Ăberblick ĂŒber die Hauptfunktionen des TopFinder Pro Plugins.
Die Finder-Leiste
Die Finder-Leiste ist das primĂ€re Werkzeug fĂŒr Ihre Kunden. Sie besteht aus mehreren Komponenten:
- Dropdown-Auswahlfelder: Kunden treffen eine sequentielle Auswahl (z.B. Marke > Serie > GerÀt). Die Optionen in jedem Dropdown werden dynamisch per AJAX basierend auf der vorherigen Auswahl geladen. Die Struktur dieser Dropdowns wird durch die Einstellung
selectboxesModegesteuert. - A-Z-Navigation: Eine alphabetische Liste, die es Kunden ermöglicht, Marken oder GerÀte schnell nach ihrem Anfangsbuchstaben zu filtern. Das Verhalten wird durch die Einstellung
letterDisplayDevicesgesteuert. - GerÀteverlauf-Dropdown: Wenn aktiviert (
showDeviceHistorySelect), zeigt dieses Dropdown eine Liste der zuletzt vom Kunden angesehenen GerÀte zur schnellen Auswahl an.
Der Popup-Finder
Als Alternative zur statischen Finder-Leiste kann ein âGerĂ€tefinderâ-Button im Header angezeigt werden. Ein Klick darauf öffnet ein groĂes, benutzerfreundliches modales Fenster mit einer erweiterten OberflĂ€che. Es beinhaltet:
- Die gleiche Dropdown-FunktionalitÀt wie die Haupt-Finder-Leiste.
- A-Z-Navigation innerhalb des Popups.
- Zugriff auf die âMeine GerĂ€telisteâ und den GerĂ€teverlauf des Benutzers.
- Eine dedizierte Suchfunktion innerhalb des Popups.
- Ein anpassbares Farbschema, das zum Branding Ihres Shops passt.
GerÀteseiten & Produktlistings
Das Plugin generiert automatisch SEO-freundliche Seiten fĂŒr jede Marke, Serie, jeden Typ und jedes GerĂ€t. Wenn ein Kunde auf eine GerĂ€teseite navigiert, wird ihm eine vollstĂ€ndige Liste aller mit diesem GerĂ€t kompatiblen Produkte angezeigt.
Das Produktlisting auf diesen Seiten ist in hohem MaĂe anpassbar:
- Paginierung: Die Anzahl der Produkte pro Seite kann ĂŒber
productsPerPagefestgelegt werden. - Sortierung: Sie können die standardmĂ€Ăige Sortierreihenfolge mit
defaultSortKeydefinieren. - Tab-Gruppierung: Mit der Einstellung
groupingTabProperykönnen Sie Produkte basierend auf einer Produkteigenschaft wie âZustandâ in Tabs aufteilen. Dies erleichtert es den Kunden, zwischen originalen und kompatiblen Produkten zu wechseln.
âMeine GerĂ€telisteâ fĂŒr Kunden
Wenn aktiviert (showDevicelist), erhalten eingeloggte Kunden Zugriff auf den Bereich âMeine GerĂ€telisteâ in ihrem Konto. Hier können sie ihre GerĂ€te fĂŒr zukĂŒnftige Besuche speichern. Dies ermöglicht es ihnen, schnell kompatible Produkte zu finden, ohne jedes Mal den Finder verwenden zu mĂŒssen. Sie können ihren gespeicherten GerĂ€ten auch personalisierte Informationen wie einen Standort oder eine Seriennummer hinzufĂŒgen.
Suchintegration
Die GerÀtesuche kann auf zwei Arten integriert werden, gesteuert durch die search-Einstellung:
- Kombiniert: Wenn ein Kunde die Haupt-Suchleiste des Shops verwendet, enthalten die Ergebnisse sowohl regulÀre Produkte als auch passende GerÀte in einem separaten, deutlich gekennzeichneten Bereich.
- Separat: Eine dedizierte Suchleiste zum Finden von GerĂ€ten wird im Storefront hinzugefĂŒgt.
Tab âKompatible GerĂ€teâ auf Produktdetailseiten
Um Cross-Selling zu fördern und nĂŒtzliche Informationen bereitzustellen, kann das Plugin einen Tab âKompatible GerĂ€teâ zu Ihren Produktdetailseiten hinzufĂŒgen. Dieser Tab listet alle GerĂ€te auf, mit denen das angesehene Produkt kompatibel ist. Die Gruppierung der GerĂ€te in dieser Liste wird durch die Einstellung deviceTabMode gesteuert.
CMS-Block
Das Plugin registriert einen âTopFinder Selectboxesâ-Block in den Shopware Erlebniswelten (CMS). Dies ermöglicht es Ihnen, die Finder-Leiste auf jeder beliebigen CMS-Seite zu platzieren, wie z.B. auf einer benutzerdefinierten Landingpage oder der Startseite des Shops, was Ihnen die volle Kontrolle ĂŒber die Platzierung gibt.
Warenkorb-Integration
Wenn die Einstellung showDeviceInCart aktiviert ist, verbessert das Plugin das Warenkorb-Erlebnis. Wenn ein Kunde eine GerĂ€teseite ansieht und dann ein kompatibles Produkt in den Warenkorb legt, erscheint neben dem Produkt im Warenkorb ein kleines Symbol mit einem Tooltip, das bestĂ€tigt, fĂŒr welches seiner kĂŒrzlich angesehenen GerĂ€te es ist. Dies gibt Sicherheit und kann helfen, FehlkĂ€ufe zu reduzieren.
faq
F: Warum sind einige Buchstaben in der A-Z-Navigationsleiste ausgegraut und nicht klickbar?
A: Dies wird durch die Einstellung âLeere Buchstaben deaktivierenâ im Abschnitt âABC Leisteâ der Plugin-Konfiguration gesteuert. Wenn diese Option aktiviert ist, wird jeder Buchstabe, dem nicht mindestens eine aktive Marke oder ein aktives GerĂ€t zugeordnet ist, deaktiviert. Dadurch wird verhindert, dass Benutzer auf eine leere Seite klicken.
F: Die Haupt-Finder-Leiste wird in meinem Shop nicht angezeigt. Wie kann ich das beheben?
A: Es gibt einige Einstellungen, die Sie ĂŒberprĂŒfen sollten:
- Navigieren Sie zum Abschnitt âAuswahl Felderâ in der Plugin-Konfiguration.
- Stellen Sie sicher, dass die Option âAuswahlfelder anzeigenâ auf
auf alle Seitenodernur auf Topfinder Seiteneingestellt ist. Wenn sie aufnicht anzeigensteht, wird der Finder ausgeblendet. - ĂberprĂŒfen Sie die Einstellung âPosition der Finder-Leisteâ. Es ist möglich, dass sie an einer Stelle gerendert wird, die Ihr Theme nicht unterstĂŒtzt oder die durch benutzerdefiniertes CSS verborgen ist.
- Wenn Sie ein benutzerdefiniertes Theme verwenden, stellen Sie sicher, dass die Theme-Blöcke, in denen der Finder gerendert wird, nicht entfernt wurden.
F: Eine GerĂ€teseite zeigt âKeine Produkte gefundenâ, obwohl ich weiĂ, dass es kompatible Produkte gibt. Warum?
A: Die ProduktkompatibilitĂ€t wird durch das Topdata Connector Plugin verwaltet. Bitte stellen Sie sicher, dass die Produkt-zu-GerĂ€t-Beziehungen im Connector korrekt konfiguriert sind. Leeren Sie nach Ănderungen immer den Shopware-Cache.
F: Wie kann ich die Farben des Popup-Finders Àndern?
A: In der Plugin-Konfiguration gibt es einen Abschnitt namens âGerĂ€te-Finder-Popupâ. Dieser Abschnitt enthĂ€lt eine Reihe von FarbwĂ€hlerfeldern (z.B. Background dark, Text, Button text mouse over). Sie können diese Felder verwenden, um jeden Aspekt des Erscheinungsbildes des Popups an das Theme Ihres Shops anzupassen.
F: Wo kann ich die SEO-Texte wie den Seitentitel fĂŒr die GerĂ€teseiten Ă€ndern?
A: Die SEO-Vorlagen fĂŒr alle von diesem Plugin generierten Seiten (Marken-, Serien-, Typen-, GerĂ€teseiten) werden als Textbausteine in Shopware verwaltet. Navigieren Sie im Admin zu Einstellungen > Shop > Textbausteine und suchen Sie nach dem SchlĂŒssel topdata-topfinder.SEO. Dort finden Sie alle relevanten Bausteine (z.B. topdata-topfinder.SEO.devicePageTitle), die Sie dann fĂŒr jeden Ihrer VerkaufskanĂ€le bearbeiten können.