Element koppelen

Samenvatting

Je koppelt een element binnen een item aan een veld van de collectie.

Het element toont daarna de waarde van dat veld, per item.

Je kunt een element ook laten verdwijnen zodra dat veld bij een item leeg is.

Wanneer gebruik je dit?

Je gebruikt dit als een element de waarde van een collectieveld moet tonen, bijvoorbeeld de titel van een nieuwsbericht.

Je gebruikt het verbergen als een element alleen mag verschijnen bij items waar een veld gevuld is.

Hangt het blok nog niet aan een collectie, lees dan eerst Collectie koppelen.

Hoe werkt dit in Mach3Blocks?

Je selecteert een element binnen een item, en dus niet het hele blok.

Rechts staat dan het instellingenpaneel, met op het tabblad Instellingen twee keuzelijsten.

Keuzelijst Wat het doet
Collectieveld Vervangt de inhoud van het element door de waarde van dat veld in het item
Verbergen op veldwaarde Verbergt het element zodra het gekozen veld bij dat item leeg is

Beide keuzelijsten beginnen op Geen. Dat is de stand waarin elk element start.

Dit werkt in het blok op je pagina, en ook in de template van een detailpagina. Lees Detailpagina.

De keuzelijsten staan er alleen bij een gekoppeld blok

Hangt het blok niet aan een collectie, dan staan deze twee keuzelijsten er niet. Selecteer ook echt een element binnen een item, en niet het hele blok.

Welke velden je kunt kiezen

De eerste keuzelijst toont alleen de velden waarvan het type bij dat element past.

Elementsoort Veldtypes die je kunt kiezen
Heading en Handler Heading en Datum
Tekst Tekst
Nummer Nummer
Button Button
Media Media en Afbeelding; bij de eerste mediavariant alleen Afbeelding
Icoon Afbeelding
Iframe URL
Galerij Mediacollectie

Een ander element krijgt geen keuzelijst Collectieveld. Denk aan een box of een kolom.

Verbergen op veldwaarde werkt anders. Die keuzelijst toont altijd alle velden van de collectie.

Je kunt een element dus verbergen op een veld dat het element zelf niet kan tonen.

In de template van een detailpagina staat die tweede keuzelijst ook op het blok zelf. Zo verdwijnt een heel blok bij een leeg veld.

De inhoud van het element wordt vervangen

Wat je zelf in het element had gezet, verdwijnt zodra je een collectieveld kiest. Het element toont daarna per item de waarde uit de collectie.

Stappenplan

Een element aan een collectieveld koppelen

  1. Open de pagina of de template in de editor.
  2. Selecteer het element binnen een item.
  3. Ga in het instellingenpaneel naar het tabblad Instellingen.
  4. Kies bij Collectieveld het veld dat dit element moet tonen.
  5. Publiceer je website.

Een element verbergen bij een leeg veld

  1. Open de pagina of de template in de editor.
  2. Selecteer het element binnen een item.
  3. Ga in het instellingenpaneel naar het tabblad Instellingen.
  4. Kies bij Verbergen op veldwaarde het veld dat bepalend is.
  5. Publiceer je website.

Die laatste stap hoort er in beide gevallen bij. Lees Website publiceren.

Voorwaarden en rechten

Je hebt het recht Collecties toevoegen nodig om de twee keuzelijsten in te stellen.

De twee keuzelijsten staan er alleen bij een element binnen een blok dat aan een collectie hangt.

Voor het publiceren van je website heb je ook het recht Publiceren nodig.

De acht rechten die op een collectie werken, staan bij elkaar in Rechtenoverzicht.

Gevolgen en beperkingen

Onderdeel Wat ermee gebeurt
De inhoud van het element Wordt vervangen door de waarde van het veld in dat item
Alle items Krijgen dezelfde koppeling, niet alleen het item dat je op dat moment ziet
Een leeg veld Laat het element leeg, tenzij je Verbergen op veldwaarde hebt ingesteld
Hetzelfde element in een ander blok Kan een ander veld tonen, want de koppeling wordt per blok bewaard
Een collectie met een externe bron Toont in de keuzelijst de sleutel uit die bron in plaats van de veldnaam

Wat je op het eerste item instelt, geldt voor alle items van het blok. Lees Collectie koppelen.

Een wijziging staat pas op je website nadat je hebt gepubliceerd.

Als het niet lukt

Is de keuzelijst Collectieveld leeg, dan heeft de collectie geen veld van het passende type.

Maak dan zelf een veld van dat type aan. Lees Velden beheren.

Staat die keuzelijst er helemaal niet, dan kan dit soort element geen collectieveld tonen.

Kijk in de tabel hierboven welke elementsoorten dat wel kunnen.

Staat er geen enkele keuzelijst, dan hangt dit blok niet aan een collectie. Lees Collectie koppelen.

Het kan ook zijn dat je het hele blok hebt geselecteerd in plaats van een element erin.

Toont het element niets, controleer dan of het veld bij dit item gevuld is. Lees Items beheren.

Staan er sleutels in de keuzelijst in plaats van veldnamen, dan komt deze collectie uit een externe bron. Lees Externe data.