Sidebar Suche

Der Sidebar-Block Suche zeigt im Frontend ein kompaktes Suchformular und kann während der Eingabe passende Suchvorschläge anzeigen. Die Konfiguration steuert, ob Vorschläge erscheinen, ab wie vielen Zeichen gesucht wird und welche Trefferarten in der Vorschlagsliste angeboten werden.

Wofür der Block da ist

Der Block bindet die Schnellsuche als Sidebar-Element ein. Besucher geben einen Suchbegriff ein und senden das Formular ab. Bei aktiver Vorschlagssuche fragt das Frontend während der Eingabe passende Treffer ab und zeigt sie direkt unter dem Eingabefeld an.

• Normale Suche: Das Formular sendet den Suchbegriff an die Suchseite. Dort werden die eigentlichen Suchergebnisse angezeigt.
• Vorschlagssuche: Das Eingabefeld ruft während der Eingabe Vorschläge ab, sobald die konfigurierte Mindestzeichenanzahl erreicht ist.
• Direktnavigation: Kategorie- und Herstellervorschläge können direkt auf die passende Zielseite führen. Artikelvorschläge übernehmen den Begriff und starten die Suche.

Position und Sichtbarkeit

Der Block heißt im Backend search. In den Standardwerten ist er für die Startseite links vorgesehen und für andere Bereichstypen zunächst nicht automatisch aktiv. Die tatsächliche Anzeige hängt wie bei anderen Sidebar-Blöcken von Position, Sortierung, aktiver Seite und Theme-Bereich ab.

• Position Startseite: standardmäßig links.
• Position allgemein, Checkout, Artikeldetail und Artikellisten: standardmäßig nicht gesetzt.
• Sortierung: die jeweiligen Sortierfelder legen die Reihenfolge innerhalb derselben Sidebar-Position fest.

Frontend-Formular

Im Frontend rendert der Block ein Formular mit dem Namen search_form. Das sichtbare Eingabefeld heißt q; der Wert wird beim Absenden an die Suchseite übergeben.

• q: enthält den eingegebenen Suchbegriff. Wenn bereits ein Suchbegriff aus der Anfrage vorhanden ist, wird er wieder in das Feld eingetragen.
• Suchbutton: sendet das Formular ab und startet die Suche mit dem aktuellen Wert aus q.
• Autocomplete-Daten am Eingabefeld: moderne Themes markieren das Feld für die Vorschlagssuche und übergeben die Adresse für die Vorschlagsabfrage sowie die Mindestzeichenanzahl.

Die Suche erwartet einen echten Suchbegriff. Leere Eingaben liefern keine Vorschläge und werden erst durch das normale Suchformular weiterbehandelt.

Konfigurationsfelder für Suchvorschläge

Die folgenden Felder gehören zur Blockkonfiguration und beeinflussen die Vorschlagsliste im Frontend:

• config_autocomplete_enable: aktiviert oder deaktiviert Suchvorschläge. Bei deaktivierter Option bleibt das Suchformular ohne Live-Vorschläge nutzbar.
• config_autocomplete_minChars: legt fest, ab wie vielen Zeichen Vorschläge abgefragt werden. Das Backend bietet Werte von 1 bis 5 an.
• config_autocomplete_autoSelectFirstChoice: steuert in alten Theme-Varianten, ob der erste Vorschlag automatisch angewählt wird. Moderne Themes verwalten die Auswahl über Tastatur und Klick im Vorschlagsmenü.
• config_autocomplete_artikel: blendet Artikelvorschläge ein oder aus.
• config_autocomplete_artikel_limit: begrenzt die Anzahl der Artikelvorschläge.
• config_autocomplete_kategorie: blendet Kategorievorschläge ein oder aus.
• config_autocomplete_kategorie_limit: begrenzt die Anzahl der Kategorievorschläge.
• config_autocomplete_hersteller: blendet Herstellervorschläge ein oder aus. Wenn bereits ein Herstellerkontext aktiv ist, werden Herstellervorschläge nicht zusätzlich erzeugt.
• config_autocomplete_hersteller_limit: begrenzt die Anzahl der Herstellervorschläge.
• config_autocomplete_showheader und config_autocomplete_showfooter: betreffen die Kopf- und Fußzeile der alten Vorschlagsausgabe und sind im Backend als veraltet markiert.

Welche Vorschläge erscheinen

Die Vorschlagsabfrage wertet den aktuellen Suchbegriff aus und gruppiert passende Treffer nach Typ. Berücksichtigt werden nur Datensätze, die im aktuellen Shopkontext sichtbar sind.

• Artikel: aktive, nicht gelöschte und nicht von der Suche ausgeschlossene Artikel in der aktuellen Kundengruppe und Sprache.
• Kategorien: aktive Kategorien in der aktuellen Sprache. In Kategorie- oder Herstellerkontexten wird der Trefferbereich entsprechend eingeschränkt.
• Hersteller: Hersteller mit aktiven Artikeln. Diese Vorschläge werden ausgelassen, wenn bereits ein Herstellerfilter aktiv ist.

Die Vorschlagsliste enthält neben dem sichtbaren Text auch Typinformationen. Moderne Themes nutzen diese Daten, um bei Kategorien und Herstellern direkt zur Zielseite zu wechseln.

Verhalten bei Auswahl eines Vorschlags

Vorschläge können per Maus oder Tastatur ausgewählt werden. Die Wirkung hängt vom Vorschlagstyp ab:

• Artikelvorschlag: Der Vorschlagstext wird in q übernommen und das Suchformular wird abgesendet.
• Kategorievorschlag: Das Frontend wechselt direkt zur Kategorie, sofern eine Zieladresse vorhanden ist.
• Herstellervorschlag: Das Frontend wechselt direkt zur Herstellerseite, sofern eine Zieladresse vorhanden ist.
• Ohne verwertbaren Typ: Der Text wird übernommen und die normale Suche wird gestartet.

Abgrenzung zu Tabellen und Optionen

Diese Seite beschreibt einen Sidebar-Block mit Konfigurationsformular und Frontend-Suchfeld. Es gibt keine Backend-Datentabelle, keine Optionsspalte und keine zeilenbezogenen Aktionen wie Bearbeiten, Kopieren oder Löschen.

Sichere Prüfung im Frontend

1. Block aktivieren und auf einer sichtbaren Sidebar-Position platzieren.
2. Eine Seite aufrufen, auf der diese Sidebar-Position ausgegeben wird.
3. Im Suchfeld weniger Zeichen als in config_autocomplete_minChars eingeben und prüfen, dass noch keine Vorschläge erscheinen.
4. Genügend Zeichen eingeben und prüfen, ob die aktivierten Vorschlagsarten erscheinen.
5. Einen Artikelvorschlag auswählen und prüfen, ob die Suche mit dem übernommenen Begriff startet.
6. Einen Kategorie- oder Herstellervorschlag auswählen und prüfen, ob die passende Zielseite geöffnet wird.