Flat-File-CMS für Frontend-Entwickler

<TextField>

Ein Flat-File-CMS für Frontend-Entwickler. Schreiben Sie Ihr HTML, markieren Sie ein paar Variablen als bearbeitbar, und <TextField> gibt Ihrem Kunden ein Dashboard für den Rest. Keine Datenbank, kein Admin-Theme, das man lernen muss.

template.html
<article>
    <h2>{article_title}</h2>
    {article_text}
</article>

<TextField> ist anders.

Keine Datenbank, kein Installationsassistent. <TextField> speichert alles in einfachen JSON-Dateien neben Ihrem Theme: Installieren heißt, einen Ordner zu kopieren, mehr nicht.

Sie behalten die volle Kontrolle über das Markup. Bauen Sie Ihr Theme, wie Sie möchten, und markieren Sie dann eine Handvoll Variablen als bearbeitbar. Ihr Kunde bekommt ein Dashboard für Texte, Bilder und Inhaltsblöcke, ohne je Ihren Code anzufassen.

Die Dokumentation direkt darunter ist kurz. Nach zehn Minuten Lesen wissen Sie, wie <TextField> funktioniert.

Installation

Entpacken Sie das Archiv und kopieren Sie seinen gesamten Inhalt (die Ordner core/, panel/, themes/, uploads/ und vendors/ sowie die .php-Dateien) in das Stammverzeichnis Ihres Projekts. Das war’s: <TextField> ist installiert.

<TextField> speichert seine Daten in .json-Dateien und braucht keine Datenbank. Es läuft mit PHP 8.4.

Öffnen Sie ./panel/ auf Ihrem Webserver. Beim ersten Mal legen Sie das Administratorkonto selbst an: Benutzername, E-Mail und Passwort (mindestens 8 Zeichen). Es gibt kein Standardpasswort, das Sie sich merken oder später ändern müssten.

Für Ihr eigenes Theme legen Sie in themes/ einen Ordner mit mindestens einem index.html-Template an und wählen ihn unter Einstellungen › System › Design aus: Die Website wechselt das Theme, sobald Sie speichern.

Die Datenstruktur anlegen

Die Daten bestehen aus 2 Arten von Elementen:

  • Statische Inhalte, also einzelne Felder. Beispiel: die Beschreibung der Website.
  • Sammlungen, also Gruppen von Einträgen. Beispiel: ein Portfolio. Die Einträge einer Sammlung haben dieselben Felder.

Legen Sie am besten für jeden unabhängigen Teil Ihrer Website eine eigene .json-Datei an, um unnötiges Laden zu vermeiden. Beispiel: Das Portfolio und der Über-uns-Text liegen in home.json, der Blog in blog.json.

Dateien, Felder und Sammlungen werden im Panel angelegt, solange der Entwicklermodus aktiv ist (Einstellungen › System).

Das Theme laden

Jede öffentliche Seite ist eine PHP-Datei im Stammverzeichnis. Öffnen Sie index.php: load(DATAS.'home') lädt die Datendatei core/data/home.json, und tpl::parse(THEMES.'index') rendert das index.html-Template des aktiven Themes. Die Pfade werden ohne Dateiendung angegeben. Passen Sie diese Namen an Ihre an, und duplizieren Sie die Zeile load(), um mehr als eine Datendatei zu laden.

Für eine weitere Seite kopieren Sie index.php in denselben Ordner, benennen die Kopie um und ändern dann die Dateien, die an load() und tpl::parse() übergeben werden. Links zwischen den Seiten rufen diese .php-Dateien im Stammverzeichnis auf.

Bauen Sie in Ihren Templates die Pfade zu den Dateien des Themes mit {base_url} (die Adresse der Website) und {theme} (der Ordner des aktiven Themes, z. B. themes/mytheme/):

<link rel="stylesheet" href="{base_url}/{theme}css/main.css">
{include $theme.'header'}

So funktionieren Ihre Pfade unabhängig vom Namen des Theme-Ordners, auch mit umgeschriebenen Adressen wie /blog/article/3.

Die Daten einfügen

Im Panel steht unter jedem Feld und jeder Sammlung der passende Variablenname. Rufen Sie eine Variable auf, um ihren Wert anzuzeigen: {about_text}. Diese Schreibweise gibt den Wert unverändert aus, HTML inklusive, und das ist genau richtig für ein Markdown- oder Editor-Feld. Für reinen Text, ein HTML-Attribut oder jeden von einem Besucher eingegebenen Wert verwenden Sie {=about_text}, das HTML maskiert.

Für Sammlungen verwenden Sie folgende Syntax:

{item in $articles} <!-- "item" is a prefix to avoid conflicts, name it as you want -->
    <h2>{=item_title}</h2>
    {item_text}
{end}

Für eine Bedingung verwenden Sie diese Syntax:

{if /*PHP syntax here, you have access to all the variables*/}
    <!-- content -->
{elseif /*PHP syntax*/}
    <!-- content -->
{else}
    <!-- content -->
{end}

Noch ein paar Tags:

  • {include $theme.'header'} fügt ein anderes Template ein, etwa einen gemeinsamen Kopf- oder Fußbereich;
  • {"Read more"} gibt einen Text aus, den die Sprachdatei des Themes übersetzt (siehe „Mehrsprachige Website“);
  • {?echo date('d/m/Y');} führt reines PHP aus;
  • {! gibt eine öffnende geschweifte Klammer aus, ohne sie zu interpretieren, praktisch in einem eingebetteten Skript oder Stylesheet.

<TextField> läuft mit der Template-Engine Templite, die weiter unten auf dieser Seite eine eigene (ebenfalls kurze) Dokumentation hat.

Zusätzliche Inhalte

In einer Schleife erhält jeder Eintrag automatisch eine Nummer, {item_id} (das Präfix gefolgt von _id): seine bei null beginnende Position in der Sammlung. In sortFlow() und filterFlow() heißt dieselbe Nummer id, also $item['id'].

Manche Feldtypen erzeugen zusätzliche Variablen, benannt nach dem Feld:

  • Datum und Uhrzeit: {date_formatted} im unter Einstellungen › System festgelegten Format, sowie die Teile {date_Y}, {date_m}, {date_d}, {date_j}, {date_F}, {date_M} (dazu _H, _i und _s, wenn eine Uhrzeit eingegeben ist);
  • Bild: Der Wert wird zum Pfad uploads/…, mit {photo_width}, {photo_height}, {photo_alt} und, falls eine Miniatur existiert, {photo_thumb};
  • Datei: Der Wert wird zum Pfad uploads/…;
  • Schlagwörter: eine Liste zum Durchlaufen, {t in $item_tags}{t_name}{end}. Die Sammlung erhält außerdem die Liste aller ihrer Schlagwörter mit der Anzahl der Einträge: {t in $blog_tags}{t_name} ({t_items}){end}.

Jede Seite erhält außerdem {base_url}, {theme}, {year}, {site_lang} und {site_languages}.

Um alle verfügbaren Variablen und ihren Inhalt zu sehen, aktivieren Sie Einstellungen › System › Design › „Variablenliste“: Die Liste wird als Kommentar ganz am Ende des Quelltexts jeder Seite eingefügt, nur für im Panel angemeldete Benutzer. Sie können auch die Zeile #tpl::fix(); einer PHP-Datei im Stammverzeichnis entkommentieren, dann sieht aber jeder Besucher die Liste.

Einträge sortieren und filtern

{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".

Datumswerte werden chronologisch verglichen. Die Bedingung von filterFlow() wird in PHP geschrieben: $item enthält die Felder des Eintrags. filterFlowByTag() liest das Feld tags (übergeben Sie einen anderen Namen als dritten Parameter) und ignoriert Groß- und Kleinschreibung.

Mehrsprachige Website

Legen Sie die Sprachen der Website unter Einstellungen › System › Sprachen fest: Die erste ist die Standardsprache. Die Option „Bevorzugte Browsersprache des Besuchers verwenden“ wählt die Sprache eines neuen Besuchers automatisch.

Übersetzte Texte liegen in einer Variante der Datendatei, home.en.json neben home.json. Sie enthält nur die Einträge, die sich ändern: Alles andere (Bilder, Datumsangaben, Einstellungen) kommt aus der Standarddatei. Das Panel legt diese Variante für Sie an, indem es die Seite kopiert.

Texte, die in Templates als {"Read more"} geschrieben sind, werden in themes/<theme>/lang/<code>.lang übersetzt, eine Zeile pro Text: "Read more" = "Lire la suite".

Für einen Sprachumschalter und für das Attribut <html lang="{site_lang}">:

{l in $site_languages}<a href="{l_url}"{if $l_active} aria-current="true"{end}>{l_label}</a>{end}

Veröffentlichen

Vor dem Livegang unter Einstellungen › System:

  1. Schalten Sie den Entwicklermodus aus, um die Datenstruktur einzufrieren: Das Panel verweigert dann das Erstellen, Umbenennen oder Löschen von Dateien, Feldern und Sammlungen.
  2. Schalten Sie die „Variablenliste“ aus und prüfen Sie, dass in Ihren PHP-Dateien im Stammverzeichnis keine Zeile tpl::fix(); entkommentiert ist.
  3. Schalten Sie den Cache ein und legen Sie seine Dauer fest (überall 0: Jede Kopie bleibt erhalten, bis der Cache geleert wird).

Der Cache bedient nur anonyme Besucher, mit einer Kopie pro Adresse und pro Sprache. Jedes Speichern im Panel leert ihn, sodass Ihre Änderungen sofort sichtbar sind. Die Schaltfläche „Veröffentlichen“ leert außerdem die kompilierten Templates und, wenn die entsprechende Option aktiv ist, die Miniaturen.

Templite

Templite ist die PHP-Template-Engine dieses CMS. Sie wiegt etwa 5 KB.

Sie hält die Datenverarbeitung aus Ihrem HTML heraus, ohne dass Sie eine neue Sprache lernen müssen. Die Tags werden zu einfachem PHP kompiliert, zwischen Ihrem Template und der fertigen Seite steht also kaum etwas.

Variablen, verschachtelte Schleifen, Bedingungen, Includes, Übersetzungen, ein Seiten-Cache: Sie finden, was man von einer Template-Engine erwartet, und sie bleibt dabei schnell.

Lesbare Syntax

Die Tags sind kurz und fügen sich in das umgebende HTML ein. Ein Template lässt sich auch einen Monat später noch gut lesen.

Verschachtelte Blöcke

Verschachteln Sie so viele Schleifen, wie Sie brauchen. Jede Schleife hat ihr eigenes Präfix, die Variablen zweier Ebenen kommen sich nie in die Quere.

Bedingungen

Die Variablen stehen direkt im Template zur Verfügung. Eine Bedingung ist einfach ein PHP-Ausdruck in einem if-Tag.

PHP-Funktionen

Templates akzeptieren natives PHP: Schicken Sie eine Variable durch eine beliebige Funktion, bevor Sie sie ausgeben.

Übersetzungen

Legen Sie die festen Texte Ihrer Website in eine Sprachdatei, Templite setzt sie bei der Ausgabe ein. Ein Text ohne Übersetzung erscheint so, wie er geschrieben wurde.

Includes

Ein Template kann ein anderes einbinden. Jede eingebundene Datei wird separat kompiliert und beim nächsten Aufruf wiederverwendet.

Tempo

Templite lädt in etwa 0,1 ms, kompiliert ein großes Template in unter 5 ms und gibt es in rund 10 ms aus, ganz ohne Cache.

Seiten-Cache

Anonyme Besucher erhalten eine zwischengespeicherte Kopie jeder Seite, eine pro Adresse (Parameter inklusive) und pro Sprache. Wie lange eine Kopie gilt, legen Sie im Panel fest, und jedes Speichern leert den Cache.

Lesbarer Code

Der kompilierte Code ist einfaches PHP, das Sie öffnen können. Praktisch, wenn ein Tag nicht tut, was Sie erwartet haben. Templite schreibt Ihre Pfade nie um: Bauen Sie sie mit {base_url} und {theme}, dann funktionieren sie unabhängig vom Namen des Theme-Ordners.

Debugging

Schalten Sie im Panel die Variablenliste ein, und jede Seite endet mit einem Kommentar, der alle erhaltenen Variablen und Blöcke auflistet. Nur im Panel angemeldete Benutzer sehen ihn.

Automatisches Neukompilieren

Ändern Sie ein Template oder eine Sprachdatei, und Templite kompiliert sie bei der nächsten Anfrage neu. Von Hand ist nichts zu leeren.

Federleicht

All das passt in etwa 5 KB PHP, ohne Kommentare.

<TextField> CMS kaufen

Die vollständigen Bedingungen finden Sie im Lizenzvertrag. Bei Fragen zu Lizenzen, Rechnungen und sicherer Zahlung schreiben Sie an support@textfield.org.
Einmalzahlung, kein Abonnement.

Pro

€199 inkl. MwSt.

Sie sind ein Team oder Entwickler und erstellen Websites für Ihre Kunden, oder Sie bieten einen gehosteten Webdienst im Abonnement oder ein Intranet an.

  • Unbegrenzt: Websites für Ihre eigenen Kunden & Projekte
  • Unbegrenzt: Entwickler, Domains & Subdomains
  • Vollständiger Zugriff auf den Quellcode
  • Kostenlose Updates der aktuellen Hauptversion
  • 50 % Rabatt auf die nächste Hauptversion
  • Technischer Support per E-Mail
  • Nicht enthalten: <TextField> in einem Produkt weiterzugeben, das Sie verkaufen — siehe OEM
Pro kaufen

Sichere Zahlung über Stripe

  • Visa
  • Mastercard
  • American Express

Wir sehen und speichern Ihre Kartendaten nie. Einmalzahlung, Beleg per E-Mail.

Schon Kunde? Ihre Version herunterladen