Samenvatting
Wil je een collectie tonen op een pagina van je website? Dan koppel je de collectie aan een blok in de editor. De items uit je collectie worden dan automatisch ingeladen in dat blok. Denk aan een productoverzicht, nieuwslijst of teamleden-sectie. In dit artikel lees je stap voor stap hoe dat werkt.
Hoe werkt het
Je selecteert een blok in de editor, klikt op Collectie koppelen, en verbindt de elementen in het blok (zoals tekst, afbeeldingen) aan de velden van je collectie. Je kunt ook filteren op tags, een maximum aantal items instellen, en paginering aanzetten.
Belangrijk om te weten:
- Selecteer altijd het hele blok (niet een element erin), anders is de knop "Collectie koppelen" niet beschikbaar.
- Je kunt dezelfde collectie op meerdere blokken en pagina's gebruiken, elk met eigen filters.
- Als je meerdere tags selecteert als filter, werken ze als EN-filter: alleen items die álle geselecteerde tags hebben worden getoond.
- Externe data die via de Data-tab aan een collectie is gekoppeld (bijvoorbeeld een JSON-feed), is alleen leesbaar — je kunt die data niet bewerken vanuit de editor.
Stappenplan
Stap 1: Voeg een geschikt blok in
Klik op de + knop om een blok toe te voegen. Kies een blok uit de blokbibliotheek dat geschikt is voor dynamische content — denk aan blokken in de categorie Products, News of Team.
Stap 2: Selecteer het hele blok
Klik op de linkerrand van het blok (buiten de content) zodat het hele blok geselecteerd is. Je herkent dit doordat de naam van het blok verschijnt in de koptekst van het rechter paneel (bijvoorbeeld "Sectie blok").
Stap 3: Klik op "Collectie koppelen"
Bovenaan het rechter paneel verschijnt een blauwe knop COLLECTIE KOPPELEN. Klik hierop.
Je kunt ook via het ⋮-menu (de drie puntjes) van het blok kiezen voor Collectie koppelen aan blok.
Stap 4: Stel de koppeling in
In de popup die opent:
- Kies de collectie die je wilt verbinden
- Koppel velden: verbind elk element in het blok aan een collectieveld (bijvoorbeeld: een tekstelement → "Item heading")
- Filter op tags (optioneel): toon alleen items met bepaalde tags
- Stel een limiet in: het maximale aantal items dat wordt getoond
- Items per pagina: hoeveel items per pagina zichtbaar zijn (voor paginering)
--alert variant:warning title:"Let op: dit gebeurt er met je items bij het koppelen"--
De elementen binnen ieder item worden gebaseerd op het eerste item van de collectie. Heb je in andere items afwijkende elementen toegevoegd of weggehaald, dan gaan die afwijkingen verloren. Ook de unieke opmaak per element (opmaakniveau Element) verdwijnt bij het koppelen. Zorg er dus voor dat je eerste item de opzet heeft die je voor álle items wilt gebruiken.
--/alert--
Stap 5: Opslaan en publiceren
Klik op Opslaan om de koppeling vast te leggen. De collectie-items zijn pas zichtbaar voor je bezoekers nadat je de website publiceert.
De collectie weer ontkoppelen
Wil je een blok weer losmaken van de collectie? Selecteer het blok en klik op Collectie ontkoppelen. Je krijgt de vraag "Weet je zeker dat je deze collectie wilt ontkoppelen?". Bevestig je dat, dan gebeurt er het volgende:
- Het blok behoudt de inhoud zoals die op dat moment uit de collectie werd getoond. Die wordt vastgezet als gewone (statische) inhoud in het blok, dus je raakt niets kwijt van wat er stond.
- Het blok werkt niet meer automatisch bij: wijzig je de collectie later, dan verschijnen die aanpassingen niet langer vanzelf in dit blok.
Kortom: na het ontkoppelen wordt het weer een "los" blok dat je zelf handmatig beheert.
Wanneer gebruik je dit
- Je wilt een collectie (nieuws, producten, teamleden) tonen op een pagina
- Je wilt verschillende subsets van dezelfde collectie tonen op verschillende pagina's
- Je wilt een limiet of paginering instellen voor het aantal getoonde items