ideal.shop

Search

Verbinden Sie die Desktop- und Mobile-Search, während das Verhalten Ihres Themes beibehalten wird.

Richte Search ein, nachdem du deine Daten importiert und überprüft hast. Identifiziere zuerst, wie dein Theme Search auf Desktop und Mobilgeräten öffnet, und wähle dann die passende Experience dazu aus.

Search inspizieren #

Ein Theme kann separate Desktop-Eingabefelder, mobile Icons, versteckte Panels und Suchfelder auf der Startseite haben. Untersuche jedes Element, bevor du Trigger auswählst.

  1. Öffne den Webshop auf Desktop und Mobilgeräten. Finde alle Eingabefelder oder Steuerelemente, mit denen Search geöffnet wird.
  2. Verwende Entwicklertools, um stabile Selektoren zu überprüfen und sicherzustellen, welches Eingabefeld den eingegebenen Text erhält.
  3. Teste das native Dropdown, das mobile Panel, die Enter-Taste und das Formular-Submit. Notiere, welche Verhaltensweisen ersetzt oder beibehalten werden müssen.
  4. Überprüfe einen anderen Seitentyp; ein Suchfeld auf der Startseite kann sich vom Header-Eingabefeld unterscheiden.

Beispiel-Trigger von Fodmagasinet sind .search-bar #search-overlay-input und #frontpage_search_container. Überprüfe, ob diese Selektoren in deinem Webshop existieren und die gleiche Funktion haben. Ein Trigger-Container ist nicht unbedingt das Texteingabefeld selbst.

Experience wählen #

Verwende Omnisearch für ein kombiniertes Sucherlebnis, oder behalte ein separates Dropdown und eine Suchseite bei, wenn dies besser zu deinem Theme passt.

ExperienceWann verwenden
Vollbild-OmnisearchEin Such-Overlay, das den gesamten Viewport mit einer eigenen Oberfläche abdeckt.
Teilweise OmnisearchErgebnisse unterhalb des nativen Headers, wobei Suchfeld, Logo und Warenkorb erhalten bleiben.
Instant SearchEin Dropdown, das mit einem vorhandenen Eingabefeld verbunden ist, meist zusätzlich zu einer separaten Ergebnisseite.
SuchseiteEine dedizierte Ergebnisseite mit Filter und Sortierung.

Omnisearch erstellen #

  1. Gehe zu Search > Designs > New Design und wähle eine Omnisearch-Vorlage aus.
  2. Benenne und speichere das Design und passe die Produktkarten mithilfe der Karten-Daten Prüfung an. Produktseiten-Links unterstützen Produkte, die Varianten-Auswahl benötigen.
  3. Gehe zu Search > Elements > New Element, benenne das Element und wähle als Typ Omni-search aus.
  4. Wähle das Design, speichere es unter In preview, und öffne die Einfüge-Einstellungen.
  5. Konfiguriere den verifizierten Trigger-Selektor per Injection oder kopiere den generierten Embed-Code einmalig in dein Theme.
  6. Wähle Full Overlay oder Partial Overlay und teste alle beabsichtigten Trigger.

Für Partial Overlay stelle den Header selector auf den nativen Header-Wrapper und den Search input selector auf das eigentliche Texteingabefeld ein. Passe die Overlay-Breite und -Höhe an das Layout an. Siehe Omnisearch für diese Optionen.

Das Partial Setup von Fodmagasinet verwendet den nativen Header und das Eingabefeld anstelle eines geklonten Headers oder Warenkorbs. Seine Selektoren, Header-Struktur, Breakpoints, Farben und Abstände sind Beispiele zum Inspizieren, aber keine Vorgaben für andere Themes.

Für ein Dropdown erstelle ein Instant Search Design und ein Live-search Element. Ziel im Einfüge-Dialog das verifizierte Eingabefeld an und wähle die Dropdown-Position.

Für eine Ergebnisseite erstelle ein Search Page Design und Element, dann füge es in das Template der Ergebnisseite ein. Übergib die aktuelle Query mit dem generierten Embed-Code und leite das native Formular auf diese Seite um.

Nutze die Instant Search und Search Page Anleitungen für die geteilte Konfiguration. Ersetze native Ergebnisse nur im jeweiligen Ergebnisse-Container; Navigation und Layout der Seite sollen erhalten bleiben.

Native Funktionalität #

Kläre überschneidende Handler, bevor du Search für Besucher aktivierst. Das bloße Verstecken eines nativen Dropdowns kann dazu führen, dass deren Tastatur- oder Formular-Handler aktiv bleiben.

Tippe während der Preview echte Zeichen ein und prüfe, ob sowohl native als auch Clerk.io Ergebnisse erscheinen. Untersuche Icon und Panel auf Mobilgeräten separat; das falsche Panel kann das Eingabefeld verstecken oder den Verlauf beeinflussen.

Wenn native Handler konkurrieren, soll der Theme-Entwickler nur das entsprechende Eingabefeld, Panel oder Formular anpassen. Jede temporäre Anpassung nur im gewünschten Search-Zustand vornehmen, damit die normale Seite nach dem Schließen weiter nutzbar bleibt.

Teste die Pfade keydown, keyup und Formular-submit. Enter muss entweder das ausgewählte Clerk.io Ergebnis öffnen oder die beabsichtigte Suche ausführen. Verhindere nicht global Enter und entferne keine Tastatur-Listener insgesamt: Die Auswahl von Ergebnissen mit den Pfeiltasten muss weiter funktionieren.

Durch Schließen und Escape müssen die ursprüngliche Seite, Fokus und Scrollposition wiederhergestellt werden, ohne zurückzuspringen oder eine leere Seite anzuzeigen. Wiederhole Öffnen/Schließen, navigiere zu einem Ergebnis und teste Zurück/Vorwärts auf Desktop und Mobilgeräten.

Facetten #

Wähle Filter aus Attributen, die tatsächlich an importierten Produkten vorhanden sind. Ein Template-Feld wie vendor, brand oder Kategorie passt eventuell nicht zu deinem Feed.

Untersuche mehrere Datensätze, wähle die verfügbaren Attribute in der Search-Konfiguration aus und vergebe lokalisierten Namen. Bestätige, dass jede Facette das Ergebnis korrekt verändert, auch bei Produkten ohne ein optionales Attribut.

Vergleiche beim Sortieren die importierten Werte mit den auf Karten angezeigten Preisen. Ein visuelles “niedrigster Variantenpreis”-Label korrigiert keinen falschen Elternpreis für die Sortierung.

Siehe Search Best Practices für Tipps zu sinnvollen Filtern und Ergebnislayouts.

Content-Ergebnisse #

Importiere Artikel und andere Seiten, bevor du sie in Search aktivierst. Folge Import Pages, um diese über die Sitemap als Teil deiner AI Integration zu holen.

Überprüfe anschließend die Page-Result-Einstellungen des Elements und den Page-Results-Bereich im Design. Importierte Artikel bleiben verborgen, wenn das Design diesen Bereich auslässt oder das Layout die Spalte versteckt.

Suche nach einem markanten Artikeltitel und prüfe Link und Inhalt. Überprüfe dies getrennt von Produktmatching und seitenbasierten Recommendations.

Stil sicher anwenden #

Halte Search-CSS im jeweiligen Komponenten-Bereich, damit es nicht die Recommendation-Slider auf einer anderen Seite beeinflusst.

Gib zum Beispiel dem Wrapper deiner individuellen Search-Karte eine eigene Klasse und scope jede Regel auf diese:

.ideal-clerk-search .ideal-clerk-card {
  display: flex;
  flex-direction: column;
}

Wende keine Search-Layoutregeln auf globale .clerk-slider, button oder .active Selektoren an. Überprüfe Startseiten- und Produkt-Slider nach Öffnen und Schließen von Search, inklusive deren Pfeile, Breiten und Überlauf.

Beende den Prozess mit der Setup-Checkliste. Siehe das Search-Konflikte FAQ, falls native Steuerelemente weiterhin stören.

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