Naar hoofdcontent

Multilingual Search

Clonable Multilingual Search

Clonable Multilingual Search voegt een snelle, meertalige zoekfunctie toe aan je WordPress- of WooCommerce-website.

De zoekwidget zoekt direct in de browser van de bezoeker en toont resultaten terwijl er getypt wordt. Op clones worden de zoekresultaten in de taal van de betreffende clone getoond, mits de bijbehorende JSON keys in de clone zijn toegevoegd.

Beta

Clonable Multilingual Search is momenteel een beta-functie. Gedrag, labels en instellingen kunnen in toekomstige versies nog wijzigen.

Hoe werkt de zoekfunctie?​

De plugin bouwt een zoekindex op van de geselecteerde content (berichten, pagina's, producten, taxonomieën en metadata). Deze index wordt via een API beschikbaar gesteld aan de zoekwidget.

In de browser doorzoekt de widget de index met behulp van fuzzy search. Daardoor worden ook resultaten gevonden bij kleine typefouten of gedeeltelijke zoektermen, zonder dat er voor iedere toetsaanslag een nieuw verzoek naar de server nodig is.

Belangrijke eigenschappen:

  • Direct resultaat — resultaten verschijnen tijdens het typen (vanaf 3 tekens).
  • Meertalig — op clones worden de resultaten getoond in de taal van de clone, mits de JSON keys zijn geconfigureerd.
  • WooCommerce-ondersteuning — voor producten worden ook SKU, prijs en voorraad meegenomen.
  • Optionele caching — wanneer je caching inschakelt, wordt de zoekfeed per taal gecachet zodat de zoekfunctie sneller blijft.
info

Caching staat standaard uit. Wanneer je Enable search results caching inschakelt, wordt de zoekfeed per taal opgeslagen: alle clones met dezelfde taal delen dan dezelfde gecachete index, waardoor één vertaalronde meerdere clones tegelijk bedient.

Inschakelen​

De instellingen voor de zoekfunctie vind je op het tabblad Multilingual Search. De instellingen zijn verdeeld over drie secties: General, Styling en Advanced.

  1. Open het tabblad Multilingual Search.
  2. Schakel Enable Clonable Multilingual Search in.
  3. Sla de instellingen op.

Zodra de functie is ingeschakeld, worden de front-end assets geladen en is de zoekwidget beschikbaar via een shortcode.

De widget plaatsen​

Plaats de zoekwidget op een gewenste locatie met de shortcode (klik om te kopiëren):

Deze shortcode kun je gebruiken:

  • op pagina's en in berichten;
  • in widgetgebieden;
  • binnen page builders;
  • op een zelfgekozen positie binnen je thema.
tip

Op de instellingenpagina staat een knop om de shortcode direct naar het klembord te kopiëren.

General​

Schakelt Clonable Multilingual Search in. Wanneer dit is ingeschakeld, wordt de zoekindex opgebouwd en worden zoekopdrachten op clones vertaald naar de taal van de clone.

Search widget shortcode​

Toont de shortcode waarmee je de zoekwidget op je website plaatst.

Search widget placeholder text​

Bepaalt de placeholdertekst in het zoekveld. De standaardwaarde is Search....

Enabled post types​

Selecteer de post types die in de zoekindex moeten worden opgenomen, bijvoorbeeld pagina's, berichten of WooCommerce-producten.

De velden voor included items, excluded items en taxonomieën worden pas beschikbaar nadat je hier minimaal één post type hebt geselecteerd.

Enabled taxonomies​

Selecteer welke taxonomieën (zoals categorieën en tags) in de zoekindex worden meegenomen.

Wanneer dit veld leeg blijft, worden automatisch alle taxonomieën meegenomen die aan de geselecteerde post types zijn gekoppeld.

Search results enabled item fields​

Bepaalt welke velden per resultaat worden getoond. Beschikbare velden zijn:

  • Thumbnail
  • Title
  • Description
  • SKU
  • Price
  • Stock

Wanneer er geen velden zijn geselecteerd, worden alle velden getoond. Velden die niet van toepassing zijn op een resultaat (bijvoorbeeld een prijs bij een blogartikel) worden automatisch verborgen.

info

De getoonde WooCommerce-prijzen zijn indicatief. De zoekfeed wordt opgebouwd zonder klantsessie, waardoor de prijs in de zoekresultaten kan afwijken van de prijs die een individuele klant uiteindelijk ziet.

Styling​

De vormgeving van de zoekwidget kan volledig worden aangepast.

Disable default search widget styling​

Wanneer ingeschakeld worden de standaard CSS-stijlen van de zoekwidget niet geladen. Gebruik dit wanneer je de widget volledig met eigen CSS wilt opmaken.

Enable custom search widget styling​

Wanneer ingeschakeld verschijnt er een CSS-editor waarmee je de standaardstijlen kunt overschrijven. Je wijzigingen worden opgeslagen in een apart bestand en hebben geen invloed op de standaard-stylesheet.

Custom search widget styling​

De CSS-editor waarin je eigen stijlen invoert. Deze editor is alleen zichtbaar wanneer Enable custom search widget styling is ingeschakeld. Bij een leeg veld wordt de standaard-CSS als uitgangspunt gebruikt.

Veelgebruikte CSS-klassen​

/* Buitenste wrapper van de widget */
.clonable-search-widget-wrapper {
}

/* Het zoekveld inclusief icoon */
.clonable-search-input-wrapper {
}

/* Eén resultaatrij */
.clonable-search-result-row {
}

/* Tekstgedeelte van een resultaat */
.clonable-search-result-text {
}
.clonable-search-result-title {
}
.clonable-search-result-meta {
}
.clonable-search-result-price {
}

/* Afbeelding van een resultaat */
.clonable-search-result-image {
}

/* Melding wanneer er geen resultaten zijn */
.clonable-search-no-results {
}

Advanced​

De geavanceerde instellingen bepalen welke content wordt opgenomen in de zoekindex en hoe de zoekfeed wordt verwerkt.

pas op

Wijzig deze instellingen alleen wanneer je begrijpt welke content je in de zoekresultaten wilt opnemen of uitsluiten.

Included items​

Beperkt de zoekindex tot specifieke items. Wanneer hier één of meer items zijn geselecteerd, worden uitsluitend die items in de index opgenomen.

Wanneer dit veld leeg blijft, worden alle items van de geselecteerde post types opgenomen.

Excluded items​

Sluit specifieke items uit van de zoekindex. Uitgesloten items worden nooit in de index opgenomen, ook niet wanneer ze tot de geselecteerde post types behoren of in de included items voorkomen.

Only show Clonable Multilingual Search on clones​

Wanneer ingeschakeld wordt de zoekwidget alleen op clones getoond en niet op de oorspronkelijke website.

Enable search results caching​

Schakelt de server-side caching van de zoekfeed in. Deze optie staat standaard uit. Wanneer ingeschakeld wordt de opgebouwde zoekfeed gecachet zodat de zoekfunctie sneller blijft; de cache heeft een levensduur van 1 week.

Zie Zoekcache beheren voor het handmatig verversen van de cache.

Include ALL meta fields in search feed​

Bepaalt hoeveel post meta in de zoekfeed wordt opgenomen. Standaard wordt alleen het metaveld clonable_search_terms meegenomen (zie Eigen zoektermen toevoegen).

Wanneer je deze optie inschakelt, worden alle post meta-velden in de zoekfeed opgenomen.

pas op

Het opnemen van alle meta-velden kan de omvang van de zoekfeed en het geheugengebruik fors verhogen. Schakel dit alleen in wanneer je dit echt nodig hebt.

JSON keys toevoegen in het Clonable dashboard​

De zoekwidget haalt de zoekindex op via een JSON-endpoint (/wp-json/clonable/v1/search). Om de zoekresultaten op clones goed te laten vertalen, moet deze JSON-structuur ook bekend zijn bij de vertaalengine van Clonable.

Voeg de volgende JSON-keys toe aan de JSON translations-instellingen van de clone (zie JSON translations):

  • clonable_search.posts.title
  • clonable_search.posts.short_description
  • clonable_search.posts.description_excerpt
  • clonable_search.posts.categories.title
  • clonable_search.posts.tags.title
  • clonable_search.posts.meta.clonable_search_terms
  • clonable_search.posts.attributes.**
tip

Deze keys vind je bij clone → Advanced settings → Json translations.

Eigen zoektermen toevoegen​

Je kunt per item extra zoektermen toevoegen waarop het item gevonden moet worden. Voeg hiervoor een post meta-veld toe met de naam clonable_search_terms en komma-gescheiden waarden:

term1, term2, term3

Deze termen worden meegenomen in de zoekindex en krijgen een hoog gewicht in de zoekresultaten.

Standaard is dit het enige meta-veld dat in de zoekfeed wordt opgenomen. Wil je meer meta-velden indexeren, gebruik dan de optie Include ALL meta fields in search feed.

Zoekcache beheren​

De zoekfeed kan worden gecachet zodat de zoekfunctie sneller blijft. Caching is opt-in: schakel hiervoor Enable search results caching in onder de sectie Advanced. Wanneer caching actief is, wordt de feed 1 week gecachet.

Na het wijzigen van content of instellingen kun je de cache direct verversen:

  1. Open het tabblad Multilingual Search.
  2. Ga naar de sectie Advanced.
  3. Klik onder Cache Management op Clear search cache.

De cache wordt vervolgens automatisch opnieuw opgebouwd bij het volgende bezoek aan de website.

info

De cache wordt ook automatisch vernieuwd nadat deze is verlopen (na 1 week). Handmatig verversen is vooral nuttig direct na het aanbrengen van wijzigingen.

Veelgestelde vragen​

Ik zie de zoekwidget niet​

Controleer het volgende:

  • of Enable Clonable Multilingual Search is ingeschakeld;
  • of de shortcode [clonable_search_widget] op de pagina is geplaatst;
  • of Only show Clonable Multilingual Search on clones niet onbedoeld is ingeschakeld terwijl je op de hoofdwebsite kijkt;
  • of een caching-plugin geen oude versie van de pagina serveert.

Waarom verschijnen er geen resultaten?​

Resultaten verschijnen vanaf 3 ingetypte tekens. Controleer daarnaast of er bij Enabled post types minimaal één post type is geselecteerd, zodat er content in de index aanwezig is.

Werkt de zoekfunctie met WooCommerce?​

Ja. Voor producten worden onder andere SKU, prijs, voorraad en productafbeeldingen meegenomen. Welke velden zichtbaar zijn, bepaal je via Search results enabled item fields. Houd er rekening mee dat getoonde prijzen indicatief zijn en per klant kunnen afwijken.

Worden zoekresultaten vertaald?​

Ja, mits de bijbehorende JSON keys in de clone zijn toegevoegd. Op clones worden de zoekresultaten dan getoond in de taal van de clone. Wanneer je bovendien Enable search results caching inschakelt, wordt de vertaalde index per taal gecachet, zodat alle clones met dezelfde taal er gebruik van maken.

Kan ik de vormgeving volledig aanpassen?​

Ja. Je kunt de standaardstijlen uitschakelen en met Enable custom search widget styling je eigen CSS toevoegen. De HTML-structuur en CSS-klassen van de widget zijn beschikbaar om volledig te overschrijven.

Mijn wijzigingen zijn niet zichtbaar in de zoekresultaten​

Wanneer Enable search results caching is ingeschakeld, wordt de zoekfeed gecachet. Klik onder Cache Management op Clear search cache om de wijzigingen direct door te voeren.

Laatst bijgewerkt op