Omnisearch

Omnisearch er en komplet søgeoplevelse i ét overlay. Den kombinerer resultater, mens besøgende skriver, med fuld resultatsøgning og facetter, og erstatter de separate Instant Search og Search Page komponenter.
Vælg enten kun Omnisearch eller både Instant Search og Search Page sammen. Hvis Omnisearch allerede er installeret, behøver du ikke tilføje nogen af komponenterne. Tilpas dit eksisterende Omnisearch design og indstillinger for at forbedre oplevelsen.
Omnisearch inkluderer:
- Live resultater vises for dine besøgende, mens de skriver, og inkluderer produkter, kategorier og sider.
- Sortering og filtrering: så dine besøgende nemt og intuitivt kan indsnævre deres søgning.
- Nem integration på dit site ved brug af en af vores gode startskabeloner.
- Matcher dit brand ved at ændre et par standardindstillinger som logo, skrifttyper, farver mm.
- Fuld tilpasning med HTML, CSS og Liquid for udviklere.
Kom godt i gang #
Omnisearch består af et tilpasningsbart Design til visuelle elementer og en Element blok der lader det blive installeret på dit site.
Opret et design #
Dette gøres i Search > Designs > New Design
Vælg Omnisearch typen, vælg et startdesign og giv det et navn.
Klik på Save for at gemme standarddesignet. Gå tilbage til designlisten eller hoveddesignet som et separat navigationspunkt.
Vores standarddesigns virker ud af boksen og kan altid redigeres senere. Redigering kræver kendskab til HTML, CSS og Liquid. Se Styling i denne guide for mere information.
Opret et Element #
Dette gøres i Search > Element > New Element
Element-blokke er containere for elementer, du opretter i din my.clerk.io konto. De indeholder logikken for at vise resultater og indstillinger for, hvor mange resultater der skal vises. Empty State Logic kan også manipuleres gennem Rules.
Navn hjælper dig med at identificere dit element, hvis du vil oprette mere end ét. Det kan redigeres senere.
Element type er som standard Omnisearch, og bør ikke ændres. Her kan du også tilføje filtre hvis nødvendigt, men for de fleste opsætninger er det ikke nødvendigt.
Empty State Logic giver dig mulighed for at vælge, hvilke produkter der skal vises, når Omnisearch åbnes første gang, før der indtastes noget. Som standard er dette Bestsellers, men det kan også personliggøres, fx med Visitor Recommendations.
Afslut Design #
Designet til at vise Element blokken igennem. Vælg det design, du har oprettet.
Hvis dit design indeholder variabler, kan de også sættes her.
Du kan kontrollere antallet af resultater, der vises for hver type, hver gang der søges. Vi anbefaler typisk følgende mængder:
- Produkter: 20-60
- Forslag: 5
- Kategorier & sider: 10
Vælg til sidst hvilke attributter, du vil inkludere som Facets, og angiv de navne, de skal vises som i søgeresultaterne. Hvis du ikke kan finde en bestemt attribut i listen, tilføj den i “filterbare attributter”-listen i Search Configuration.
Indsæt på sitet #
Den anbefalede metode er via injection, men du kan også indsætte elementet på dit site med en embedkode.
Synlighed bruges til at styre, hvem der kan se Omnisearch.
I forhåndsvisning giver dig mulighed for at teste dit element uden at påvirke dit live site. Du kan åbne dit site i forhåndsvisning ved at klikke på “Open site in preview” eller ved at tilføje
?clerk_content_mode=previewtil dit site’s url.På mit live site bruges, når du er færdig med at teste og klar til at gøre det offentligt.
Brug af injection #
Dette er den nemmeste måde at installere på. Clerk tilføjer automatisk Omnisearch koden til dit site, ved at ramme et søgefelt efter eget valg og udløse på en event.
Event styrer, hvad brugeren skal gøre for at udløse Omnisearch. Ofte ønskes det vist, når dine besøgende klikker på dit søgeikon eller inputfelt.
Element bestemmer, hvilken del af websitet brugeren skal interagere med. For eksempel, hvis du vil have, at Omnisearch kun vises, når de interagerer med din søgebar (klik eller fokus), skal du blot finde CSS-selektoren, der bruges på den. Har du forskellige identifikatorer på mobil og desktop, så tilføj dem begge.
Sådan finder du din CSS-selektor:
- Inspicer din sides kode. I de fleste browsere kan du højreklikke hvor som helst og vælge Inspect eller lignende.
- Find det element, du vil ramme
- Højreklik på det, og find muligheden copy > copy selector
Brug af embedded kode #
Dette giver dig mulighed for at tilføje Omnisearch med en kodebid. Dette kræver, at du kan redigere HTML-filerne i din webshop eller tilføje kode med en editor.
Gem alle ændringer for at generere embedkoden.
Kopier denne kode og indsæt den i filen, der genererer alle sider i webshoppen, helst lige før </body> tagget.
Udskift INSERT_CSS_SELECTOR_FOR_ELEMENT_THAT_SHOULD_TRIGGER_OMNISEARCH med CSS-selektoren for det html-element, der skal udløse din Omnisearch.
Herunder er et fuldt eksempel på en Omnisearch embed-kode med alle konfigurationsmuligheder:
<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>
Visningstilstande #
Omnisearch understøtter to visningstilstande, der styrer, hvordan søgeinterfacet vises på dit site. Konfigurer dette i Insert fanen, når du redigerer din Omnisearch Element.
Fuldt overlay #
Dette er standardtilstanden. Når udløst, dækker Omnisearch hele skærmen med et fuldskærms-overlay. Søgeinterfacet tager over, og giver en fokuseret søgeoplevelse.
Brug denne tilstand, når du ønsker:
- Et distraktionsfrit søgemiljø
- Fuld kontrol over søgelayoutet
- At søgefeltet er uafhængigt af sitets header
Delvist overlay #
Denne tilstand integrerer Omnisearch med dit eksisterende site-header. I stedet for at dække hele skærmen, vises overlayet under din header, så headeren stadig er synlig og funktionel.
Brug denne tilstand, når du ønsker:
- At header og navigation forbliver tilgængelige under søgning
- En mere sømløs integration med dit eksisterende layout
- At søgeoplevelsen føles som en naturlig del af dit site
Konfigurationsmuligheder #
Når Partial Overlay vælges, bliver yderligere indstillinger tilgængelige:
Header selector
CSS-selektoren for dit site’s header-element. Omnisearch bruger denne til at placere overlayet direkte under headeren, så det flugter korrekt.
Eksempel på selektorer:
header.site-header#main-header
Search input selector
CSS-selektoren for dit eksisterende search input felt. Når den angives, synkroniserer Omnisearch med dit header-søgefelt, så indtastning her opdaterer Omnisearch resultaterne.
Eksempel på selektorer:
#search-input.header-search input[name="search"]
Bredde
Styrer overlayets horisontale størrelse:
- Fuldt bredde: Dækker hele browserbredden
- Indholdsbredde: Matcher bredden på en container, du angiver med CSS-selektor
- Fast bredde: En fast pixelbredde, du selv definerer
Højde
Styrer overlayets vertikale størrelse:
- Fra header til bund: Fylder plads fra under headeren til bund af skærmen
- Procentdel af viewport: En procentdel af browserhøjden (fx 80%)
- Fast højde: En fast pixelhøjde
- Max højde: Sætter et maks, men tillader overlayet at være mindre, hvis indholdet kræver det
Vandret placering
Styrer, hvor overlayet placeres vandret:
- Venstre: Justeres til venstre i skærmen
- Center: Midterstilles vandret
- Højre: Justeres til højre i skærmen
Lodret placering
Styrer den lodrette placering i forhold til header:
- Under header: Placeres direkte under dit header-element
- Fast fra top: Et specifikt pixeloffset fra toppen af skærmen
Design konfiguration #
Det meste af Omni-search kan konfigureres ved at ændre variablerne i designfilerne.
I liquid template language har en variabel denne struktur:
{% assign variable_name = "variable value" %}
Som tommelfingerregel skal kun variabelværdien ændres for at konfigurere Omni-search.
Mere tekniske brugere kan selvfølgelig stadig ændre specifikke HTML og CSS linjer, se dette afsnit.
Logo #
For at tilføje et logo til Omnisearch designet, sæt os_brand_logo til dit logos billed-URL.
Uendelig/auto load #
Vil du styre om Omni-search automatisk skal loade flere resultater, når brugeren scroller til sidste produkt, skal variablen sættes til true eller false.
Variablen hedder oftest os_autoload. Sæt den til false for at forhindre automatisk indlæsning af flere resultater.
Oversættelser #
Som standard er skabelonen på engelsk. Hvis du har en butik på et andet sprog, kan du oversætte textelementerne ved at ændre variablenes værdier.
Oversæt sorterings-knap variablerne i skabelonen sammen med de andre tekstvariabler.
Protip: Brug generativ AI (fx chatGPT) til at oversætte hele grupper af tekst ved at skrive “Oversæt disse variable-værdier fra engelsk til dansk. Returner hele koden så den kan copy/pastes for at erstatte eksisterende kode: PASTE_VARIABLES_HERE”
Styling #
For at ændre styling kan du konfigurere CSS-variabler.
Skabelonerne bruger CSS-variabler som har følgende struktur:
--variable_name: variable_value;
For mere tekniske brugere kan individuelle CSS-regler justeres for mere komplekse ændringer.
Farver #
De konfigurerbare farver kan identificeres og konfigureres i afsnittet under “Colors” CSS-kommentaren
/* Colors */
Skrifttyper #
Ligesom farver kan skrifttypen findes under /* Font */ kommentaren.
Typisk har den variablen:
--font-family: 'Kumbh Sans', sans serif;
Standarddesign #
Standarddesignet for Omnisearch inkluderer:
Variants dropdown support: Lader kunder vælge variantattributter (fx størrelse, farve) før tilføjelse til kurv.
Mængdevælger.
Indbygget Tilføj-til-Kurv-knap der giver Clerk.js besked, så analytics og merchandising forbliver synkroniseret.
Rent, veldudformet markup med tydelige kommentarer.
Centraliserede variabler for styling og adfærd, så man let kan justere farver, afstand, labels og almindelige indstillinger uden at ændre kernekoden.
Pricer slider facet for hurtig intervalfiltrering.
Klikbare forslag der straks udløser en søgning.
For udviklere #
Styling #
Designs består af et hovedlayout, CSS styling og et sæt sub-designs som kan refereres i hovedlayoutet.
Du kan redigere alle disse separat for Desktop og Mobil. Som standard bruger Omni-search samme HTML for alle skærmstørrelser, og bruger CSS til at være fuldt responsivt. Derfor har Mobil-fanen ingen kode fra start.
Om nødvendigt kan du lave et helt andet HTML-markup til Mobil, som kun bruges på små skærme.
I starten vil du nok kun justere få ting for at få designet til at matche dit brands look - Du kan altid redigere det senere.
HTML #
Dette er hovedlayoutet, der styrer placering af alle elementer. Det bruger Liquid som templating language.
I vores startdesigns er første sektion dedikeret til de mest almindelige ændringer, som sorteringslabels, valuta og diverse tekster du kan oversætte.
CSS #
Styling der injiceres med HTML og giver dig fuld kontrol over det visuelle på en samlet måde.
Tilgængelige sub-designs #
I Search kodeeditoren findes Available Designs and Components under hovedkodeområdet. Scroll ned for at finde og redigere en komponent. Brug fanerne over editoren til at skifte mellem desktop og mobil HTML/CSS.
Efter redigering af en komponent klik Save, og gå tilbage til hoveddesignet separat.
Eventuelle designs tilføjet her kan refereres i det overordnede layout. De fungerer som moduler der redigeres separat og tilføjes med deres ID og navn: {{@247373 - TopBarSearchForm}}
Du kan slette, duplikere og kopiere referencen til ethvert sub-design ved at klikke på de tre prikker.
For at redigere et sub-design, klik på dets Edit-ikon. Når du er færdig, klik Save & close for at vende tilbage til hovedlayout editoren.
Nogle elementer kræver specifikke identifikatorer, fx:
- Inputfeltet
id="clerk-omnisearch-input" - Indhold wrapper
id="clerk-omnisearch-content"
Når du vil tjekke dine ændringer, kan du gøre det ved at klikke på “Preview design” knappen.
De mest almindelige ændringer i design er disse:
Logo: Gå til TopBarSearchForm og udskift standardlogoet.
Skrifttyper: Justér dem om nødvendigt til at matche dit site.
Farver: Brug din brands farver hvor du vil fremhæve eller tilpasse f.eks. knapper og tags.
Knapper og tag-borders: Justér farve, radius, bredde mm.
Links: Hvis du har en specifik stil til links, kan det også redigeres.
Reaktive vs statiske dele #
Forståelsen af hvilke dele af Omnisearch der re-rendres pr. søgning – og hvilke ikke – er vigtig når du tilpasser designet.
Statiske dele rendres én gang når overlayet åbnes og berøres ikke ved næste søgning:
- Selve overlay-containeren (
clerk-omnisearch-overlay) - Search input-feltet (
#clerk-omnisearch-input) - Alt HTML i designet udenfor
#clerk-omnisearch-content– fx logo, luk-knap eller topbar
Inputfeltet er bevidst statisk. Re-rendering på hver tast vil forstyrre indtastningen og ødelægge oplevelsen.
Reaktive dele er alt indeni #clerk-omnisearch-content. Denne wrapper renderes igen ved hver søgning:
- Produktresultater
- Facets og filtre
- Kategorier, sider og forslag
- Resultattællere og sorteringskontrol
- Ingen-resultater beskeder
Vil du opdatere et element på query-skifte – fx et live resultattæller i header – skal det placeres indenfor #clerk-omnisearch-content. Skal det være stabilt mens brugeren skriver, placér det udenfor den wrapper.
Ingen resultater-tilstand #
Når en søgeforespørgsel ikke giver produkter, viser Omnisearch ikke automatisk en fallback — det styres i designet med Liquid.
Den anbefalede metode er at tjekke om produkter er tomme og derefter vise en fallback-slider og en tilpasset besked:
{% if products.length > 0 %}
<!-- Normale resultater -->
{% for product in products %}
<!-- product card -->
{% endfor %}
{% else %}
<!-- Ingen resultater fallback -->
<div class="clerk-no-results-message">
Ingen resultater for "{{ query }}" — her er populære valg i stedet:
</div>
<span class="clerk"
data-api="recommendations/popular"
data-limit="8"
data-template="@omnisearch-product-card">
</span>
{% endif %}
Du kan også bruge results.products.no_exact_match til at opdage, når Omnisearch viser fuzzy eller beslægtede resultater i stedet for præcise, og vise en relevant besked:
{% if results.products.no_exact_match %}
<div class="clerk-no-exact-match">
Ingen præcise resultater for "{{ query }}" — viser nærmeste matches:
</div>
{% endif %}
Begge mønstre kan kombineres. En typisk opsætning viser no_exact_match besked over resultaterne og fallback-slideren kun når products.length == 0.
Teksten i ingen-resultat beskeden er almindelig HTML i designet og kan derfor oversættes eller styles frit uden at ændre konfigurationen udenfor design editoren.
Overlaystruktur #
Når omnisearch startes, genereres et element med klassen clerk-omnisearch-overlay og injiceres nederst i body.
Her injiceres designet. Da vi har input-elementet som del af designet, er det nødvendigt med denne struktur for ikke at re-rendre input på hver indlæsning: Strukturen skal se sådan ud under overlayet:
<div>
<input type="text" id="clerk-omnisearch-input"/>
<div id="clerk-omnisearch-content">
Element!
</div>
</div>
Inputfelt #
For at finde inputfeltet skal det have identifikatoren clerk-omnisearch-input. Når trigger-elementet affyres, flyttes markørfokus til dette element, og eventuel query føjes til det for en sammenhængende oplevelse.
Content Wrapper #
Content-wrapperen er hvor det meste foregår. Den skal have identifikatoren clerk-omnisearch-content. Her skal facets, sliders og alt andet udover inputfeltet placeres.
Klasser #
Funktionalitet kan tilføjes til designet ved at tilføje bestemte klasser til elementer.
Luk-knap #
clerk-omnisearch-close
Når klassen sættes på et element, skjules overlayet.
Sortering #
clerk-omnisearch-sort
Finder sorterings-dropdowns og tilføjer lyttere til dem.
For at få et sorteringselement i designet, tilføj denne klasse til det valgte element, fx en dropdown. Elementet skal have formatet value:[desc|asc], altså værdien du vil sortere på, kolon og så desc eller asc.
Du kan evt. tilføje et data-sort-type hvis du vil sortere i kategorier eller sider.
Search Facet #
clerk-facet-search
Hvis der findes en facet search, laves en lytter og facets, der ikke matcher søgningen, skjules.
Når klassen er til stede på en webside, tjekker den for facet search elementer. Facet searches giver brugere mulighed for at søge i facetter. For at virke skal elementet have en tekstværdi.
Full Clear #
clerk-omnisearch-full-reset
Ved klik sletter elementer med denne klasse alle valgte facets og nulstiller søgningen.
Facets Clear #
clerk-omnisearch-facet-full-reset
Ved klik fravælges alle aktive facets i gruppen. Typisk på en “Ryd alt”-knap i facets, så brugeren let kan nulstille sine filtre.
Group Clear #
clerk-omnisearch-facet-group-reset
Ved klik fravælges alle child-elementer i gruppen.
For at tilbyde mulighed for at nulstille hele facet-grupper, kan et element gives denne klasse. Når elementet aktiveres (fx klik), fravælges alle i gruppen. For at virke, skal elementet have den ønskede gruppe som attribut data-facet-group.
Facet Clear #
clerk-omnisearch-facet-reset
Elementer med denne klasse skal fravælge et enkelt element med det givne gruppe/værdi-attributpar.
Denne klasse bruges, hvor et enkelt facet skal fravælges. Elementet skal have både data-facet-group og data-facet-value. Efter aktivering, fravælges kun det tilhørende facet.
Facet Click #
clerk-facet
Elementer med denne klasse behandles som valgt facet.
Alle facet skal have klassen samt data-facet-group og data-facet-value, så vi ved, hvad kunden trykker på.
Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.