← Terug naar de documentatie

Naslag van de Templite-syntaxis

Templite is de template-engine van <TextField>, en hij is met opzet klein. Er is geen aparte taal om te leren. Elke tag wordt rechtstreeks naar PHP gecompileerd en het gecompileerde bestand wordt gecachet: er wordt één keer per wijziging geparst, niet bij elk verzoek.

Een variabele toont u met accolades: {title}. Een collectie doorloopt u met een "in"-clausule: {item in $articles} ... {end}. "item" is een prefix naar keuze, om botsingen met andere lussen op dezelfde pagina te voorkomen; binnen de lus wordt elk veld {item_title}, {item_date} enzovoort. Elk item krijgt ook automatisch {item_id}, zijn positie in de collectie, vanaf nul geteld.

Voorwaarden lezen als gewone PHP: {if $count > 3} ... {elseif $count == 0} ... {else} ... {end}. De voorwaarde wordt echt als PHP uitgevoerd, dus elke expressie die u in een normale if-instructie zou zetten werkt hier ook, functieaanroepen inbegrepen.

Blijven er twee tags over. {include 'themes/mytheme/header'} voegt een ander templatebestand in; zo delen pagina’s een kop- en voettekst. En {?willekeurige php} schakelt over naar ruwe PHP voor de zeldzame gevallen waarin een tag niet volstaat, zoals een eenmalige berekening die u niet naar een controllerbestand wilt verhuizen alleen om één waarde te tonen.

Alles wordt gecompileerd naar een gewoon .php-bestand onder core/tmp/, dus u kunt een gecompileerd template openen en precies zien wat er van uw tags is geworden. Als een lus niet doet wat hij moet doen, is dat meestal de snelste weg: laat de theorie even zitten en lees de gegenereerde foreach.

Gebruik voor HTML-attributen en elke tekst die een bezoeker typt liever {=title}: de waarde wordt dan voor HTML ge-escaped.