Flat-file-CMS voor front-endontwikkelaars
<TextField>
Een flat-file-CMS voor front-endontwikkelaars. Schrijf uw HTML, markeer een paar variabelen als bewerkbaar, en <TextField> geeft uw klant een dashboard voor de rest. Geen database, geen beheerthema om te leren.
<article>
<h2>{article_title}</h2>
{article_text}
</article>
<TextField> is anders.
Geen database, geen installatiewizard. <TextField> bewaart alles in gewone JSON-bestanden naast uw thema: installeren betekent een map kopiëren, verder niets.
U houdt de volledige controle over de markup. Bouw uw thema zoals u wilt en markeer daarna een handvol variabelen als bewerkbaar. Uw klant krijgt een dashboard voor teksten, afbeeldingen en inhoudsblokken, zonder ooit aan uw code te komen.
De documentatie hieronder is kort: na tien minuten lezen weet u hoe <TextField> werkt.
Installatie
Pak het archief uit en kopieer de volledige inhoud (de mappen core/, panel/, themes/, uploads/ en vendors/ en de .php-bestanden) naar de hoofdmap van uw project, en klaar: <TextField> is geïnstalleerd.
<TextField> bewaart zijn gegevens in .json-bestanden en heeft geen database nodig. Het draait op PHP 8.4.
Open ./panel/ op uw webserver. De eerste keer maakt u zelf het beheerdersaccount aan: gebruikersnaam, e-mail en wachtwoord (minstens 8 tekens). Er is geen standaardwachtwoord om te onthouden of later te wijzigen.
Om uw eigen thema te maken, voegt u in themes/ een map toe met minstens een index.html-template, en kiest u die in Instellingen › Systeem › Thema: de site wisselt van thema zodra u opslaat.
De gegevensstructuur opbouwen
De gegevens bestaan uit 2 soorten elementen:
- Statische inhoud, dat zijn losse velden. Voorbeeld: de beschrijving van de website.
- Collecties, dat zijn reeksen items. Voorbeeld: een portfolio. De items van een collectie hebben dezelfde velden.
Maak bij voorkeur een .json-bestand voor elk onafhankelijk deel van uw website, zo voorkomt u onnodig laden. Voorbeeld: het portfolio en de tekst over ons staan in home.json, de blog in blog.json.
Bestanden, velden en collecties maakt u aan in het paneel zolang de ontwikkelaarsmodus aan staat (Instellingen › Systeem).
Uw thema laden
Elke openbare pagina is een PHP-bestand in de hoofdmap. Open index.php: load(DATAS.'home') laadt het gegevensbestand core/data/home.json, en tpl::parse(THEMES.'index') toont de index.html-template van het actieve thema. Paden schrijft u zonder extensie. Vervang deze namen door de uwe en dupliceer de regel load() om meer dan één gegevensbestand te laden.
Voor een aparte pagina kopieert u index.php in dezelfde map, geeft u de kopie een andere naam en wijzigt u de bestanden die aan load() en tpl::parse() worden doorgegeven. Links tussen pagina’s roepen deze .php-bestanden in de hoofdmap aan.
Bouw in uw templates de paden naar de bestanden van het thema met {base_url} (het adres van de site) en {theme} (de map van het actieve thema, bijv. themes/mytheme/):
<link rel="stylesheet" href="{base_url}/{theme}css/main.css">
{include $theme.'header'}
Zo blijven uw paden werken, hoe de themamap ook heet, zelfs met herschreven adressen zoals /blog/article/3.
De gegevens invoegen
In het paneel staat onder elk veld en elke collectie de bijbehorende variabelenaam. Roep een variabele aan om de waarde te tonen: {about_text}. Deze vorm geeft de waarde ongewijzigd weer, HTML inbegrepen, precies wat u wilt voor een markdown- of editorveld. Gebruik voor platte tekst, een HTML-attribuut of elke waarde die een bezoeker heeft ingetypt {=about_text}, dat de HTML escapet.
Gebruik voor collecties de volgende syntaxis:
{item in $articles} <!-- "item" is a prefix to avoid conflicts, name it as you want -->
<h2>{=item_title}</h2>
{item_text}
{end}
Gebruik voor een voorwaarde deze syntaxis:
{if /*PHP syntax here, you have access to all the variables*/}
<!-- content -->
{elseif /*PHP syntax*/}
<!-- content -->
{else}
<!-- content -->
{end}
Nog een paar tags:
{include $theme.'header'}voegt een andere template in, zoals een gedeelde header of footer;{"Read more"}toont een tekst die door het taalbestand van het thema wordt vertaald (zie ‘Meertalige site’);{?echo date('d/m/Y');}voert pure PHP uit;{!toont een openingsaccolade zonder die te interpreteren, handig in een inline script of stylesheet.
<TextField> draait op de Templite-engine, die verderop op deze pagina een eigen (ook korte) documentatie heeft.
Extra inhoud
In een lus krijgt elk item automatisch een nummer, {item_id} (het voorvoegsel gevolgd door _id): de positie in de collectie, beginnend bij nul. In sortFlow() en filterFlow() heet datzelfde nummer id, dus $item['id'].
Sommige veldtypen maken extra variabelen aan, genoemd naar het veld:
- datum en tijd:
{date_formatted}, in de notatie die is ingesteld in Instellingen › Systeem, en de onderdelen{date_Y},{date_m},{date_d},{date_j},{date_F},{date_M}(plus_H,_ien_swanneer er een tijd is ingevuld); - afbeelding: de waarde wordt het pad
uploads/…, met{photo_width},{photo_height},{photo_alt}en, als er een miniatuur bestaat,{photo_thumb}; - bestand: de waarde wordt het pad
uploads/…; - tags: een lijst om te doorlopen,
{t in $item_tags}{t_name}{end}. De collectie krijgt ook de lijst van al haar tags met het aantal items:{t in $blog_tags}{t_name} ({t_items}){end}.
Elke pagina krijgt bovendien {base_url}, {theme}, {year}, {site_lang} en {site_languages}.
Om alle beschikbare variabelen en hun inhoud te zien, zet u Instellingen › Systeem › Thema › ‘Variabelenlijst’ aan: de lijst wordt als commentaar helemaal aan het einde van de broncode van elke pagina toegevoegd, alleen voor gebruikers die in het paneel zijn ingelogd. U kunt ook de regel #tpl::fix(); van een PHP-bestand in de hoofdmap uit het commentaar halen, maar dan ziet elke bezoeker de lijst.
Items sorteren en filteren
{prefix in sortFlow($flow, 'id')}...{end} sorts a flow by ascending id.
{prefix in sortFlow($flow, 'date', true)}...{end} sorts a flow by descending date.
{prefix in filterFlow($flow, fn($item) => $item['id'] <= 3)}...{end} selects the items whose id is 3 or less.
{prefix in sortFlow(filterFlow($flow, fn($item) => $item['id'] <= 3), 'id', true)}...{end} filters, then sorts the matching items.
{prefix in filterFlowByTag($flow, 'php')}...{end} keeps the items tagged "php".
Datums worden chronologisch vergeleken. De voorwaarde van filterFlow() schrijft u in PHP: $item bevat de velden van het item. filterFlowByTag() leest het veld tags (geef een andere naam door als derde parameter) en is niet hoofdlettergevoelig.
Meertalige site
Geef de talen van de site op in Instellingen › Systeem › Talen: de eerste is de standaardtaal. De optie ‘De voorkeurstaal van de browser van de bezoeker gebruiken’ kiest automatisch de taal van een nieuwe bezoeker.
Vertaalde teksten staan in een variant van het gegevensbestand, home.en.json naast home.json. Die bevat alleen de items die veranderen: al het andere (afbeeldingen, datums, instellingen) komt uit het standaardbestand. Het paneel maakt deze variant voor u aan door de pagina te kopiëren.
Teksten die in templates als {"Read more"} zijn geschreven, worden vertaald in themes/<theme>/lang/<code>.lang, één regel per tekst: "Read more" = "Lire la suite".
Voor een taalkiezer, en voor het attribuut <html lang="{site_lang}">:
{l in $site_languages}<a href="{l_url}"{if $l_active} aria-current="true"{end}>{l_label}</a>{end}Publiceren
Voordat u live gaat, in Instellingen › Systeem:
- Zet de ontwikkelaarsmodus uit om de gegevensstructuur te bevriezen: het paneel weigert dan bestanden, velden en collecties aan te maken, te hernoemen of te verwijderen.
- Zet de ‘Variabelenlijst’ uit en controleer dat er in uw PHP-bestanden in de hoofdmap geen regel
tpl::fix();uit het commentaar is gehaald. - Zet de cache aan en stel de duur in (overal 0: elke kopie blijft bewaard tot de cache wordt geleegd).
De cache bedient alleen anonieme bezoekers, met één kopie per adres en per taal. Elke keer dat u in het paneel opslaat, wordt hij geleegd, zodat uw wijzigingen meteen zichtbaar zijn. De knop ‘Publiceren’ leegt ook de gecompileerde templates en, als de bijbehorende optie aan staat, de miniaturen.
Templite
Templite is de PHP-template-engine van dit CMS. Hij weegt ongeveer 5 KB.
Hij houdt de gegevensverwerking uit uw HTML zonder dat u een nieuwe taal hoeft te leren. De tags worden naar gewone PHP gecompileerd, dus tussen uw template en de pagina die eruit komt zit bijna niets.
Variabelen, geneste lussen, voorwaarden, includes, vertalingen, een paginacache: alles wat u van een template-engine verwacht, en hij blijft snel.
Leesbare syntaxis
De tags zijn kort en passen in de HTML eromheen: een template leest een maand later nog net zo makkelijk.
Geneste blokken
Nest zoveel lussen als u nodig hebt. Elke lus krijgt een eigen prefix, zodat de variabelen van twee niveaus elkaar nooit in de weg zitten.
Voorwaarden
De variabelen zijn direct beschikbaar in het template: een voorwaarde is gewoon een PHP-expressie in een if-tag.
PHP-functies
Templates accepteren native PHP: haal een variabele door elke gewenste functie voordat u hem toont.
Vertalingen
Zet de vaste teksten van uw site in een taalbestand en Templite vult ze in bij het tonen. Een tekst zonder vertaling verschijnt zoals hij geschreven is.
Includes
Een template kan een ander template invoegen. Elk ingevoegd bestand wordt apart gecompileerd en bij de volgende aanroep hergebruikt.
Snelheid
Templite laadt in ongeveer 0,1 ms, compileert een groot template in minder dan 5 ms en toont het in zo’n 10 ms, zonder enige cache.
Paginacache
Anonieme bezoekers krijgen een gecachte kopie van elke pagina, één per adres (parameters inbegrepen) en per taal. In het paneel kiest u hoelang een kopie geldig blijft, en elke keer opslaan leegt de cache.
Leesbare code
De gecompileerde code is gewone PHP die u kunt openen, handig als een tag niet doet wat u verwachtte. Templite herschrijft uw paden nooit: bouw ze met {base_url} en {theme} en ze werken, hoe de themamap ook heet.
Debuggen
Zet in het paneel de variabelenlijst aan en elke pagina eindigt met een commentaar dat alle ontvangen variabelen en blokken opsomt. Alleen gebruikers die in het paneel zijn ingelogd zien het.
Automatisch hercompileren
Wijzig een template of een taalbestand en Templite compileert het bij het volgende verzoek opnieuw. Er hoeft niets met de hand geleegd te worden.
Vederlicht
Dit alles past in ongeveer 5 KB PHP, zonder commentaar.
<TextField> CMS kopen
Raadpleeg de licentieovereenkomst voor de volledige voorwaarden. Voor vragen over licenties, facturatie en veilig betalen kunt u schrijven naar support@textfield.org.
Eenmalige betaling, geen abonnement.
Pro
€199 incl. btw
U bent een team of ontwikkelaar en maakt websites voor uw klanten, of u biedt een gehoste webdienst op abonnementsbasis of een intranet aan.
- Onbeperkt: websites voor uw eigen klanten & projecten
- Onbeperkt: ontwikkelaars, domeinen & subdomeinen
- Volledige toegang tot de broncode
- Gratis updates van de huidige hoofdversie
- 50% korting op de volgende hoofdversie
- Technische ondersteuning per e-mail
- Niet inbegrepen: <TextField> doorverkopen als onderdeel van een product dat u verkoopt — zie OEM
OEM
€999 incl. btw
U verkoopt of verspreidt software, zoals een designtemplate, en levert <TextField> mee met de code van uw product.
- Distributierechten: integreer & lever <TextField> in een product (thema, starterkit, platform) dat u verkoopt of verspreidt
- Onbeperkt: eindklanten die uw product ontvangen
- Onbeperkt: ontwikkelaars, domeinen & subdomeinen
- Volledige toegang tot de broncode
- Gratis updates van de huidige hoofdversie
- 50% korting op de volgende hoofdversie
- Technische ondersteuning per e-mail
Veilig betalen via Stripe
- Visa
- Mastercard
- American Express
Wij zien en bewaren uw kaartgegevens nooit. Eenmalige betaling, ontvangstbewijs per e-mail.
Al klant? Download uw versie