Een template bepaalt hoe een pagina, blok, header of footer eruitziet. Je maakt een template één keer en gebruikt het daarna op zoveel plekken als je wilt. Pas je het template aan, dan verandert elke plek waar het gebruikt wordt.

Een template aanmaken

  1. Ga naar Templates en kies Nieuw aanmaken.
  2. Vul de Naam in. Dat is de naam die je in de beheeromgeving ziet.
  3. Vul de CSS-identifier in. Gebruik alleen kleine letters, cijfers en koppeltekens, en begin met een letter. Met custom-banner krijgt het template de klasse .site-custom-banner.
  4. Kies het Type. Het type bepaalt op welke plekken je het template kunt kiezen.
  5. Schrijf de HTML en de CSS en bewaar je werk.

De typen

  • Header en Footer: de bovenkant en onderkant van elke pagina.
  • Pagina: de opmaak van één hele pagina.
  • Contentblok, Bannerblok, Call-to-action-blok, Mediablok, Formulierblok en Archiefblok: de opmaak van één blok in de inhoud van een pagina. Deze templates bevatten {{content}}.
  • Overzichtsblok: een lijst met items. Herhaal een element met data-repeat="items".
  • Formulier-e-mail: de opmaak van de e-mail die bij een formulier wordt verstuurd. Herhaal een rij met data-repeat="submission".

Slots

Een slot is een plek in de HTML die de site vult, zoals {{content}} of {{logo}}. Het paneel naast de editor laat zien welke slots bij het gekozen type horen. Slots werken alleen in tekst, niet in attributen zoals href of src.

  • Pagina: {{title}}, {{slug}}, {{hero}} en {{content}}.
  • Header: {{logo}}, {{navigation}} en {{search}}.
  • Footer: {{logo}} en {{navigation}}.
  • Overzichtsblok: {{intro}} en {{button}}.
  • Voor alle typen zijn de bedrijfsgegevens uit Website beschikbaar, zoals {{businessName}}, {{email}} en {{phone}}.

Voorbeeld: een paginatemplate met een kop, de hero, de inhoud en een footer. Alles tussen dubbele accolades is een slot; de rest is gewone HTML die op elke pagina hetzelfde blijft.

<article class="pagina">

<header class="pagina-kop">

<p class="merk">{{businessName}}</p>

<h1>{{title}}</h1>

</header>

{{hero}}

<div class="pagina-inhoud">

{{content}}

</div>

<footer class="pagina-voet">

<p>Vragen? Mail naar {{email}}</p>

</footer>

</article>

.pagina {

max-width: 40rem;

margin: 0 auto;

}

.pagina-kop {

padding-bottom: 1rem;

border-bottom: 1px solid var(--border);

}

.merk {

color: var(--primary);

font-size: 0.875rem;

font-weight: 600;

}

.pagina h1 {

margin: 0.25rem 0 0;

font-size: 2rem;

}

.pagina-inhoud {

padding: 1.5rem 0;

}

.pagina-voet {

padding-top: 1rem;

border-top: 1px solid var(--border);

font-size: 0.875rem;

}

Dummydata: {{businessName}} = Freestyler One, {{title}} = Gebruikers toevoegen, {{email}} = info@example.com. {{hero}} en {{content}} komen uit de tabs Hero en Inhoud van de pagina.

Een header met het logo en de navigatie:

<header class="kop">

{{logo}}

{{navigation}}

</header>

.kop {

display: flex;

flex-wrap: wrap;

align-items: center;

justify-content: space-between;

gap: 0.75rem 1.5rem;

padding: 1rem 1.5rem;

background: var(--primary);

color: var(--primary-foreground);

}

Dummydata: {{logo}} toont het logo uit Website (zonder logo de bedrijfsnaam Freestyler One), {{navigation}} de menu-items Admins en Beheerders uit Header.

Eigen velden

Met eigen velden maak je onderdelen van een template instelbaar voor elke plek waar het gebruikt wordt. Een veld heeft een naam, een label en een type: Tekst, Kleur, Afbeelding of Herhaalbare lijst. In de HTML of CSS gebruik je een veld met {{property-<naam>}}.

Je vult de waarde in bij het element dat het template gebruikt, zoals de pagina, het blok, de header of de footer.

Met data-if toon je een element alleen als een veld is ingevuld. Zet data-else op het element direct daarna om een alternatief te tonen.

Voorbeeld: een kaart met de eigen velden Titel en Intro. Is Intro leeg, dan toont de kaart een melding voor de redacteur:

<section class="kaart">

<h3>{{property-titel}}</h3>

<p class="intro" data-if="property-intro">{{property-intro}}</p>

<p class="intro intro--leeg" data-else>Voeg een introductie toe.</p>

</section>

.kaart {

padding: 1.25rem;

border: 1px solid var(--border);

border-radius: 0.75rem;

}

.kaart h3 {

margin: 0 0 0.5rem;

font-size: 1.125rem;

}

.intro--leeg {

color: var(--destructive);

font-style: italic;

}

Dummydata: Titel = Documentatie. Links is Intro ingevuld met “Welkom bij de documentatie.”, rechts is Intro leeg.

Een herhaalbare lijst maak je met een veld van het type Herhaalbare lijst en itemvelden. Zet data-repeat="<lijstnaam>" op het element dat herhaald moet worden. Daarbinnen toont {{item-<veldnaam>}} de waarde van elke rij.

Voorbeeld: een lijst Stappen met de itemvelden Titel en Tekst, gevuld met drie rijen:

<ol class="stappen">

<li data-repeat="stappen">

<strong>{{item-titel}}</strong>

<span>{{item-tekst}}</span>

</li>

</ol>

.stappen {

display: grid;

gap: 0.75rem;

list-style: none;

counter-reset: stap;

}

.stappen li {

position: relative;

display: grid;

padding: 0.875rem 1rem 0.875rem 3.25rem;

border: 1px solid var(--border);

border-radius: 0.75rem;

counter-increment: stap;

}

.stappen li::before {

content: counter(stap);

position: absolute;

top: 0.875rem;

left: 1rem;

display: grid;

place-items: center;

width: 1.5rem;

height: 1.5rem;

border-radius: 50%;

background: var(--primary);

color: var(--primary-foreground);

}

Dummydata: de lijst Stappen met drie rijen. Het li-element met data-repeat wordt per rij herhaald.

CSS schrijven

  • Schrijf gewone CSS. Gebruik :scope voor het buitenste element van het template.
  • De CSS geldt alleen voor dit template en de inhoud in zijn slots. Andere templates worden er niet door beïnvloed.
  • Gebruik var(--naam) voor de variabelen van de website, zoals var(--primary).
  • Gebruik @media voor verschillende schermbreedtes. Eigen velden gebruik je alleen in waarden, niet in selectors of @-regels.
  • Gebruik geen @import.

Voorbeeld: een melding met de eigen velden Titel, Tekst en Kleur. Op een breed scherm krijgt de melding meer ruimte:

<div class="melding">

<p class="melding-titel">{{property-titel}}</p>

<p>{{property-tekst}}</p>

</div>

.melding {

padding: 1rem 1.25rem;

border-left: 4px solid {{property-kleur}};

border-radius: 0.5rem;

background: var(--card);

}

.melding-titel {

color: {{property-kleur}};

font-weight: 600;

}

@media (min-width: 64rem) {

.melding {

padding: 1.5rem 2rem;

}

}

Dummydata: Kleur = #336699, Titel = Onderhoud gepland, Tekst = Zaterdag tussen 08:00 en 09:00 is de site niet bereikbaar.

Controleren en publiceren

Bekijk het template met Voorbeeld voordat je het publiceert. Met Bewaar concept sla je het op zonder dat het live gaat. Bezoekers zien de nieuwe opmaak pas na publiceren. Controleer het template op telefoon en op desktop.

Delen via de Bibliotheek

In de Bibliotheek deel je een template met andere sites, of kopieer je een template van een andere site. Templates openbaar of privé maken en bibliotheekbronnen beheren kan alleen met het recht Schrijven op de Bibliotheek. Dat recht hebben alleen administrators.