Search

Omnisearch

Ein einziges Fenster im Vollbildmodus, das Ihren Besuchern die Ergebnisse präsentiert, die am wahrscheinlichsten konvertieren.
Omnisearch example

Omnisearch ist ein vollständiges Sucherlebnis in einem Overlay. Es kombiniert Ergebnisse während der Eingabe der Besucher mit voller Ergebnisansicht und Facetten und ersetzt damit die separaten Instant Search und Search Page Komponenten.

Entscheide dich entweder für Omnisearch alleine oder für Instant Search und Search Page gemeinsam. Wenn Omnisearch bereits installiert ist, musst du keine der beiden Komponenten hinzufügen. Passe das vorhandene Omnisearch-Design und die Einstellungen an, um das Erlebnis zu verbessern.

Omnisearch umfasst:

  • Live-Ergebnisse werden deinen Besuchern während der Eingabe angezeigt und umfassen Produkte, Kategorien und Seiten.
  • Sortierung und Filterung: Ermöglicht es deinen Besuchern, ihre Suche auf eine intuitive und einfache Weise zu verfeinern.
  • Einfache Integration in deine Website mit einer unserer großartigen Vorlage.
  • Es passt sich deinem Branding an, indem nur wenige Standardeinstellungen wie Logo, Schriftarten, Farben und mehr verändert werden.
  • Es ist vollständig anpassbar mit HTML, CSS und Liquid für Entwickler.

Einstieg #

Omnisearch besteht aus einem anpassbaren Design für das visuelle Erscheinungsbild und einem Element-Block, der die Installation auf deiner Website ermöglicht.

Ein Design erstellen #

Dies geschieht in Search > Designs > New Design

Wähle den Typ Omnisearch, wähle ein Startdesign und gib ihm einen Namen.

Klicke auf Save, um das Standarddesign zu speichern. Kehre als eigenen Navigationsschritt zur Designliste oder zum Hauptdesign zurück.

Unsere Standarddesigns funktionieren direkt nach der Installation und können jederzeit bearbeitet werden. Zum Bearbeiten sind Kenntnisse in HTML, CSS und Liquid erforderlich. Schaue im Abschnitt Styling in diesem Leitfaden für weitere Informationen.

Ein Element erstellen #

Dies geschieht in Search > Element > New Element

Element-Blöcke sind Container für Elemente, die du in deinem my.clerk.io-Account erstellst. Sie enthalten die Logik zur Anzeige von Ergebnissen und Einstellungen dafür, wie viele Ergebnisse angezeigt werden sollen. Die Logik für den leeren Zustand kann auch über Regeln gesteuert werden.

  • Name hilft dir, dein Element zu identifizieren, falls du mehr als eines erstellen möchtest. Es kann später geändert werden.

  • Element-Typ ist standardmäßig Omnisearch und sollte nicht geändert werden. Hier kannst du auch Filter hinzufügen, falls erforderlich, allerdings brauchen die meisten Setups dies nicht.

  • Empty State Logic erlaubt dir, den Produkttyp auszuwählen, der angezeigt werden soll, wenn Omnisearch initial geöffnet wird, bevor Begriffe eingegeben werden. Standardmäßig ist dies Bestsellers, kann aber z.B. auch personalisiert werden mit Visitor Recommendations.

Design abschließen #

Das Design, das verwendet wird, um den Element-Block darzustellen. Wähle das Design, das du erstellt hast.

Wenn dein Design Variablen enthält, können diese hier ebenfalls gesetzt werden.

Du kannst die Anzahl der Ergebnisse pro Typ steuern, die bei jeder Suche angezeigt werden sollen. Wir empfehlen in der Regel folgende Mengen:

  • Produkte: 20-60
  • Vorschläge: 5
  • Kategorien & Seiten: 10

Zuletzt wähle die Attribute, die du als Facetten einbeziehen möchtest, und setze die Namen, unter denen sie in den Suchergebnissen angezeigt werden sollen. Falls du ein bestimmtes Attribut nicht in der Liste findest, füge es zur Liste „filterbare Attribute“ in der Search Configuration hinzu.

In die Website einfügen #

Die empfohlene Methode hierfür ist die Injection, du kannst das Element aber auch mit einem Einbettungscode auf deiner Website einfügen.

Sichtbarkeit wird verwendet, um zu steuern, wer die Omnisearch sehen kann.

  • In der Vorschau erlaubt dir, dein Element zu testen, ohne deine Live-Seite zu beeinflussen. Du kannst deine Seite in der Vorschau öffnen, indem du auf „Seite im Vorschau-Modus öffnen“ klickst oder ?clerk_content_mode=preview an die URL deiner Seite anhängst.

  • Auf meiner Live-Seite wird verwendet, wenn du mit dem Testen fertig bist und bereit bist, es öffentlich zu machen.

Verwendung der Injection #

Dies ist der einfachste Installationsweg. Clerk fügt den Omnisearch-Code automatisch zu deiner Website hinzu, indem ein Suchfeld deiner Wahl angesprochen und per Event ausgelöst wird.

  • Event steuert, was der Benutzer tun soll, um Omnisearch zu starten. In der Regel möchtest du, dass es angezeigt wird, wenn deine Besucher auf das Such-Icon oder das Eingabefeld klicken.

  • Element bestimmt den Teil der Website, mit dem der Nutzer interagieren soll. Wenn du zum Beispiel möchtest, dass Omnisearch nur angezeigt wird, wenn Besuchende mit deiner Suchleiste (Klick oder Fokus) interagieren, brauchst du nur den eindeutigen CSS-Selektor dafür. Wenn du verschiedene Bezeichner auf Mobile und Desktop hast, füge beide hinzu.

Finde deinen eindeutigen CSS-Selektor folgendermaßen:

  1. Inspiziere den Code deiner Seite. In den meisten Browsern kannst du irgendwo rechtsklicken und Untersuchen oder ähnliches wählen.
  2. Finde das Element, das du ansprechen willst.
  3. Rechtsklicke darauf und finde die Option Kopieren > Kopiere Selektor.

Verwendung von eingebettetem Code #

Diese Methode erlaubt dir, Omnisearch mit einem Snippet hinzuzufügen. Dafür musst du die HTML-Dateien deines Webshops bearbeiten oder Code per Editor einfügen können.

Wenn du nicht gespeicherte Änderungen hast, speichere sie, um den Einbettungscode zu generieren.

Kopiere diesen Code und füge ihn in die Datei ein, die alle Seiten des Shops generiert – idealerweise kurz vor dem schließenden </body>-Tag.

Ersetze INSERT_CSS_SELECTOR_FOR_ELEMENT_THAT_SHOULD_TRIGGER_OMNISEARCH durch den CSS-Selektor des HTML-Elements, das Omnisearch auslösen soll.

Nachfolgend ein vollständiges Beispiel eines Omnisearch-Einbettungscodes mit allen Konfigurationsmöglichkeiten:

<span class="clerk"
    data-template="@omnisearch"
    data-api="search/omni"
    data-trigger-element="INSERT_CSS_SELECTOR_FOR_ELEMENT_THAT_SHOULD_TRIGGER_OMNISEARCH"
    data-limit="40"
    data-suggestions="6"
    data-categories="6"
    data-pages="6"
    data-omni-search-suggestions="6"
    data-omni-search-categories="6"
    data-omni-search-pages="6"
    data-omni-search-empty="recommendations/popular">
</span>

Anzeige-Modi #

Omnisearch unterstützt zwei Anzeige-Modi, die bestimmen, wie die Suchoberfläche auf deiner Website erscheint. Dies kannst du im Tab Insert beim Bearbeiten deines Omnisearch-Elements konfigurieren.

Vollbild-Overlay #

Dies ist der Standardmodus. Nach Auslösung bedeckt Omnisearch die gesamte Ansicht mit einem Overlay im Vollbildmodus. Die Suchoberfläche übernimmt die Seite und bietet ein fokussiertes Sucherlebnis.

Verwende diesen Modus, wenn du möchtest:

  • Eine ablenkungsfreie Suchumgebung
  • Volle Kontrolle über das Layout der Suche
  • Dass die Suchoberfläche völlig unabhängig von deinem Webseiten-Header ist

Teilüberlagertes Overlay #

In diesem Modus wird Omnisearch mit dem vorhandenen Seitenkopf deiner Website integriert. Anstatt den kompletten Bildschirm zu verdecken, wird das Overlay unterhalb deines Headers angezeigt und dieser bleibt sichtbar und bedienbar.

Verwende diesen Modus, wenn du möchtest:

  • Deinen Header und die Navigation während der Suche weiterhin zugänglich halten
  • Eine nahtlosere Integration mit dem aktuellen Layout deiner Seite erhalten
  • Dass das Sucherlebnis sich wie ein natürlicher Teil deiner Website anfühlt
Konfigurationsoptionen #

Wenn Partial Overlay aktiviert ist, werden zusätzliche Einstellungen verfügbar:

Header-Selektor

Der CSS-Selektor für das Header-Element deiner Seite. Omnisearch nutzt diesen, um das Overlay direkt unterhalb deines Headers auszurichten.

Beispielselektoren:

  • header
  • .site-header
  • #main-header

Suchfeld-Selektor

Der CSS-Selektor für dein bestehendes Suchfeld. Wenn angegeben, synchronisiert Omnisearch sich mit dem Suchfeld im Header, sodass Eingaben in dieses Feld die Omnisearch-Ergebnisse live aktualisieren.

Beispielselektoren:

  • #search-input
  • .header-search input
  • [name="search"]

Breite

Steuert die horizontale Größe des Overlays:

  • Volle Breite: Über die gesamte Breite des Viewports
  • Inhaltsbreite: Entspricht der Breite eines von dir via CSS-Selektor definierten Containers
  • Feste Breite: Eine spezifische Pixelbreite, die du angibst

Höhe

Steuert die vertikale Größe des Overlays:

  • Vom Header bis zum unteren Rand: Füllt den Raum vom unteren Rand des Kopfbereichs bis zum unteren Rand des Viewports aus
  • Viewportrahmen-Prozent: Ein Prozentsatz der Viewport-Höhe (z.B. 80%)
  • Feste Höhe: Eine spezifische Pixelhöhe
  • Maximale Höhe: Legt ein Maximum fest, lässt kleineren Inhalt aber klein bleiben

Horizontale Ausrichtung

Steuert, wo das Overlay horizontal erscheint:

  • Links: Am linken Rand des Viewports
  • Zentriert: Über die gesamte Breite zentriert
  • Rechts: Am rechten Rand des Viewports

Vertikale Position

Steuert die vertikale Platzierung relativ zum Header:

  • Unterhalb des Headers: Overlay direkt unter dem Kopfbereich platzieren
  • Fester Abstand von oben: Ein bestimmter Pixelabstand von oberhalb des Viewports

Design-Konfiguration #

Die meisten Einstellungen der Omni-search lassen sich ändern, indem man die Variablen in den Design-Dateien anpasst.

In der liquid template language hat eine Variable folgende Struktur:

{% assign variable_name = "variable value" %}

Als Faustregel gilt: Nur der Wert der Variable sollte angepasst werden, um die Omni-search zu konfigurieren.

Technisch versierte Nutzer können natürlich weiterhin bestimmte HTML- und CSS-Zeilen anpassen, siehe diesen Abschnitt.

Um ein Logo dem Omnisearch-Design hinzuzufügen, setze os_brand_logo auf die Bild-URL deines Logos.

Infinite/Auto Load #

Wenn du steuern möchtest, ob die Omni-search automatisch beim Scrollen mehr Ergebnisse laden soll, sobald das Ende der Produktliste erreicht wurde, sollte die Variable auf true oder false gesetzt werden. Die Variable heißt typischerweise os_autoload. Setze sie auf false, damit Omnisearch nicht automatisch weitere Ergebnisse lädt.

Übersetzungen #

Standardmäßig ist das Template auf Englisch. Falls dein Shop in einer anderen Sprache ist, kannst du die Text-Elemente übersetzen, indem du die Variablen änderst.

Übersetze die Variablen für die Sortier-Buttons im Template zusammen mit den anderen Text-Variablen.

Tipp: Verwende generative KI (z.B. chatGPT), um Variablenwerte massenweise zu übersetzen, indem du schreibst „Translate these variable values from English to Danish. Return the full code back so it can be copy/pasted to replace the existing code: PASTE_VARIABLES_HERE“

Styling #

Um das Erscheinungsbild anzupassen, können Änderungen an den CSS-Variablen vorgenommen werden.

Die Templates verwenden CSS-Variablen, die folgendermaßen aufgebaut sind:

--variable_name: variable_value;

Für technisch versiertere Nutzer lassen sich einzelne CSS-Regeln für komplexere Design-Änderungen modifizieren.

Farben #

Konfigurierbare Farben befinden sich unter dem CSS-Kommentar „Colors“:
/* Colors */

Schriftarten #

Ähnlich wie bei Farben findet sich die Variable für Schriften unter dem Kommentar /* Font */.

Sie hat typischerweise folgende Struktur: --font-family: 'Kumbh Sans', sans serif;

Standarddesign #

Das Standarddesign von Omnisearch beinhaltet:

  • Varianten-Dropdown-Unterstützung: Shopper können Varianteneigenschaften (z.B. Größe, Farbe) vor dem Hinzufügen zum Warenkorb auswählen.

  • Mengenregler.

  • Native Add-to-Cart-Button, der Clerk.js benachrichtigt und Analytics & Merchandising synchronisiert hält.

  • Sauberes, klar strukturiertes Markup mit Kommentaren.

  • Zentrale Variablen für Styling und Verhalten, sodass Farben, Abstände, Labels und Optionen leicht angepasst werden können, ohne den Kerncode zu ändern.

  • Preis-Slider-Facette zum schnellen Filtern nach Preisspanne.

  • Klickbare Vorschläge, die sofort eine Suche auslösen.

Für Entwickler #

Styling #

Designs bestehen aus einem Haupt-Layout, CSS-Styling und einer Sammlung von Sub-Designs, die im Haupt-Layout referenziert werden können.

Alle diese Teile lassen sich für Desktop und Mobile separat bearbeiten. Standardmäßig verwendet die Omni-search dasselbe HTML für alle Bildschirmgrößen und ist dank CSS vollständig responsiv. Deshalb ist im Mobile-Tab anfangs kein Code.

Bei Bedarf kannst du ein komplett anderes HTML-Markup für Mobilgeräte erstellen, welches dann auf kleineren Bildschirmen verwendet wird.

Anfangs möchtest du wahrscheinlich nur einige Anpassungen vornehmen, um das Design an deine Marke anzupassen – du kannst dein Design später jederzeit bearbeiten.

HTML #

Dies ist das Haupt-Layout, das die Platzierung aller Elemente steuert. Es nutzt Liquid als Template-Sprache.

In unseren Vorlagen ist der erste Abschnitt für die meist veränderten Elemente gedacht, z.B. Sortier-Labels, Währung sowie die verschiedenen Texte, die für deine Sprache übersetzt werden können.

CSS #

Styling, das zusammen mit dem HTML injiziert wird, sodass du die Optik in sich geschlossen steuern kannst.

Verfügbare Sub-Designs #

Im Suchcode-Editor findest du unterhalb des Haupt-Code-Bereichs Available Designs and Components. Scrolle nach unten, um eine Komponente zu finden und zu bearbeiten. Nutze die Tabs über dem Editor, um zwischen Desktop- und Mobile-HTML/CSS zu wechseln.

Nach dem Bearbeiten einer Komponente klicke auf Save, dann kehre separat zum Hauptdesign zurück. Designs, die du hier hinzufügst, können im generellen Layout referenziert werden. Sie dienen als Module, die eigenständig bearbeitet werden, und werden mit ihrer ID und ihrem Namen eingefügt: {{@247373 - TopBarSearchForm}}

Du kannst jedes Sub-Design löschen, duplizieren oder seine Referenz kopieren, indem du auf die Drei-Punkte-Schaltfläche klickst.

Um ein Sub-Design zu bearbeiten, klicke auf sein Bearbeiten-Icon. Nach dem Bearbeiten klicke auf Speichern & Schließen, um zum Haupteditor zurückzukehren.

Einige Elemente benötigen spezifische Identifikatoren:

  • Das Eingabefeld id="clerk-omnisearch-input"
  • Der Wrapper für Inhalte id="clerk-omnisearch-content"

Willst du deinen Fortschritt prüfen, kannst du dies über den Button „Design-Vorschau“ tun.

Die am häufigsten vorgenommenen Änderungen an Designs sind diese:

  • Logo: Gehe in das TopBarSearchForm und ersetze das Standardlogo durch dein eigenes.

  • Schriftarten: Passe z.B. Schriftarten auf dein Corporate Design an.

  • Farben: Hinterlege in gewünschten Bereichen deine Markenfarben, um Buttons oder Labels hervorzuheben oder dem Look deiner Seite anzupassen.

  • Button- und Tag-Rahmen: Farbe, Radius, Breite lassen sich ändern …

  • Links: Spezielle Link-Stile kannst du ebenfalls anpassen.

Reaktive vs. statische Bereiche #

Zu wissen, welche Teile von Omnisearch bei jeder Abfrage neu gerendert werden – und welche nicht –, ist wichtig, wenn du das Design anpasst.

Statische Bereiche werden nur einmal gerendert, wenn das Overlay geöffnet wird, und bei späteren Abfragen nicht erneut erzeugt:

  • Der Overlay-Container selbst (clerk-omnisearch-overlay)
  • Das Such-Eingabefeld (#clerk-omnisearch-input)
  • Jegliches HTML im Design, das außerhalb von #clerk-omnisearch-content liegt – z.B. Logo, Schließen-Button oder Top-Bar

Das Eingabefeld bleibt mit Absicht statisch. Ein erneutes Rendern bei jedem Tastendruck würde das Tippen der Besucher stören und das Sucherlebnis beeinträchtigen.

Reaktive Bereiche sind alles innerhalb von #clerk-omnisearch-content. Dieser Unterbereich wird bei jeder Suchanfrage komplett neu gerendert:

  • Produkt-Ergebnisse
  • Facetten und Filter
  • Kategorien, Seiten und Vorschläge
  • Ergebnisanzahl und Sortiersteuerung
  • Keine-Ergebnisse-Hinweise

Wenn du ein Element bei Abfrage-Änderung aktualisieren willst – z.B. eine Live-Anzahl von Treffern in der Kopfzeile –, muss es innerhalb von #clerk-omnisearch-content platziert sein. Soll es beim Tippen sichtbar, aber stabil bleiben, kommt es außerhalb in den statischen Kopfbereich.

Kein-Ergebnis-Zustand #

Wenn eine Anfrage keine Produkte ergibt, zeigt Omnisearch nicht automatisch einen Fallback an – das wird im Design per Liquid gesteuert.

Der empfohlene Ansatz ist, Produkte abzufragen und bei leeren Ergebnissen einen Fallback-Slider sowie eine eigene Nachricht einzublenden:

{% if products.length > 0 %}
  <!-- Normale Ergebnisse -->
  {% for product in products %}
    <!-- Produktkarte -->
  {% endfor %}

{% else %}
  <!-- Kein-Ergebnis-Fallback -->
  <div class="clerk-no-results-message">
    Keine Ergebnisse für "{{ query }}" — hier einige beliebte Produkte:
  </div>

  <span class="clerk"
    data-api="recommendations/popular"
    data-limit="8"
    data-template="@omnisearch-product-card">
  </span>
{% endif %}

Du kannst auch results.products.no_exact_match nutzen, um zu erkennen, wann Omnisearch unscharfe/ähnliche statt exakter Treffer anzeigt, und eine entsprechende Nachricht anzeigen:

{% if results.products.no_exact_match %}
  <div class="clerk-no-exact-match">
    Keine exakten Treffer für "{{ query }}" — ähnliche Ergebnisse werden angezeigt:
  </div>
{% endif %}

Beide Muster lassen sich kombinieren. Typischerweise wird die no_exact_match-Nachricht über den Ergebnissen angezeigt und der Fallback-Slider nur, wenn products.length == 0.

Den Text der Kein-Ergebnis-Nachricht bestimmst du als ganz normales HTML direkt im Design, sodass er beliebig übersetzbar oder gestaltbar bleibt – ganz ohne Änderungen außerhalb des Design-Editors.

Overlay-Struktur #

Wird Omnisearch initialisiert, erzeugt es ein Element mit der Klasse clerk-omnisearch-overlay und fügt es ans Ende des <body> ein.

Hier fügen wir das Design ein – da das Eingabefeld Teil des Designs ist, müssen wir eine Struktur sicherstellen, die ein erneutes Rendern des Eingabefeldes bei jeder neuen Suche verhindert. Die Struktur unterhalb des Overlays sollte etwa so aussehen:

<div>
    <input type="text" id="clerk-omnisearch-input"/>
    <div id="clerk-omnisearch-content">
        Element!
    </div>
</div>

Eingabefeld #

Um das Eingabefeld zu finden, muss es den Bezeichner clerk-omnisearch-input haben. Ist das Trigger-Element ausgelöst, erhält dieses Feld den Fokus und die aktuelle Anfrage.

Inhalts-Wrapper #

Der Inhalts-Wrapper (mit clerk-omnisearch-content) ist der Bereich, in dem alles andere stattfindet – Facetten, Slider etc., alles außer dem Eingabefeld.

Klassen #

Designs können Funktionalität erhalten, indem bestimmte Klassen an Elemente vergeben werden.

Schließen-Button #

clerk-omnisearch-close

Ein Element mit dieser Klasse blendet das Overlay aus, wenn es angeklickt wird.

Sortierung #

clerk-omnisearch-sort

Findet Sortier-Dropdowns und fügt diesen Eventlistener hinzu.

Eine Sortieroption erhält diese Klasse am selektierenden Element, beispielsweise in einem Dropdown. Damit es funktioniert, muss das Element als value:[desc|asc] angelegt sein (der Sortierwert, Doppelpunkt, dann entweder desc oder asc). Optional kannst du ein data-sort-type-Attribut vergeben, falls du z.B. Kategorien oder Seiten sortieren möchtest.

Such-Facette #

clerk-facet-search

Ist eine Facettensuche vorhanden, erstellt sie einen Listener und blendet Facetten aus, die nicht zum Suchbegriff passen.

Die Klasse prüft im Webpage-Kontext das Vorhandensein einer Facetten-Suche. Für die Funktionalität muss das Element einen Stringwert besitzen.

Komplett zurücksetzen #

clerk-omnisearch-full-reset

Wird diese Klasse angeklickt, werden alle Facetten abgewählt und die Anfrage wird zurückgesetzt.

Facetten zurücksetzen #

clerk-omnisearch-facet-full-reset

Wird diese Klasse angeklickt, werden alle aktiven Facetten abgewählt. Diese Variante findet man meist als „Alles löschen“-Button innerhalb einer Gruppe, um Filter mit einem Klick zurückzusetzen.

Gruppe zurücksetzen #

clerk-omnisearch-facet-group-reset

Nach Klick auf ein Element mit dieser Klasse werden alle Kindelemente innerhalb der Gruppe abgewählt.

Um das Abwählen einer ganzen Facettengruppe zu ermöglichen, bekommt ein Element diese Klasse und muss zusätzlich ein Attribut mit dem Namen data-facet-group enthalten – dort steht die zu leerende Gruppe.

Einzelne Facette zurücksetzen #

clerk-omnisearch-facet-reset

Elemente mit dieser Klasse sollen genau eine Facette per Gruppen-/Wertepaar abwählen.

Diese Klasse ist gedacht, um nur eine Facette einer Gruppe zu entfernen. Ein Element mit dieser Klasse erhält zusätzlich die Attribute data-facet-group und data-facet-value und entfernt per Klick nur die damit verknüpfte Facette; andere bleiben aktiv.

Facette klicken #

clerk-facet

Elemente mit dieser Klasse werden als auswählbare Facette behandelt.

Jede Facette sollte die Klasse sowie die Attribute data-facet-group und data-facet-value besitzen, sodass genau bekannt ist, was der/die Nutzer:in auswählt.

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.