Channels

Velden en structuur

Kies het juiste veldtype en bekijk wat vertaalbaar, vereist, uniek en versleuteld doen.

Doelgroep: Beheerder, OntwikkelaarVereiste toegang: Kanalen, DatamodelleringGecontroleerd op Taal: Nederlands

De structuur van een channel is de lijst velden die elk item invult. Je opent hem via Structuur bewerken in de werkbalk van het channel. Elk veld heeft een label voor redacteuren, een naam voor de API en een type.

Het scherm Structuur bewerken van het channel Date-time met de naam, de channelslug en de gegevensstructuur.Volledig formaat bekijken
Bij Structuur bewerken stel je de naam, de permalink of channelslug, de beschrijving en de velden van het channel in.

Het label mag je later gerust aanpassen. De veldnaam niet: die staat in je thema en in elke koppeling die de gegevens uitleest.

De veldtypes

TypeWaarvoor
stringKorte tekst op één regel, zoals een naam of een code
textLangere tekst over meerdere regels, met of zonder opmaak
emailEen e-mailadres
integerEen heel getal
floatEen getal met decimalen
booleanJa of nee, zoals een akkoord met de privacyverklaring
fileEén bestand, bijvoorbeeld een pdf
dateEen datum zonder tijdstip
timeEen tijdstip zonder datum
date_timeDatum en tijdstip samen
selectEén keuze uit een vaste lijst
multi_selectMeerdere keuzes uit een vaste lijst
calculatedEen waarde die uit andere velden volgt
belongs_toEen verwijzing naar één item in een ander channel
belongs_to_manyVerwijzingen naar meerdere items in een ander channel
customerEen verwijzing naar een klant of gebruiker
galleryEen reeks afbeeldingen met bijschriften en een eigen volgorde
geoEen locatie
jsonGestructureerde gegevens voor ontwikkelaars

Twijfel je tussen string en select, kies dan select zodra de antwoorden op een korte lijst passen. Dat scheelt later opruimwerk aan spelfouten en hoofdletters.

Een date bewaart alleen de dag, zoals 2026-09-01. Wil je ook een aanvangsuur, neem dan date_time of zet er een apart time-veld naast. Het demo-channel Date-time heeft alle drie de varianten naast elkaar staan.

Vertaalbaar, vereist, uniek en versleuteld

Vertaalbaar geeft het veld een aparte waarde per sitetaal. Het veld Name in het demo-channel X - Options staat zo ingesteld. Zet het aan voor tekst die bezoekers lezen, niet voor codes of getallen die in elke taal hetzelfde zijn.

Vereist betekent dat een item zonder die waarde niet bewaard wordt. Nimbu weigert dan het item en meldt precies welk veld ontbreekt. In het demo-channel Contact staan voornaam, naam, e-mail, telefoon en bericht allemaal op vereist.

Uniek betekent dat geen twee items dezelfde waarde mogen hebben. Probeer je toch een dubbele code te bewaren, dan krijg je een melding dat de waarde al bezet is. Handig voor referentienummers en artikelcodes.

Versleuteld slaat de waarde versleuteld op. In het demo-channel Contact staat het veld Name zo. Of je de inhoud in de admin te zien krijgt, hangt af van een site-instelling en van je rechten. Een export kan zo'n veld dus leeg laten.

Deze schakelaars zitten achter de veldinstellingen van elk veld. Welke ervan je te zien krijgt, hangt af van het type: versleuteling heeft bijvoorbeeld alleen zin bij tekst.

Keuzelijsten

Bij select en multi_select stel je zelf de opties in. Elke optie krijgt een naam die redacteuren zien en een slug die je thema gebruikt. Noem je een optie Bibendum Mattis, dan wordt de slug bibendum-mattis.

Bewaar het veld eerst en voeg daarna pas de opties toe. In het gegevensmodel van producten, dat op dezelfde manier werkt, verschijnt de link om een keuzemogelijkheid toe te voegen pas nadat het veld één keer bewaard is.

Je bepaalt ook de volgorde waarin de opties verschijnen. Verwijder een optie niet zolang items hem nog gebruiken: die items houden dan een waarde over waar niets meer bij hoort.

Verwijzingen tussen channels

Met belongs_to en belongs_to_many koppel je items aan een ander channel. Je kiest bij het veld naar welk channel het wijst.

Op de demo-site laat X - Cards zien hoe dat werkt. Het veld Filter 2 is een belongs_to naar X - Type 2: elk kaartje heeft precies één type. Het veld Filter 1 is een belongs_to_many naar X - Type: een kaartje kan er meerdere hebben.

Het voordeel is dat je de lijst met types op één plek beheert. Hernoem je een type, dan volgt elk kaartje dat ernaar wijst vanzelf.

Verwijzingen maken channels afhankelijk van elkaar

Zolang X - Cards naar X - Type wijst, kun je X - Type niet zomaar opruimen zonder de kaartjes te raken. Kijk bij twijfel eerst welke channels naar elkaar verwijzen.

Galerijvelden

Een gallery bewaart een reeks afbeeldingen als één veld. Elke afbeelding heeft een eigen plaats in de volgorde en kan een bijschrift krijgen. Het demo-channel X - Galleries heeft één titelveld en één galerijveld.

Gebruik gallery wanneer het aantal afbeeldingen per item verschilt. Voor precies één vaste afbeelding is file eenvoudiger.

Publicatiestatus

Sommige channels hebben velden voor publicatiestatus: een status met draft, published en scheduled, plus een moment waarop een item live gaat. Dat is een uitbreiding die per channel aan of uit staat. Bij een channel zonder die uitbreiding zijn de publicatievelden er niet en bewaart Nimbu elk item meteen als het is.

Zie je die velden niet en heb je ze nodig, vraag dan een beheerder of ze voor dit channel aan kunnen.