Site search: installatie en gedrag

Site search draait in het ene embed-script van Nexym, hetzelfde script als de rest van de toolbox. Er komt geen tweede script bij. Onder Site search → Instellingen, in de groep Op de shop van het menu links, stel je bij Installatie in welk zoekvak hij overneemt en wat van je eigen zoekfunctie plaats moet maken, en bij Gedrag hoe de overlay zich gedraagt. Je bewaart met de opslagbalk onderaan; wijzigingen staan live bij de volgende paginaweergave.

Vroeger was dit het tabblad Embed. Een oude link of bladwijzer naar dat tabblad komt nu vanzelf uit op Instellingen → Installatie.

In het kort

Functie	Waar	Standaard en grenzen
Selector voor het zoekvak	Installatie → CSS-selector	input[type=search], input[name=q], input[name=s], input[name=search]. Meerdere met een komma
Eigen zoekfunctie herkennen (voor de A/B test)	Installatie → Huidige zoekfunctie, Je eigen resultatenpagina	Automatisch herkennen; resultatenpagina automatisch
Verberg elementen	Installatie → Verberg deze elementen, knoppen Voeg de gebruikelijke toe voor	leeg; hoogstens 20 selectors en 1000 tekens
Minimum aantal tekens	Installatie → Begin met zoeken na	2 (1 tot 6)
Openen bij focus	Gedrag → Open de overlay bij focus	aan (werkt alleen met het startscherm aan)
Bestaande zoekfunctie overnemen	Gedrag → Neem de eigen zoekfunctie van de shop over	aan
“In winkelwagen”-knop op de tegels	Gedrag → Toon ‘In winkelwagen’ in de zoekresultaten	aan bij een nieuw project; een bestaand project houdt zijn eigen stand
Gedeeld met andere modules	Gedrag → Verberg voor bots, Toon het nexym-merkje	Stel je één keer in voor alle modules, onder Beheer → Setup
Draait het?	Meten	Wanneer de tag voor het laatst gezien is en de laatste zoekopdracht

Selector zoekvak

Dit staat onder Instellingen → Installatie.

Instelling	Wat het doet	Standaard	Wanneer aanpassen
CSS-selector	Welk zoekveld (of welke zoekvelden) op je site Nexym overneemt. Een CSS-selector is een aanwijzing welk element op de pagina bedoeld is. Meerdere scheid je met een komma	input[type=search], input[name=q], input[name=s], input[name=search]	Als de overlay niet opent. Heeft je site een zoekveld in de header én een apart veld op mobiel, zet ze dan allebei in de lijst
Je eigen resultatenpagina	Alleen voor de A/B test: het adres van de zoekresultatenpagina van je shop	leeg (automatisch herkend: /search, /zoeken, catalogsearch/result, ?s=)	Als je shop een ander adres gebruikt. Vul een pad in, zoals /zoeken
Huidige zoekfunctie	Alleen voor de A/B test: met welke zoekfunctie groep A zoekt. Automatisch herkennen, een van de bekende zoekdiensten van derden uit de lijst, De zoekfunctie van het platform of Andere. Zie Hoe groep A gemeten wordt	Automatisch herkennen	Als de A/B test zegt dat groep A niet te meten is, of een verkeerde zoekfunctie noemt
Verberg deze elementen	De eigen zoek-onderdelen van je shop die plaats moeten maken, zoals een autocomplete-dropdown of een tweede mobiele zoeklaag. CSS-selectors, gescheiden door komma’s	leeg	Als er iets over of naast de overlay opent
Begin met zoeken na	Na hoeveel tekens er gezocht wordt (1 tot 6)	2	Zelden. Bij 1 doorzoekt elke bezoeker bij zijn eerste letter je hele catalogus

Begin met zoeken na geldt niet voor Volledig scherm · instant, en ook niet voor Volledig scherm zonder startscherm. Die zoeken altijd vanaf de eerste letter: dat is precies wat die indelingen zijn.

Verberg deze elementen

Onder het veld staan knoppen die de gebruikelijke selectors toevoegen voor de standaard autocomplete van je shopsysteem en voor veelgebruikte zoekextensies en zoekdiensten van derden. Onder het veld zie je meteen of de lijst klopt, bijvoorbeeld 3 selectors · geldig.

• Verbergen gebeurt met een stylesheet, niet door iets te verwijderen. Alleen zolang Site search op de pagina draait en een zoekveld heeft overgenomen. In testmodus alleen voor browsers met de debugger aan. Zet je de module uit, dan is alles terug.
• Geweigerd worden: ongeldige CSS, een selector zonder id, class of attribuut (die zou elk element van die soort verbergen), de pagina zelf (html, body), de hele header en de eigen elementen van Nexym. Hoogstens 20 selectors en 1000 tekens.
• In de debugger zie je op het tabblad Site search per selector hoeveel elementen hij op de huidige pagina raakt.

Gedrag

Dit staat onder Instellingen → Gedrag.

Instelling	Wat het doet	Standaard	Wanneer aanpassen
Open de overlay bij focus	De overlay opent al als iemand in het zoekveld klikt, anders pas bij de eerste letter	aan	Werkt alleen met het startscherm aan. Zonder startscherm is er niets te tonen voordat er iets getypt is
Neem de eigen zoekfunctie van de shop over	Je eigen formulier blijft staan, maar verstuurt niet meer. Je huidige zoekfunctie hoort het zoekvak niet meer: geen suggesties bij zijn eigen servers, geen zoekterm in het adres. In groep A van een A/B test blijft alles van je shop	aan	Bijna nooit uit. Uit betekent dat Enter nog naar je oude resultatenpagina gaat
Toon ‘In winkelwagen’ in de zoekresultaten	Een ronde winkelwagenknop op elke producttegel, en bij een product met maten de keuze in de tegel	aan bij een nieuw project	Uit als je bezoekers altijd via de productpagina wilt laten bestellen. Zie Producttegel
Verberg voor bots	Gedeeld met alle modules	—	Stel je in onder Beheer → Setup
Toon het nexym-merkje (“nexym Zoeken”)	Gedeeld met alle modules	—	Stel je in onder Beheer → Setup

In winkelwagen werkt op Magento 2, Shopware 6 en Shopify. Naast de schakelaar staat welk platform je shop is, uit je winkelkoppeling. Zonder winkelkoppeling herkent het script het platform op de pagina zelf. Zet je de knop de eerste keer aan, bouw dan de index één keer opnieuw op, zodat de producten hun winkel-id meekrijgen.

Opmerking

Je eigen zoekformulier blijft gewoon staan. Nexym haalt het niet weg. Het houdt alleen het versturen tegen en opent de overlay. Staat de module uit, of laadt het script niet, dan doet je oude zoekfunctie het weer zoals altijd.

Zoeken openen vanuit je eigen thema. Heeft je thema een los zoekicoon zonder zoekveld, laat dat dan window.NexymSearch.open() aanroepen. Met een zoekterm erbij (NexymSearch.open('ring')) zoekt het meteen; zonder opent het startscherm of een leeg zoekvak.

Draait het?

Onder Instellingen → Meten staat één regel: wanneer de tag voor het laatst op een van je domeinen gezien is, en wanneer de laatste zoekopdracht was. Handig om meteen na het live zetten te zien of de zoekfunctie echt gebruikt wordt. De aantallen (zoekopdrachten, klikken, nul resultaten) staan op Overzicht.

Opgepast

Een verkeerde selector is de meest voorkomende reden dat een goed geïnstalleerde zoekfunctie niets lijkt te doen. Controleer het met de knop Voorbeeld en met de debugger op je eigen site.