Collecties: complete handleiding

Samenvatting

Collecties zijn de manier om herhaalbare content te beheren in Mach3Blocks. Denk aan nieuwsberichten, blogs, teamleden, vacatures of producten. Je voert de data eenmalig in en toont die op meerdere plekken in je website. Wijzigingen worden zichtbaar nadat je de website publiceert, behalve bij externe data (die wordt bij elke paginalading ververst).

Dit artikel is de complete handleiding: van het aanmaken van een collectie tot het tonen op je website.

Hoe werkt het

Je vindt Collecties binnen een website, in het zijmenu (bovenste groep, naast Pagina's en Formulieren).

Een collectie kun je het beste zien als een tabel: elk item is een rij (bijv. één nieuwsbericht) en elk veld is een kolom (bijv. titel, datum of afbeelding). Pas je iets aan in een item, dan werkt dat door overal waar dat item wordt getoond — zodra je de website publiceert.

Veel collecties gebruiken ook een detailpagina. Dat betekent dat elk item naast een vermelding in een overzicht ook een eigen pagina krijgt. Die pagina's bouw je met een template: je maakt de opmaak één keer en die wordt automatisch gevuld met de inhoud van elk item.

Wanneer gebruik je dit

• Nieuws of blogs: een overzichtspagina, losse detailpagina's, en op de homepage alleen de nieuwste 3 berichten
• Teamleden: een teampagina met iedereen, en op projectpagina's een specifiek teamlid tonen
• Vacatures of producten: een overzicht met filtermogelijkheden en eventueel paginering

Voorwaarden

Om met collecties te werken heb je mogelijk de volgende rechten nodig:

• Collecties toevoegen, kopiëren en verwijderen
• Collectie-items toevoegen, kopiëren en verwijderen
• Collectie-items verplaatsen (alleen bij handmatige sortering)
• Collectietags beheren

Stappenplan

1) Een collectie aanmaken

1. Ga naar Website → Collecties en klik op Collectie toevoegen
2. Je hoeft alleen een naam in te vullen — de overige instellingen kun je later aanpassen
3. Je ziet vier tabbladen: Items, Velden, Tags en Imports

2) Velden bepalen

Velden bepalen welke informatie je per item kunt invullen.

1. Ga naar Velden → Veld toevoegen en kies een naam en type
2. Beschikbare veldtypes: Heading, Tekst, Nummer, Datum, Button, Afbeelding, Media, Mediacollectie en URL
3. Per veld kun je extra eigenschappen instellen:
   • Gebruik als itemnaam: dit veld wordt de "naam" van het item in overzichten
   • Verplicht: het item kan niet opgeslagen worden zonder dit veld in te vullen
   • Vertaalbaar: voor meertalige websites — je kunt de inhoud per taal invullen
   • Linkbaar: je kunt een link koppelen aan dit element

3) Items aanmaken en invullen

Ga naar Items → Item toevoegen. Het formulier voor een item heeft, afhankelijk van je collectie, tot acht tabbladen — naast Content, Link, SEO, Delen en Zichtbaarheid ook Menu's, Tags en Informatie (die verschijnen alleen als ze van toepassing zijn). De belangrijkste:

Tab: Content

Hier vul je de inhoud van het item in:

Tab: Link

Hier stel je in waar het item naartoe linkt als iemand erop klikt:

• Standaard: gebruik de standaard link uit de collectie-instellingen
• Link: kies een type (Pagina, Collectie-item, URL, Afbeelding, Video, Video-URL, Document, E-mailadres, Telefoonnummer) en vul de waarde in
• Link doel: Zelfde venster, Nieuw venster, Hoofd venster of Pop-in
• Aria label: een beschrijving voor schermlezers (voor toegankelijkheid)

Tab: SEO

Hier stel je in hoe het item verschijnt in zoekresultaten:

Tab: Delen

Hier stel je in hoe het item eruitziet als iemand het deelt op social media:

Tab: Zichtbaarheid

Hier bepaal je wanneer en waar het item zichtbaar is:

4) Collectie-instellingen

Klik op het instellingen-icoon van de collectie. De popup heeft zes tabbladen:

Tab: Algemeen

Als je Detailpagina inschakelt, maakt Mach3Blocks automatisch een template-pagina aan. Elk gepubliceerd item krijgt zijn eigen URL op basis van de collectie-URL + de slug van het item.

Tab: SEO

Tab: Zichtbaarheid (Menu's)

⚠️ "Items in menu" werkt niet in combinatie met externe data of items met een zichtbaarheidsdatum.

Tab: Data

Externe velden koppelen

Heb je bij Externe data een URL ingevuld (en staat Publieke data uit)? Dan verschijnt onderaan de Velden-lijst van de collectie een extra lijst Externe velden: de velden die wél in de externe bron staan, maar nog niet aan je collectie zijn toegevoegd. Voeg ze toe met Velden toevoegen (alle tegelijk) of per rij met Veld toevoegen. Daarna kun je die velden in de editor koppelen aan elementen in het overzicht en op de detailpagina.

Tab: Tags

Tags zijn labels die je aan items kunt toekennen. Via tags kun je filteren welke items zichtbaar zijn op de website of in een specifiek blok. Handig voor categorieën of onderwerpen.

Tab: Informatie

Toont wanneer de collectie is aangemaakt, door wie, en wanneer die voor het laatst is gewijzigd. Dit tabblad is alleen-lezen.

5) De detailpagina bouwen met Template

1. Klik rechtsboven op Template
2. Bouw de pagina op met blokken en koppel per element een collectieveld
3. Elementen worden automatisch onzichtbaar als het bijbehorende veld leeg is — zo ziet de pagina er altijd netjes uit

6) Collectie tonen op je website

1. Selecteer het hele blok in de editor (niet een element erin)
2. Klik rechtsboven op Collectie koppelen
3. Koppel per element een collectieveld
4. Filter eventueel op tags, stel een limiet in en bepaal hoeveel items per pagina worden getoond

7) Tags beheren en filteren

1. Tags maak je aan onder het tabblad Tags
2. Gebruik taggroepen om te filteren. Combinaties van taggroepen werken als "EN" (beide moeten kloppen)
3. Je kunt filteren op collectie-niveau (alle items vooraf filteren) of op blokniveau (per blok bepalen welke items worden getoond)

Het filter-element gebruiken

Wil je dat bezoekers je collectie-items zelf kunnen filteren op tags? Voeg dan een filter-element (of filter-blok) toe op de pagina waar je collectie staat. Het filter toont per taggroep de beschikbare tags als aanvinkbare opties; vinkt de bezoeker tags aan, dan worden de getoonde collectie-items daarop gefilterd.

• Het filter werkt samen met het collectieblok op dezelfde pagina — de tags komen automatisch uit de tags van die collectie.
• Zorg dus eerst dat je je collectie-items van tags hebt voorzien (zie hierboven).
• Op mobiel opent het filter als een uitklappaneel.

8) Paginering

1. Gebruik een Paginering-blok (te vinden in de categorie Filter in de blokbibliotheek)
2. Dit blok werkt altijd op het eerste collectieblok op de pagina

9) Importeren en exporteren

Importeren: via een URL of bestandsupload. De data moet JSON zijn in de juiste indeling; op het importscherm staat een link naar een voorbeeld-JSON die je als basis kunt gebruiken. Een import maakt altijd nieuwe items aan — bestaande items worden niet overschreven. Naast items kun je in één keer ook velden, tags, taggroepen, bestanden en mediacollecties meenemen. Vindt het systeem geen items, velden of tags in de data, dan krijg je de melding dat er niets is gevonden.

Import terugdraaien: een uitgevoerde import kun je terugdraaien. Alle items en bestanden van díe import worden dan verwijderd (de velden en tags blijven behouden). Let op: terugdraaien kan niet ongedaan worden gemaakt.

Limieten bij import: maximaal 500 items, 100 velden, 100 tags en 500 bestanden (maximaal 1 MB per bestand).

Exporteren: zet "Publieke data" aan in de collectie-instellingen en publiceer de website.

Veelgestelde vragen

Bekende beperkingen

• Wijzigingen zijn pas zichtbaar na publiceren (uitzondering: externe JSON-data ververst bij elke paginalading)
• "Items in menu" werkt niet met externe data of items met een zichtbaarheidsdatum
• Interne items en externe data kunnen niet gecombineerd worden in dezelfde collectie — externe data is alleen-lezen
• Paginering werkt alleen op het eerste collectieblok op de pagina

Veelvoorkomende problemen

• Wijzigingen niet zichtbaar: controleer of je de website hebt gepubliceerd
• Geen items getoond: check de tag-filters, zichtbaarheidsinstellingen en of items niet uitgeschakeld zijn
• Paginering werkt niet: zet het collectieblok dat je wilt pagineren als eerste op de pagina