Funktionen im Detail und häufige Fragen

Wie die Auswahl funktioniert

Der Kunde öffnet Schritt für Schritt die Dropdowns. Jedes Dropdown zeigt nur die Unterkategorien der zuvor gewählten Kategorie; nachfolgende, noch nicht erreichbare Schritte sind gesperrt, bis der vorherige Schritt eine Kategorie mit Unterkategorien liefert. Kategorien ohne weitere Unterkategorien beenden die Auswahl automatisch an dieser Stelle, auch wenn noch nicht alle konfigurierten Schritte durchlaufen wurden.

Je nach Einstellung „Anzeige der Produkte“ geschieht der Sprung zur Produktliste entweder erst nach Klick auf den Button „Produkte anzeigen“ (dieser ist deaktiviert, solange keine Kategorie gewählt ist) oder automatisch, sobald der letzte mögliche Schritt gewählt wurde.

Sobald mindestens eine Kategorie gewählt ist, erscheint zusätzlich der Button „Auswahl löschen“, mit dem der Kunde alle Schritte zurücksetzen kann.

Auswahl bleibt beim Zurückkehren erhalten

Die getroffene Auswahl wird im Browser gespeichert (Sitzungsspeicher der aktuellen Browser-Sitzung) und beim erneuten Aufruf der Seite automatisch wiederhergestellt, solange der Kunde denselben Browser-Tab bzw. dieselbe Sitzung verwendet. Schließt der Kunde den Tab oder Browser, geht die Auswahl verloren. Über „Auswahl löschen“ kann die gespeicherte Auswahl auch aktiv entfernt werden.

Live-Suche

Ist „Live-Suche in Dropdowns“ aktiv, kann der Kunde im geöffneten Dropdown tippen; die Liste filtert sich sofort auf Einträge, deren Name den eingegebenen Text enthält (Groß-/Kleinschreibung wird ignoriert). Liefert die Suche keine Treffer, erscheint der Hinweis „Keine Treffer“ (Text änderbar, siehe unten).

Ladeverhalten und Zwischenspeicherung

Bei „Erste Ebene vorladen“ wird die oberste Auswahlebene direkt mit der Seite ausgeliefert. Bei „Alles beim Klick laden“ wird auch die erste Ebene erst beim Öffnen des ersten Dropdowns nachgeladen. In beiden Fällen werden tiefere Ebenen erst beim Aufklappen des jeweiligen Dropdowns per Nachladen abgerufen. Kann eine Ebene nicht geladen werden (z. B. bei einer Netzwerkstörung), erscheint im Dropdown eine Fehlermeldung.

Geladene Kategorie-Daten werden serverseitig zwischengespeichert, damit wiederholte Aufrufe schnell bleiben. Ändern Sie eine Kategorie im JTL-Backend (anlegen, bearbeiten, löschen), wird dieser Zwischenspeicher automatisch geleert – eine manuelle Cache-Leerung ist dafür nicht nötig.

Sichtbarkeit und Kundengruppen

Mit „Nur sichtbare Kategorien“ (Standard: Ja) werden Kategorien, die für die aktuell aktive Kundengruppe im JTL-Backend ausgeblendet sind, im Assistenten nicht angezeigt – weder als eigener Schritt noch als Unterkategorie eines sichtbaren Zweigs. Jeder Kunde sieht dadurch nur das für seine Kundengruppe freigegebene Sortiment. Ist die Einstellung auf „Nein“ gesetzt, werden auch für die Kundengruppe ausgeblendete Kategorien angezeigt.

Zielseite je Kategorie

Am Ende jedes Auswahlpfads führt der Assistent zur regulären Kategorieseite des Shops (mit der dort hinterlegten SEO-URL, sofern vorhanden).

Platzierung im Theme

Die Einstellungen „Ziel-Selektor (CSS)“ und „Einfüge-Methode“ bestimmen gemeinsam, wo genau der Assistent im Theme erscheint: Der Ziel-Selektor bestimmt das Bezugselement, die Einfüge-Methode, wie der Assistent relativ dazu eingefügt wird (siehe Einstellungstabelle im Artikel „Überblick, Installation und Einrichtung“). Erscheint der Assistent nicht, prüfen Sie zuerst, ob der angegebene Selektor im ausgelieferten HTML Ihres Themes tatsächlich vorkommt.

Texte anpassen, auch mehrsprachig

Alle sichtbaren Texte können Sie in der JTL-Sprachverwaltung anpassen, jeweils eigene Werte je Sprache:

• Überschrift (heading_text) und Untertext (subtitle_text) oberhalb der Auswahl – leeren Sie den Text, wenn Sie keine Überschrift bzw. keinen Untertext möchten.
• Standard-Platzhalter „Bitte auswählen“ (please_select), der verwendet wird, wenn für einen Schritt kein eigener Platzhalter gesetzt ist.
• Eigener Platzhalter je Schritt: step_1_placeholder bis step_10_placeholder, z. B. „Fahrzeugtyp“, „Marke“, „Modell“.
• Such-Platzhalter (search_placeholder) und Meldung „Keine Treffer“ (no_results).
• Button-Texte „Produkte anzeigen“ (show_products) und „Auswahl löschen“ (clear_selection).
• Fehlermeldung, wenn eine Ebene nicht geladen werden kann (load_error).

Alle diese Texte sind werkseitig in 13 Sprachen hinterlegt (Deutsch, Englisch, Französisch, Spanisch, Italienisch, Polnisch, Niederländisch, Portugiesisch, Dänisch, Schwedisch, Tschechisch, Türkisch, Russisch) und können pro Sprache überschrieben werden.

Aussehen anpassen

Der Assistent bringt ein neutrales Grund-Styling mit. Sämtliche CSS-Klassen des Assistenten beginnen mit spx-csel-, sodass Ihr Webdesigner sie gezielt mit eigenem CSS überschreiben kann. Farben, Abstände, Eckenradius und Schatten sind zusätzlich über CSS-Variablen auf dem äußeren Element steuerbar (z. B. Rahmenfarbe, Hintergrund, Textfarbe, Akzentfarbe, Eckenradius, Abstand zwischen den Schritten).

Häufige Fragen

Der Assistent erscheint nicht im Shop – woran kann das liegen? Prüfen Sie zuerst den „Ziel-Selektor (CSS)“: Das angegebene Element muss in Ihrem Theme tatsächlich vorkommen. Prüfen Sie außerdem, ob die übrigen Einstellungen gültige Werte haben (z. B. Anzahl Schritte zwischen 1 und 10) und ob eine gültige Lizenz vorliegt (Tab „Update“).

Ich möchte den Assistenten nur auf der Startseite zeigen. Setzen Sie den Ziel-Selektor auf ein Element, das nur auf der Startseite vorkommt, z. B. einen eigenen CMS-Block, den Sie ausschließlich dort einbinden.

Kunden landen automatisch in einer Kategorie, obwohl ich einen Bestätigungs-Klick möchte. Stellen Sie „Anzeige der Produkte“ auf „Button ‚Produkte anzeigen‘“.

Im Bestellvorgang sehe ich den Assistenten – ist das gewollt? Nein. Im Warenkorb-/Bestellvorgang, auf der Bestellabschluss- und Bestellstatus-Seite, in der Druckansicht und im Wartungsmodus wird der Assistent automatisch ausgeblendet.

Warum sieht ein Kunde weniger Kategorien als ich im Backend eingerichtet habe? Mit „Nur sichtbare Kategorien“ auf „Ja“ blendet der Assistent Kategorien aus, die für die Kundengruppe des jeweiligen Besuchers im Backend als nicht sichtbar hinterlegt sind.

Warum sieht der Kunde beim erneuten Besuch seine alte Auswahl noch? Die Auswahl wird im Browser des Kunden für die laufende Sitzung gespeichert. Über „Auswahl löschen“ kann der Kunde sie selbst entfernen; sie verschwindet außerdem automatisch, wenn der Kunde den Browser-Tab schließt.

Support

Bei Fragen erreichen Sie uns über das Kontaktformular auf salepix.de. Bitte nennen Sie die Plugin-Version und Ihre JTL-Shop-Version.