handleiding
Templating
Antlers: dubbele accolades, partials en tags. Genoeg om een site te bouwen, weinig genoeg om in een uur te leren.
Alles is een variabele
Wat je in de blueprint een handle hebt gegeven, staat in de template tussen dubbele accolades. Verder zijn er tags die zelf iets ophalen — content, navigatie, een formulier — en modifiers die een waarde onderweg bewerken.
De layout en de template
De layout is het omhulsel: html, head, header, footer. De template vult {{ template_content }}. Welke template een pagina gebruikt staat in de collectie, of per pagina in de zijbalk.
antlers
Een sectie renderen
Zo ziet het blok eruit dat de berichten op de homepage ophaalt. Er staat geen enkel bericht in vastgelegd.
resources/views/page_builder/posts.antlers.html
html
{{ collection:blog limit="{limit}" as="posts" }}
{{ if posts | length }}
<div class="grid gap-5 sm:grid-cols-2 lg:grid-cols-3">
{{ posts }}
{{ partial:components/post_card }}
{{ /posts }}
</div>
{{ else }}
<p>Nog geen berichten gepubliceerd.</p>
{{ /if }}
{{ /collection:blog }}
een blok toevoegen
Van idee naar sectie
Stel, je wilt een blok met een kaart erin. Dit is wat je doet.
-
01
Set in de blueprint
Voeg onder page_builder een set toe met een handle, een display en de velden die je nodig hebt.
-
02
Partial met dezelfde naam
Maak resources/views/page_builder/
.antlers.html. Meer registratie is er niet. -
03
Blok toevoegen in het Control Panel
De set staat meteen in de lijst. Invullen, opslaan, klaar.
spiekbriefje
Wat je het vaakst gebruikt
- {{ title }}
- Een veld van de huidige pagina
- {{ site:name }}
- Een waarde uit een global set
- {{ partial:components/button }}
- Een herbruikbaar stukje template
- {{ collection:blog limit="3" }}
- Content ophalen uit een collectie
- {{ nav:main }}
- Een menu, met is_current en children
- {{ glide:image width="800" }}
- Beeld op maat
- {{ date | iso_format("D MMMM YYYY") }}
- Een modifier op een waarde
- {{ if }} … {{ /if }}
- Voorwaarden, met elseif en else
Commentaar dat niemand ziet
Met {{# … #}} zet je een notitie in je template die niet in de HTML belandt. Handig om uit te leggen waaróm een blok is zoals het is.