Kiyoh reviews op website tonen

Wanneer je de Kiyoh koppeling hebt ingesteld onder Instellingen > Reviews, kun je de reviews ook tonen op je website. Daarvoor zijn vier kant en klare blokken beschikbaar die je op een pagina plaatst.

Welke blokken zijn er?

Blok Waar gebruik je het voor?
content-18 Bedrijfsreviews tonen als grid van drie kolommen, bijvoorbeeld op de homepage
content-38 Het gemiddelde reviewcijfer en het aantal reviews tonen, bijvoorbeeld bovenaan een pagina
content-reviews-01 Alle bedrijfsreviews tonen met paginering, bijvoorbeeld op een aparte reviewspagina
product-reviews-01 De reviews van één specifiek product tonen op de productpagina

Voor je begint

Zorg ervoor dat:

  • De Kiyoh koppeling aan staat onder Instellingen > Reviews (niet op Geen).
  • Voor bedrijfsreviews: de Hash is ingevuld.
  • Voor productreviews: de API key en Location ID zijn ingevuld én producten een artikelnummer hebben.

Zonder deze gegevens worden de blokken verborgen op de website. In de beheeromgeving (de iframepreview) zie je dan een waarschuwing met een link naar de instellingenpagina.

Hoe werkt het?

Een reviewblok plaatsen

  1. Open de pagina waar je de reviews wilt tonen.
  2. Klik op Blok toevoegen op de gewenste plek in de pagina.
  3. Kies één van de vier reviewblokken uit de lijst.
  4. Pas de teksten en instellingen aan (zie hieronder per blok).
  5. Klik op Sla wijzigingen op .

De instellingen van een reviewblok aanpassen

  1. Open de pagina waarop het blok staat.
  2. Klik op het blok om het te bewerken.
  3. Pas de instellingen aan.
  4. Klik op Sla wijzigingen op .

Een reviewblok verwijderen

  1. Open de pagina waarop het blok staat.
  2. Klik op het blok.
  3. Klik op Verwijderen.
  4. Bevestig de verwijdering.

Blok 1. content-18

Wat doet dit blok?

Toont een grid (drie kolommen op desktop) met de meest recente bedrijfsreviews. Per review zie je het cijfer in sterren, eventueel een korte oneliner, het reviewtekstje en de naam van de auteur. Onderaan staat een knop om alle reviews te bekijken.

Waar gebruik je het?

Bijvoorbeeld op de homepage of een over-onspagina, om vertrouwen te wekken.

Instellingen

  • Toon datum (Aanvinkbaar)
    Toon de datum waarop de review is geplaatst rechtsboven in elke reviewtegel.

  • Toon plaatsnaam (Aanvinkbaar)
    Toon de plaats van de auteur naast zijn of haar naam.

  • Toon aanbeveling (Aanvinkbaar)
    Toon of de klant het bedrijf zou aanbevelen (Ja/Nee). Alleen zichtbaar als de klant deze vraag heeft ingevuld.

Vereisten

  • Hash moet zijn ingevuld onder Instellingen > Reviews.

Blok 2. content-38

Wat doet dit blok?

Toont het gemiddelde reviewcijfer met sterren en het totaal aantal reviews. Een titel boven het blok kun je zelf invullen.

Waar gebruik je het?

Bijvoorbeeld bovenaan een pagina als korte samenvatting van je beoordelingen, of net onder een hero-afbeelding.

Instellingen

  • Titel (Tekst)
    De tekst die boven het reviewcijfer wordt getoond.

Vereisten

  • Hash moet zijn ingevuld onder Instellingen > Reviews.

Blok 3. content-reviews-01

Wat doet dit blok?

Toont alle bedrijfsreviews op één pagina, met paginering. Bedoeld voor een aparte reviewspagina (bijvoorbeeld de pagina /reviews).

Waar gebruik je het?

Op een aparte pagina waar bezoekers alle reviews kunnen doorlezen.

Instellingen

  • Aantal resultaten op een pagina (Numeriek, standaard 9)
    Bepaalt hoeveel reviews er per pagina worden getoond. Bezoekers kunnen vervolgens doorklikken naar de volgende pagina.

  • Toon datum (Aanvinkbaar)
    Toon de datum bij elke review.

  • Toon plaatsnaam (Aanvinkbaar)
    Toon de plaats van de auteur.

  • Toon aanbeveling (Aanvinkbaar)
    Toon of de klant het bedrijf zou aanbevelen.

Vereisten

  • Hash moet zijn ingevuld onder Instellingen > Reviews.

Blok 4. product-reviews-01

Wat doet dit blok?

Toont de reviews van het product dat de bezoeker bekijkt. Inclusief het gemiddelde cijfer, het totaal aantal reviews, een verdeling over 1 tot 5 sterren, en een lijst met de individuele reviews (met oneliner, omschrijving, datum en plaats).

Waar gebruik je het?

Op de productpagina, onder de productinformatie. Op andere pagina's werkt het blok niet, omdat er dan geen actief product is.

Instellingen

Dit blok heeft geen aanpasbare instellingen. Het toont automatisch maximaal 50 reviews per product om de pagina snel te houden.

Vereisten

  • API key en Location ID moeten zijn ingevuld onder Instellingen > Reviews.
  • Het product moet een artikelnummer hebben. Zonder artikelnummer kan Kiyoh het product niet herkennen.
  • De productreviews moeten al zijn opgehaald uit Kiyoh. Vraag je beheerder of de synchronisatie loopt als er nog geen reviews zichtbaar zijn.

Veelgestelde vragen

Controleer of:

  • De Kiyoh koppeling aan staat onder Instellingen > Reviews (niet op Geen).
  • De juiste velden zijn ingevuld (Hash voor bedrijfsreviews, API key en Location ID voor productreviews).
  • Voor productreviews: het product heeft een artikelnummer en de productreviews zijn opgehaald uit Kiyoh.
  • Er daadwerkelijk reviews bij Kiyoh staan.

Nee. Reviews worden tussentijds opgeslagen, zodat je website snel blijft. Deze opslag wordt automatisch ververst, meestal na een uur.


Het blok toont standaard 3 reviews. Dit aantal staat vast en kan niet via de beheeromgeving worden aangepast. Voor meer reviews op één pagina gebruik je het blok content-reviews-01 met paginering.


Deze waarschuwing verschijnt alleen in de beheeromgeving (de iframepreview) wanneer de Kiyoh koppeling nog niet is ingesteld. Klik op de waarschuwing om direct naar de instellingenpagina te gaan en de gegevens in te vullen. Bezoekers van de website zien deze melding niet. Voor hen is het blok dan gewoon verborgen.


Nee. Het blok werkt alleen binnen de context van een productpagina. Op andere pagina's is er geen actief product en wordt er niets getoond.


Als deze gegevens ontbreken, wordt dat onderdeel automatisch verborgen, ook als je de instelling Toon plaatsnaam of Toon aanbeveling hebt aangezet. Je hoeft hier zelf niets voor te doen.

Tips

Combineer een rating en een reviewgrid

Plaats het blok content-38 in de header of net onder de hero, en zet content-18 verderop op de pagina. Zo ziet de bezoeker eerst het cijfer en kan hij doorscrollen voor de details.


Maak een aparte reviewspagina

Gebruik blok content-reviews-01 op een aparte pagina (bijvoorbeeld /reviews). Verwijst de "Bekijk alle reviews" knop in content-18 dan naar je eigen archiefpagina, dan houd je bezoekers in je webshop in plaats van ze door te sturen naar Kiyoh.


Productreviews vereisen periodieke synchronisatie

Productreviews verschijnen pas op je website nadat ze zijn opgehaald uit Kiyoh. Vraag je beheerder of de periodieke synchronisatie is ingericht als je het blok product-reviews-01 plaatst.


Vul artikelnummers in

Productreviews werken alleen voor producten met een artikelnummer. Loop voor je het blok plaatst je productenlijst na en vul ontbrekende artikelnummers aan.