Widget Configuratie

Deze gids behandelt het instellen en configureren van widgets in eKomi Reviews. Widgets laten u klantreviews overal op uw winkel tonen - sidebars, homepages, productpagina's, of elke CMS content. U kunt kiezen uit eenvoudige reviewlijsten tot complete sliders met autoplay en responsive breakpoints.

Locatie: Content → Widgets → Widget Toevoegen

---

Beschikbare Widget Types

De extensie biedt twee widget types:

Widget	Beste Voor
Ekomi Review Widget	Sidebars, kleine contentgebieden, eenvoudige reviewweergaven
Ekomi Slider Widget	Homepages, landingspagina's, full-width secties

---

Een Widget Toevoegen

1. Ga naar Content → Widgets
2. Klik op Widget Toevoegen
3. Selecteer Type: Kies "Ekomi Review Widget" of "Ekomi Slider Widget"
4. Selecteer Design Thema: Het thema van uw winkel
5. Klik op Doorgaan
6. Configureer de widget opties (zie secties hieronder)
7. Stel Layout Updates in om te bepalen waar de widget verschijnt
8. Klik op Opslaan

---

Ekomi Review Widget

Een flexibele reviewweergave met vier layout modes.

Weergave Modes

Mode	Beschrijving	Beste Voor
Sidebar	Volledige layout met header, reviewlijst en footer	Sidebars, brede contentgebieden
Small	Compacte weergave met logo en beoordeling	Kleine widgets, footer gebieden
Plain	Minimale tekstgebaseerde beoordelingsweergave	Inline content, minimalistische designs
Custom	Basis template voor aangepaste ontwikkeling	Thema aanpassingen

Configuratie Opties

Basis Instellingen

Optie	Beschrijving
Review Mode	Selecteer de weergave mode (Sidebar, Small, Plain, Custom)

Sidebar Mode Opties

Deze opties verschijnen wanneer Review Mode is ingesteld op "Sidebar":

Optie	Beschrijving	Aanbevolen
Reviews Weergeven	Toon individuele reviews of alleen samenvatting	Ja
Slider Weergeven	Schakel carousel in voor reviews (vereist Reviews Weergeven)	Ja voor 5+ reviews
Aantal Reviews	Hoeveel reviews te tonen	3-5
Reviews Filter	Sorteer op "Nieuwste Reviews" of "Hoogste Beoordeling"	Nieuwste Reviews

Wat Elke Mode Toont

Sidebar Mode:

• Accountnaam en logo
• Totaal aantal reviews en gemiddelde beoordeling
• Individuele reviews met commentaar, beoordeling en datum
• Optionele slider/carousel functionaliteit
• Link naar volledige reviewpagina

Small Mode:

• Compact logo
• Gemiddelde beoordelingsweergave
• Totaal aantal reviews
• Link naar reviewpagina

Plain Mode:

• Tekstgebaseerde beoordeling (bijv. "4,5 / 5,0")
• Totaal aantal reviews
• Minimale styling

Custom Mode:

• Basis template met gedocumenteerde variabelen
• Voor ontwikkelaars om aangepaste layouts te maken

---

Ekomi Slider Widget

Een complete reviews carousel met meerdere thema's en uitgebreide aanpassingsmogelijkheden.

Thema's

Thema	Beschrijving
Default	Standaard slider met nette presentatie
Extended	Verbeterde layout met quote styling en alternatief logo
Full Width	Beslaat de volledige breedte van de container

Configuratie Opties

Weergave Instellingen

Optie	Beschrijving	Aanbevolen
Thema	Visueel thema voor de slider	Passend bij uw site design
Titel	Koptekst boven de slider	"Klantreviews" of vergelijkbaar
Toon Samenvatting	Toon totaal reviews en gemiddelde beoordeling	Ja
Aantal Reviews	Totaal reviews om op te halen uit database	10-20
Reviews Filter	Sorteer op "Nieuwste Reviews" of "Hoogste Beoordeling"	Nieuwste Reviews

Slider Gedrag

Optie	Beschrijving	Aanbevolen
Reviews om te Tonen	Aantal reviews zichtbaar tegelijk	3-5
Reviews om te Scrollen	Hoeveel reviews vooruit per klik/swipe	1-3
Dots	Toon navigatie dots onder slider	Ja
Arrows	Toon links/rechts navigatie pijlen	Ja

Autoplay Instellingen

Optie	Beschrijving	Aanbevolen
Autoplay	Automatisch roteren door reviews	Ja voor homepages
Autoplay Snelheid	Milliseconden tussen slides (1000 = 1 seconde)	5000-7000

Responsive Instellingen

Optie	Beschrijving
Aangepaste Breakpoints	Schakel responsive breakpoint configuratie in
Aangepaste Breakpoints Waarde	Definieer hoeveel reviews tonen bij elke schermbreedte

Breakpoint Formaat: breedte=slides;breedte=slides;breedte=slides

Voorbeeld: 480=1;768=2;1024=3;1200=5

• Bij 480px en lager: Toon 1 review
• Bij 768px: Toon 2 reviews
• Bij 1024px: Toon 3 reviews
• Bij 1200px en hoger: Toon 5 reviews

---

Widget Plaatsing

Veelvoorkomende Plaatsingen

Locatie	Layout Update	Container
Homepage	CMS Home Page	Main Content Area
Alle Pagina's Sidebar	All Pages	Sidebar Main
Categorie Pagina's	Catalog Category	Sidebar of Content
Product Pagina's	Catalog Product View	After Main Content
Footer	All Pages	Footer

Layout Updates Instellen

1. Ga in het widget formulier naar Layout Updates
2. Klik op Layout Update Toevoegen
3. Configureer:
   • Weergeven op: Waar de widget moet verschijnen (Alle Pagina's, Specifieke Pagina's, etc.)
   • Container: Welke paginasectie (Sidebar, Main Content, Footer, etc.)

Voorbeeld: Homepage Slider

• Weergeven op: Specifieke Pagina → CMS Home Page
• Container: Main Content Bottom

Voorbeeld: Sidebar op Alle Pagina's

• Weergeven op: Alle Pagina's
• Container: Sidebar Main

---

Best Practices

Review Widget

✅ Gebruik Sidebar mode voor sidebars - Het is ontworpen voor smalle kolommen

✅ Schakel slider in voor 5+ reviews - Bespaart ruimte en voegt interactiviteit toe

✅ Toon 3-5 reviews - Genoeg om te overtuigen, niet overweldigend

✅ Gebruik "Nieuwste Reviews" filter - Toont uw meest recente feedback

❌ Gebruik niet te veel reviews - Lange lijsten zijn moeilijk leesbaar

❌ Vergeet mobiel niet - Test op kleine schermen

Slider Widget

✅ Gebruik op homepage - Geweldige eerste indruk met social proof

✅ Schakel autoplay in voor passief bekijken - Bezoekers zien reviews zonder te klikken

✅ Stel autoplay snelheid in op 5-7 seconden - Genoeg tijd om elke review te lezen

✅ Schakel zowel dots als arrows in - Sommige gebruikers klikken liever, anderen swipen

✅ Configureer responsive breakpoints - Zorg voor goede mobiele ervaring

✅ Gebruik "Extended" thema voor nadruk - Quote styling trekt aandacht

❌ Stel autoplay niet te snel in - Gebruikers kunnen reviews niet lezen als ze te snel wisselen

❌ Toon niet te veel tegelijk - 3-5 zichtbare reviews is optimaal

---

Responsive Configuratie

Voor de Slider Widget zorgt responsive design voor goede weergave op alle apparaten.

Aanbevolen Breakpoints

480=1;768=2;1024=3;1200=4

Dit betekent:

• Mobiel (≤480px): 1 review zichtbaar
• Tablet Portrait (768px): 2 reviews zichtbaar
• Tablet Landscape (1024px): 3 reviews zichtbaar
• Desktop (1200px+): 4 reviews zichtbaar

Responsiveness Testen

1. Voeg de widget toe met aangepaste breakpoints
2. Leeg cache: bin/magento cache:flush
3. Open uw winkel in een browser
4. Gebruik browser dev tools (F12) om verschillende schermformaten te testen
5. Verifieer dat reviews correct weergeven bij elk breakpoint

---

Probleemoplossing

Widget Wordt Niet Weergegeven

1. Controleer of widget is ingeschakeld - Bewerk widget, verifieer dat het correct is opgeslagen
2. Verifieer layout updates - Zorg dat container en paginaselectie correct zijn
3. Leeg cache - bin/magento cache:flush
4. Controleer op reviews - Widget heeft goedgekeurde reviews nodig om te tonen

Slider Werkt Niet

1. Controleer JavaScript console - Zoek naar fouten (F12 → Console)
2. Verifieer dat Slick library laadt - De slider vereist JavaScript
3. Controleer op conflicten - Andere sliders kunnen conflicteren

Reviews Worden Niet Getoond

1. Verifieer dat reviews bestaan - Controleer Marketing → eKomi → Reviews
2. Controleer review status - Alleen "Goedgekeurde" reviews worden getoond
3. Verifieer dat account is geselecteerd - In systeemconfig moeten accounts zijn geselecteerd

---

Aangepaste Ontwikkeling

De Custom mode in de Review Widget biedt een basis template met gedocumenteerde variabelen voor thema-ontwikkelaars.

Beschikbare variabelen:

• $block->getAccountsInfo() - Array van account data
• $block->getReviews() - Array van review data
• $block->getReviewsUrl() - Link naar volledige reviewpagina

Maak een aangepaste template in uw thema:

app/design/frontend/[Vendor]/[Theme]/Magmodules_EkomiSR/templates/widget/review/custom.phtml

---

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team