CMS: Over het weergeven van verzamelingsinhoud in een repeater

Een repeater is een element dat meerdere items weergeeft in dezelfde indeling. Je maakt de indeling die jij wilt. Vervolgens gebruikt elk repeater-item dezelfde indeling om verschillende inhoud weer te geven. Repeater-items fungeren als containers waarin je andere elementen bevestigt. Elke wijziging die je aanbrengt in een element dat onder een repeater valt, wordt automatisch overgenomen in alle andere elementen.

Je kunt repeaters gebruiken om statische inhoud weer te geven, wat betekent dat je handmatig de inhoud voor elk element in elk item in de Editor bepaalt. 

Je kunt ook dynamisch inhoud uit je CMS-verzamelingen weergeven door je repeater en de bijbehorende elementen te koppelen aan een dataset. De repeater bevat dan één item voor elk item in je verzameling, waarbij elk repeater-item dezelfde template gebruikt, maar andere inhoud weergeeft. Je bepaalt het aantal items dat tegelijk wordt weergegeven in de datasetinstellingen.

Stel dat je een receptenwebsite hebt waar je al je recepten in een verzameling bewaart. De verzamelingsvelden (kolommen) slaan de naam, foto, cursus en keuken van elk gerecht op. Elk item (rij) vertegenwoordigt een gerecht (zie afbeelding hieronder). 

Je hebt al een dynamische itempagina die informatie over elk afzonderlijk recept weergeeft. Nu kun je een repeater koppelen aan een dataset die koppelt aan je verzameling. Als gevolg hiervan geeft de repeater informatie uit je verzameling weer in elk repeater-item (zie afbeelding hieronder). Bezoekers kunnen op de afbeelding van een gerecht klikken en naar de dynamische itempagina van dat gerecht gaan om er alles over te lezen. 

Kies in het Toevoegen-paneel in je Editor een repeater-ontwerp en voeg het toe aan je pagina. Je kunt de grootte van de repeater aanpassen, de plaatsing van elementen in elk item aanpassen en meer elementen toevoegen indien nodig. De wijzigingen die je aanbrengt in één repeater-item worden automatisch bijgewerkt in elk repeater-item om het ontwerp consistent te houden. 

Datasets koppelen de inhoud van je verzameling aan elementen op je pagina. Koppel de repeater aan een dataset koppelt en kies vervolgens welke velden bij elk element in je repeater horen. Elk gekoppelde element in je repeater past de grootte en inhoud ervan automatisch aan om de inhoud van je verzameling weer te geven. 

Je kunt de achtergrondafbeelding van de items van je repeater ook koppelen aan een afbeeldingsveld in je verzameling. De achtergrond van elk repeater-item geeft vervolgens dynamisch de achtergrondafbeelding van het relevante verzamelingsitem weer. 

In de instellingen van de gekoppelde dataset kun je het maximum aantal weergegeven items bepalen. Je kunt ook filters toevoegen om bepaalde items uit te sluiten en sorteervoorwaarden toevoegen om de volgorde waarin items worden weergegeven te bepalen. Lees meer over het toevoegen en instellen van datasets. 

Voeg navigatie-elementen toe aan je pagina zodat bezoekers erop kunnen klikken om meer items te laden, naar de volgende dynamische pagina te gaan, en/of andere dataset-klikacties. 

Je kunt navigatieknoppen maken door afbeeldingen of knoppen te koppelen aan dezelfde dataset die gekoppeld is aan je repeater. Kies vervolgens de relevante Klikken is gekoppeld aan-optie uit de datasetinstellingen (zoals Meer laden, Volgende pagina, Volgend item). In de datasetinstellingen bepaalt het Maximum aantal weergegeven items-veld het maximum aantal items dat tegelijk kan worden geladen.

Repeaters kunnen ook gerelateerde items weergeven uit verzamelingen die verwijzingsvelden bevatten of in situaties waarin je een dataset met een andere dataset hebt gefilterd. Hiermee kun je 'master-detail'-presentaties maken, waarbij elk repeater-item als de 'master' fungeert. Bekijk het artikel hier voor enkele ideeën over het maken van hoofddetailpagina's.