Search

Wähle eine von zwei Suchkonfigurationen für deinen Webshop:
- Omnisearch alleine: ein Overlay mit Ergebnissen während der Eingabe, vollständiges Durchstöbern der Ergebnisse und Facetten.
- Instant Search und Search Page zusammen: ein Dropdown für schnelle Ergebnisse und eine separate Seite mit Facetten zum Durchstöbern aller Treffer.
Omnisearch ersetzt beide Komponenten. Wenn Omnisearch bereits installiert ist, musst du weder Instant Search noch eine Search Page hinzufügen. Folge nur den Anweisungen zu deiner gewählten Konfiguration unten.
Dieser Artikel erklärt, wie du mit einem Clerk.js setup in VTEX startest.
Instant Search #
Instant Search liefert Suchergebnisse in Echtzeit, während Kunden tippen, dargestellt in einem Dropdown unter dem Suchfeld.
Design erstellen #
Du kannst entweder den Design Editor für eine visuelle Konfiguration verwenden oder Code Designs nutzen.
Design Editor #
- Gehe zu Search > Designs und klicke auf New Design.
- Wähle Other designs > Instant Search.
- Wähle aus der Liste der Designvorlagen deine Startvorlage aus.
- Gib einen Namen ein und klicke auf Create design.
- Nimm gewünschte Änderungen am Design vor.
Du kannst das Setup-Handbuch mit dem Titel SEARCH unter der Option Getting Started verwenden, um schnell Designs und Content zu erstellen, die zum Farbschema und Stil deines Webshops passen.
Klicke auf Publish, sobald du mit dem Styling zufrieden bist.
Du kannst deine Designs und Inhalte später einfach im linken Menü unter Designs and Elements ändern.
Code Design #
- Gehe zu Search > Designs und klicke auf New Design.
- Wähle Other designs > Blank > With code.
- Gib einen Namen ein und klicke auf Save.
- Erstelle ein Code Design von Grund auf mit Liquid code.
Wenn du eine Startvorlage möchtest, sieh dir die Instant Search-Vorlage weiter unten an.
Element erstellen #
Dies enthält alle Einstellungen, um das Instant Search Dropdown anzuzeigen und auf deiner Website einbindbar zu machen.
- Gehe zu Search > Elements.
- Klicke auf New Element.
- Benenne es “Live Search”.
- Wähle unter Element type den Typ Live-search aus dem Dropdown.
- Wähle unter Design das von dir erstellte Design im Dropdown aus.
- Klicke oben auf der Seite auf Save.
Auf der Website hinzufügen #
- Öffne aus den Element-Einstellungen den Tab Insert into website.
- Du hast zwei Möglichkeiten:
- Mit injection kannst du den Code über einen CSS-Selektor einbinden.
- Mit embedded code kannst du den Code manuell auf deiner Website einfügen.
- Wähle die für dich einfachste Option aus.
- Die App erstellt ein Komponenten-Suchfeld für deinen Header:
clerkio_searchinput. Standardmäßig führt dieses Feld zu der dedizierten Routen-Seite, die von der App erstellt wurde.
Search Page #
Die Search Page bietet ein vollständiges Suchseiten-Erlebnis mit erweiterten Filteroptionen. Hier werden alle Treffer für die Suchanfrage eines Kunden angezeigt.
Design erstellen #
Du kannst entweder den Design Editor für eine visuelle Konfiguration verwenden oder Code Designs nutzen.
Design Editor #
- Gehe zu Search > Designs und klicke auf New Design.
- Wähle Other designs > Search Page.
- Wähle aus der Liste der Designvorlagen deine Startvorlage aus.
- Gib einen Namen ein und klicke auf Create design.
- Nimm gewünschte Änderungen am Design vor.
Du kannst das Setup-Handbuch mit dem Titel SEARCH unter der Option Getting Started verwenden, um schnell Designs und Content zu erstellen, die zum Farbschema und Stil deines Webshops passen.
Klicke auf Publish, sobald du mit dem Styling zufrieden bist.
Du kannst deine Designs und Inhalte später einfach im linken Menü unter Designs and Elements ändern.
Code Design #
- Gehe zu Search > Designs und klicke auf New Design.
- Wähle Other designs > Blank > With code.
- Gib einen Namen ein und klicke auf Save.
- Erstelle ein Code Design von Grund auf mit Liquid code.
Wenn du eine Startvorlage möchtest, sieh dir die Search Page Vorlage weiter unten an.
Element erstellen #
Dies enthält alle Einstellungen, um die Search Page anzuzeigen und in deine bestehende Suchseite einzubinden.
- Gehe zu Search > Elements.
- Klicke auf New Element.
- Benenne es “Search Page”.
- Wähle unter Element type den Typ Search page aus dem Dropdown.
- Wähle unter Design das von dir erstellte Design im Dropdown aus.
- Klicke oben auf der Seite auf Save.
Auf der Website hinzufügen #
- Öffne aus den Element-Einstellungen den Tab Insert into website.
- Du hast zwei Möglichkeiten:
- Mit injection kannst du den Code über einen CSS-Selektor einbinden.
- Mit embedded code kannst du den Code manuell auf deiner Website einfügen.
- Wähle die für dich einfachste Option aus.
- Füge in deinem Store-Theme
clerkiopartnerdk.integration-vtex 1.xals Theme peerDependency in der Dateimanifest.jsonhinzu:
"peerDependencies": {
"clerkiopartnerdk.integration-vtex": "1.x"
}
- Füge den Block
clerkio_searchpageauf der dedizierten Landing-Suchseite hinzu.
{
"responsive-layout.desktop#searchpage": {
"children": ["clerkio_searchpage"]
}
}
Die App erstellt außerdem eine dedizierte Suchseiten-Route unter /clerk-search?searchTerm=__QUERY__. Diese Route enthält bereits den Block clerkio_searchpage im Body.
Nachdem du die Funktionen aktiviert hast, kannst du die Clerk.io SEARCH-Funktion in deinem Webshop sehen.
Omnisearch #
Die Omnisearch kombiniert die Instant Search und die Search Page zu einem einzigen Overlay, das angezeigt wird, wenn der Nutzer ins Suchfeld klickt.
Für Single Page Applications (SPAs) aktiviere SPA Auto Detect Changes unter Settings > Features in my.clerk.io, um Omnisearch zu integrieren.
Dies ist das gleiche Feature wie observe_dom: true in der Clerk.js-Konfiguration. Mehr dazu unter
DOM Observation.
Design erstellen #
Omnisearch funktioniert nur mit Code Designs, da das Layout komplexer ist und beliebig angepasst werden kann.
- Gehe zu Search > Designs und klicke auf New Design.
- Wähle Omni-search.
- Wähle aus der Liste der Designvorlagen deine Startvorlage aus.
- Gib einen Namen ein und klicke auf Save.
- Nimm gewünschte Anpassungen am Design vor. Mehr Informationen findest du im Omnisearch Guide.
Element erstellen #
Dies enthält alle Einstellungen, um die Omnisearch anzuzeigen und auf deiner Website einbindbar zu machen.
- Gehe zu Search > Elements.
- Klicke auf New Element.
- Benenne es “Omni-Search”.
- Füge ein Tracking Label hinzu – dieses sollte ebenfalls “Omni-Search” lauten.
- Wähle unter Element type den Typ Omni-search aus dem Dropdown.
- Wähle unter Design das von dir erstellte Design im Dropdown aus.
- Klicke oben auf der Seite auf Save.
Auf der Website hinzufügen #
- Öffne aus den Element-Einstellungen den Tab Insert into website.
- Du hast zwei Möglichkeiten:
- Mit injection kannst du den Code über einen CSS-Selektor einbinden.
- Mit embedded code kannst du den Code manuell auf deiner Website einfügen.
- Wähle die für dich einfachste Option aus.
- Wenn du die Option “embedded code” verwendest, ersetze
INSERT_CSS_SELECTOR[...]durch eine eindeutige Klasse oder ID für dein Suchfeld. Die Omnisearch erscheint, sobald das Eingabefeld mit dem Selektor angeklickt wird.
Startvorlagen #
Wenn du Code Designs nutzen möchtest, können dir diese Templates einen schnellen Einstieg geben. Sie enthalten die grundlegenden UI-Elemente für Instant Search und Search Page, die du nach Bedarf anpassen kannst.
Instant Search Code #
Dies umfasst die HTML- und CSS-Komponenten für das Instant Search Dropdown. Füge diese in ein Code Design in my.clerk.io ein.
HTML #
<div class="clerk-instant-search">
{% if hits.length == 0 %}
<div class="clerk-instant-search-no-results">
Nichts gefunden: <b>{{ query }}</b>... versuche eine einfachere Suche!
</div>
{% endif %}
{% if content.query != response.query %}
<div class="clerk-instant-search-alternate-query">
<i class="fas fa-search clerk-icon" aria-hidden="true"></i> Ergebnisse für: <b>{{ query }}</b>
</div>
{% endif %}
<div class="clerk-instant-search-grid">
{% if products.length > 0 %}
<div class="clerk-instant-search-col clerk-col-1">
<div class="clerk-instant-search-products">
<div class="clerk-instant-search-title">Produkte</div>
{% for product in products %}
<a href="{{ product.url }}">
<div class="clerk-instant-search-product clerk-instant-search-key-selectable">
<div class="clerk-instant-search-product-image" style="background-image: url('{{ product.image }}');"></div>
<div>
<div class="clerk-instant-search-product-name">{{ product.name | highlight query }}</div>
{% if product.price < product.list_price %}
<div class="clerk-instant-search-product-list-price">{{ product.list_price | money }}</div>
{% endif %}
<div class="clerk-instant-search-product-price">{{ product.price | money }}</div>
</div>
<div>
<div class="clerk-instant-search-product-button">Jetzt kaufen</div>
</div>
</div>
</a>
{% endfor %}
{% if hits > products.length %}
<div class="clerk-desktop-button clerk-instant-search-more-results clerk-instant-search-key-selectable">
<a class="clerk-view-more-results-button" href="/search?q={{ query }}">
<u>Zeige <b>{{ hits }}</b> weitere Ergebnisse für "<i>{{ query }}</i>"</u>
</a>
</div>
{% endif %}
</div>
</div>
{% endif %}
{% if (suggestions.length + categories.length + pages.length) > 0 %}
<div class="clerk-instant-search-col clerk-col-2">
{% if suggestions.length > 1 %}
<div class="clerk-instant-search-suggestions">
<div class="clerk-instant-search-title">Suchvorschläge</div>
{% for suggestion in suggestions %}
{% if suggestion != query %}
<div class="clerk-instant-search-suggestion clerk-instant-search-key-selectable">
<a href="/search?q={{ suggestion highlight query 'bold' true }}">
<i class="fas fa-search clerk-icon" aria-hidden="true"></i>{{ suggestion }}
</a>
</div>
{% endif %}
{% endfor %}
</div>
{% endif %}
{% if categories.length > 0 %}
<div class="clerk-instant-search-categories">
<div class="clerk-instant-search-title">Kategorien</div>
{% for category in categories %}
<div class="clerk-instant-search-category clerk-instant-search-key-selectable">
<a href="{{ category.url }}">
{{ category.name | highlight query }}
</a>
</div>
{% endfor %}
</div>
{% endif %}
{% if pages.length > 0 %}
<div class="clerk-instant-search-pages">
<div class="clerk-instant-search-title">Verwandte Inhalte</div>
{% for page in pages %}
<div class="clerk-instant-search-category clerk-instant-search-key-selectable">
<a href="{{ page.url }}">
<div class="name">{{ page.title | highlight query 'bold' true }}</div>
</a>
</div>
{% endfor %}
</div>
{% endif %}
</div>
{% endif %}
{% if hits > products.length %}
<div class="clerk-mobile-button clerk-instant-search-more-results clerk-instant-search-key-selectable">
<a href="/search?q={{ query }}">
Zeige <b>{{ hits }}</b> weitere Ergebnisse für "<i>{{ query }}</i>"
</a>
</div>
{% endif %}
</div>
</div>
CSS #
.clerk-instant-search {
padding: 20px;
}
.clerk-instant-search-container a {
color: black !important;
text-decoration: none !important;
}
.clerk-instant-search-container a:hover {
color: #b6c254; !important;
}
.clerk-instant-search {
overflow: hidden;
width: 100%;
min-width: 650px;
max-width: 1000px;
margin: .2em auto;
background-color: white;
border: 1px solid #eee;
border-top: 0px;
border-radius: 5px 5px 10px 10px;
box-shadow: 0 1em 2em 1em rgba(0,0,0,.2);
}
.clerk-instant-search-no-results {
padding: 1em;
font-style: italic;
text-align: center;
}
.clerk-instant-search-alternate-query {
margin: 0px 0px 5px 0px;
}
.clerk-instant-search-more-results {
padding: 1em;
font-size: 1.2em;
text-align: center;
}
.clerk-instant-search-title {
color: #b6c254;
margin: 20px 0px 5px 0px;
padding: 0px 0px 10px 0px;
text-transform: uppercase;
font-size: 1em;
border-bottom: 1px solid #000000;
}
/* Products */
.clerk-instant-search-products {
padding-right: 2em;
}
.clerk-instant-search-product {
display: flex;
padding: .2em;
color: gray;
}
.clerk-instant-search-product:hover {
background-color: rgba(46, 204, 113, .1);
}
.clerk-instant-search-product:hover .clerk-instant-search-product-button {
transform: scale(1.05);
}
.clerk-instant-search-product > * {
flex: 1 1 auto;
}
.clerk-instant-search-product > *:first-child, .clerk-instant-search-product > *:last-child {
flex: 0 0 auto;
}
.clerk-instant-search-product-image {
display: inline-block;
width: 3em;
height: 3em;
margin-right: 1em;
background-position: center center;
background-repeat: no-repeat;
background-size: contain;
}
.clerk-instant-search-product-name {
overflow: hidden;
height: 1.2em;
margin-bottom: .2em;
}
.clerk-instant-search-product-list-price {
display: inline-block;
margin-right: .5em;
opacity: .8;
font-weight: normal;
text-decoration: line-through;
color: gray;
}
.clerk-instant-search-product-price {
display: inline-block;
font-weight: bold;
}
.clerk-instant-search-product-button {
display: block;
margin: .2em auto;
padding: .8em 2em;
border: none;
border-radius: .5em;
background-color: #b6c254;
color: white;
text-transform: uppercase;
text-align: center;
white-space: nowrap;
font-weight: bold;
font-size: .8em;
cursor: pointer;
}
/* Suggestions */
.clerk-icon {
color: lightgray;
margin-right: .5em;
}
.clerk-instant-search-suggestions {
margin-bottom: 1em;
}
.clerk-instant-search-suggestion {
padding: .1em;
}
/* Categories */
.clerk-instant-search-categories {
margin-bottom: 1em;
}
.clerk-instant-search-category {
padding: 5px;
margin: 5px;
width: auto;
display: inline-block;
border: 1px solid black;
border-radius: 2px;
}
/* Pages */
.clerk-instant-search-pages {
margin-bottom: 1em;
}
.clerk-instant-search-page {
padding: .1em;
}
@media screen and (min-width: 1200px) {
.clerk-instant-search-container {
width: 50%;
}
.clerk-instant-search-grid {
display: flex;
}
.clerk-col-1 {
flex: 2;
}
.clerk-col-2 {
flex: 1;
}
.clerk-mobile-button {
display: none;
}
}
@media screen and (min-width: 768px) and (max-width: 1200px){
.clerk-instant-search-container {
right: 0px !important;
left: 0px !important;
}
.clerk-mobile-button {
display: none;
}
}
@media screen and (max-width: 767px) {
.clerk-instant-search-container {
right: 0px !important;
}
.clerk-desktop-button {
display: none;
}
}
@media screen and (min-width: 376px) and (max-width: 800px) {
.clerk-instant-search {
min-width: 0px !important;
}
}
@media screen and (max-width: 375px) {
.clerk-instant-search {
min-width: 200px !important;
}
.clerk-instant-search-col {
margin: 0px 0px 20px 0px;
}
.clerk-instant-search-product-name {
height: 3em !important;
}
}
Search Page Code #
Dies umfasst die HTML- und CSS-Komponenten für die Darstellung einer Search Page. Füge diese in ein Code Design in my.clerk.io ein.
HTML #
<div class="clerk-search-result">
<div class="clerk-search-result-headline">{{ headline }}</div>
<div class="clerk-grid">
{% for product in products %}
<div class="clerk-grid-item">
<div class="clerk-grid-product">
<a href="{{ product.url }}">
{% if product.price < product.list_price %}
<div class="clerk-grid-badge">Im Angebot</div>
{% endif %}
<div class="clerk-grid-image" style="background-image: url('{{ product.image }}');"></div>
<div class="clerk-grid-brand">{{ product.brand }}</div>
<div class="clerk-grid-name">{{ product.name }}</div>
<div class="clerk-grid-pricing">
{% if product.price < product.retail_price %}
<div class="clerk-grid-list-price">£{{ product.retail_price | money }}</div>
{% endif %}
<div class="clerk-grid-price">£{{ product.price | money }}</div>
</div>
</a>
{% if product.stock == 1 %}
<a class="clerk-not-in-stock" href="{{ product.url }}" data-event-type="product-click">
<div class="clerk-grid-button-not-in-stock">Nicht verfügbar</div>
</a>
{% else %}
<a class="clerk-add-to-cart" href="/cart.php?action=add&product_id={{ product.id }}" data-event-type="product-click">
<div class="clerk-grid-button">In den Warenkorb</div>
</a>
{% endif %}
</div>
</div>
{% endfor %}
</div>
{% if count > products.length %}
<div class="clerk-load-more-button" onclick="Clerk('content', '#{{ content.id }}', 'more', 40);">Mehr Ergebnisse anzeigen</div>
{% endif %}
</div>
CSS #
#clerk-search-results {
margin: 0px;
}
.clerk-search-result {
margin: 1em 0;
}
.clerk-search-result-headline {
font-weight: bold;
font-size: 2em;
text-align: center;
}
.clerk-grid {
display: flex;
flex-flow: row wrap;
}
.clerk-grid-item {
margin: auto;
}
.clerk-grid-product {
position: relative;
overflow: hidden;
margin: 1em;
padding: 1em;
background-color: white;
border: 1px solid #eee;
border-radius: 1em;
box-shadow: 0 .1em .2em 0 rgba(0,0,0,.08);
text-align: center;
}
.clerk-grid-badge {
position: absolute;
top: 5px;
right: -35px;
display: inline-block;
width: 120px;
margin: 10px auto;
padding: 5px 0;
border-radius: 3px;
background-color: #fbc531;
font-size: 10px;
color: white;
text-align: center;
letter-spacing: 1px;
transform: rotate(45deg);
}
.clerk-grid-tags {
position: absolute;
top: .8em;
left: .8em;
}
.clerk-grid-tag {
display: inline-block;
padding: .2em .8em;
border-radius: .3em;
background-color: gray;
font-size: 10px;
color: white;
letter-spacing: 1px;
}
.clerk-grid-image {
width: 100%;
height: 8em;
margin-bottom: 1em;
background-position: center center;
background-repeat: no-repeat;
background-size: contain;
}
.clerk-grid-brand {
font-size: 0.9em;
color: #757575;;
}
.clerk-grid-name {
height: 3em;
overflow: hidden;
color: #4a3b40;
font-weight:bold;
font-size: 15px;
margin-bottom: 1em;
}
.clerk-grid-pricing {
display: flex;
margin-bottom: 1em;
}
.clerk-grid-price {
flex: 1;
color: #757575;
font-weight: bold;
}
.clerk-grid-list-price {
flex: 1;
opacity: .8;
font-weight: normal;
text-decoration: line-through;
color: gray;
}
.clerk-add-to-cart, .clerk-add-to-cart:hover {
color: white;
}
.clerk-not-in-stock, .clerk-not-in-stock:hover {
color: #4a3b40;
}
.clerk-grid-button-not-in-stock {
display: block;
margin: 0 auto;
padding: .6em 2em;
border: none;
border-radius: .5em;
background-color: white;
color: #4a3b40;
text-transform: uppercase;
text-align: center;
white-space: nowrap;
font-weight: bold;
cursor: pointer;
}
.clerk-grid-button {
display: block;
margin: 0 auto;
padding: .6em 2em;
border: none;
border-radius: .5em;
background-color: #b6c254;
color: white;
text-transform: uppercase;
text-align: center;
white-space: nowrap;
font-weight: bold;
cursor: pointer;
}
.clerk-load-more-button {
display: block;
width: 20em;
margin: 1em auto;
padding: .6em 2em;
border: none;
border-radius: .5em;
background-color: #b6c254;
color: white;
text-transform: uppercase;
text-align: center;
white-space: nowrap;
font-weight: bold;
font-size: 1.2em;
cursor: pointer;
}
@media screen and (min-width: 1025px) {
.clerk-grid-item {
flex: 0 0 25%;
margin: auto;
}
}
@media screen and (min-width: 500px) and (max-width: 1024px) {
.clerk-grid-item {
flex: 0 0 33%;
margin: auto;
}
}
@media screen and (max-width: 499px) {
.clerk-grid-item {
flex: 0 0 100%;
margin: auto;
}
}
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.