Zum Inhalt springen

Dateibasierte Seiten erstellen

Traditionell werden WordPress-Seiten im Block-Editor erstellt: Blöcke ziehen, Einstellungen konfigurieren und auf „Speichern“ klicken. Das funktioniert für Kunden, die ihre eigenen Seiten erstellen, verursacht aber Probleme für Entwickler, die strukturierte, versionskontrollierte Seiten erstellen. Das Seitenlayout liegt in der Datenbank statt im Code. Du kannst es weder in einem Pull Request prüfen noch mit git zurücksetzen oder auf einer frischen Installation reproduzieren.

Die dateibasierten Seiten von Blockstudio lösen dieses Problem. Du definierst Seiten als Dateien in deinem Theme, schreibst HTML-Vorlagen, die in WordPress-Blöcke umgewandelt werden, und steuerst genau, was Kunden bearbeiten dürfen. Ein expliziter Befehl synchronisiert diese Dateien mit normalen WordPress-Beiträgen; deine Vorlagen bleiben die maßgebliche Quelle.

Diese Anleitung führt dich durch die Erstellung von Seiten von Grund auf. Sie konzentriert sich besonders auf Sperren und Bearbeitungssteuerungen, die dateibasierte Seiten für Kundenprojekte praktikabel machen.

Deine erste Seite

Erstelle einen Ordner pages in deinem Theme und füge dann einen Unterordner mit zwei Dateien hinzu:

Code
theme/
└── pages/
    └── about/
        ├── page.json
        └── index.php
JSON
{
  "name": "about",
  "title": "About Us",
  "postStatus": "publish"
}
HTML
<h1>About Us</h1>
<p>We build things for the web.</p>

Führe den Befehl zur Seitensynchronisierung aus:

Shell
wp bs pages sync

Blockstudio parst HTML in WordPress-Blöcke und erstellt eine Seite namens „About Us“ mit dem Slug about. Öffne sie im Editor. Dort siehst du eine Überschrift und einen Absatz, genau so, als hättest du sie manuell hinzugefügt.

Bearbeite index.php, ändere den Text und führe den Befehl erneut aus. Lade den Editor neu, um die Änderung zu sehen. So sieht der Ablauf aus: HTML schreiben, gezielt synchronisieren, Blöcke erhalten.

Die Vorlagensprache

Der Blockstudio-Parser von HTML wandelt standardmäßige HTML-Elemente in WordPress-Blöcke um. Schreib ein <p> und du erhältst einen Absatzblock. Schreib ein <h2> und du erhältst einen Überschriftenblock. Die Zuordnung ist intuitiv:

HTML Block
<p> Absatz
<h1> bis <h6> Überschrift (Ebene entspricht dem Tag)
<ul>, <ol> Liste
<blockquote> Zitat
<img> Bild
<div>, <section> Gruppe
<hr> Trennlinie
<details> Details
<table> Tabelle

Für Blöcke ohne direktes HTML-Pendant verwendest du das Element <block> mit einem name-Attribut:

HTML
<block name="core/cover" url="https://example.com/hero.jpg">
  <h2>Hero Title</h2>
  <p>Content over the background image.</p>
</block>

<block name="core/spacer" height="80px" />

<block name="core/buttons">
  <block name="core/button" url="/contact">Get in Touch</block>
  <block name="core/button" url="/work">See Our Work</block>
</block>

Attribute auf <block>-Elementen werden als Blockattribute übergeben. Werte werden automatisch umgewandelt: "true" wird zu einem booleschen Wert, "3" zu einer Ganzzahl und Zeichenfolgen wie JSON werden in Objekte dekodiert. '{"type":"flex"}'

Layouts

Gruppen unterstützen über das Attribut layout verschiedene Layoutmodi:

HTML
<!-- Default group (stacked) -->
<div>
  <p>Stacked by default.</p>
</div>

<!-- Row (horizontal flex) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
  <p>Side</p>
  <p>by side</p>
</block>

<!-- Stack (vertical flex) -->
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
  <p>Stacked</p>
  <p>with flex</p>
</block>

<!-- Columns -->
<block name="core/columns">
  <block name="core/column">
    <p>Left column.</p>
  </block>
  <block name="core/column">
    <p>Right column.</p>
  </block>
</block>

Eigene Blöcke

Die Syntax <block> funktioniert für alle registrierten Blöcke, einschließlich deiner eigenen Blockstudio-Blöcke:

HTML
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />

Attribute werden automatisch den Feldwerten von Blockstudio des Blocks zugeordnet.

Eine Landingpage erstellen

Hier ist eine vollständige Landingpage, die Core-Blöcke für Struktur und Layout verwendet:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "slug": "landing",
  "postStatus": "publish",
  "templateLock": "all"
}
HTML
<block name="core/cover" url="https://images.unsplash.com/photo-1497366216548-37526070297c?w=1600">
  <h1>Build faster with Blockstudio</h1>
  <p>File-based blocks. Zero build step. Full editor integration.</p>
  <block name="core/buttons">
    <block name="core/button" url="/get-started">Get Started</block>
    <block name="core/button" url="/docs">Documentation</block>
  </block>
</block>

<div>
  <h2>Why developers love it</h2>
  <block name="core/columns">
    <block name="core/column">
      <h3>No build step</h3>
      <p>Write PHP, CSS, and JavaScript. No webpack, no bundler, no transpiler.</p>
    </block>
    <block name="core/column">
      <h3>File-based</h3>
      <p>Every block is a folder. Every page is a template. Version control everything.</p>
    </block>
    <block name="core/column">
      <h3>Full editor support</h3>
      <p>Fields, previews, and InnerBlocks work in the block editor out of the box.</p>
    </block>
  </block>
</div>

<block name="core/media-text" mediaurl="https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=800" mediatype="image">
  <h2>Ship entire sites from your IDE</h2>
  <p>Define pages, blocks, and patterns as files. Blockstudio handles the rest.</p>
</block>

<div>
  <h2>Frequently asked questions</h2>
  <details>
    <summary>Do I need to learn React?</summary>
    <p>No. Templates are PHP. Fields are JSON. Interactivity is optional.</p>
  </details>
  <details>
    <summary>Does it work with my existing theme?</summary>
    <p>Yes. Drop a blockstudio folder into any theme and start creating blocks.</p>
  </details>
</div>

<div>
  <block name="core/buttons">
    <block name="core/button" url="/get-started">Start Building</block>
  </block>
</div>

Diese Seite enthält einen Cover-Hero, ein dreispaltiges Raster mit Merkmalen, einen Medien-Text-Bereich, FAQ-Akkordeons und einen CTA. Alles in einer einzigen HTML-Datei. Das templateLock: "all" in page.json bedeutet, dass der Kunde nichts ändern kann. Im nächsten Abschnitt erfährst du, wie du die Sperre lockerst.

Den Editor steuern

Hier zeigen dateibasierte Seiten ihre ganze Stärke. Blockstudio bietet dir zwei unabhängige Steuerungsmöglichkeiten: Vorlagensperre und Block-Bearbeitungsmodus. Damit legst du genau fest, welche Teile einer Seite Kunden bearbeiten können. Sperre die Struktur und erlaube ihnen trotzdem, den Text zu bearbeiten. Friere bestimmte Abschnitte ein und lasse andere vollständig offen. Erstelle eine Seite, auf der ein Kunde nur drei bestimmte Überschriften ausfüllen kann.

Vorlagensperre

Die Eigenschaft templateLock in page.json steuert die strukturelle Bearbeitung: ob Blöcke hinzugefügt, entfernt oder neu angeordnet werden können.

"all" (Standard)

JSON
{
  "name": "terms",
  "templateLock": "all"
}

Die strengste Sperre. Kunden können keine Blöcke hinzufügen, entfernen oder verschieben. Außerdem können sie Blockinhalte nicht bearbeiten, außer die Sperre wird mit blockEditingMode kombiniert. Dies ist der Standard, wenn du keinen Wert angibst.

Wann du sie verwendest: Rechtsseiten, Nutzungsbedingungen und Datenschutzrichtlinien. Alle Seiten, deren Inhalt nur per Code geändert werden soll.

"insert"

JSON
{
  "name": "about",
  "templateLock": "insert"
}

Kunden können keine Blöcke hinzufügen oder entfernen, aber bestehende Blöcke verschieben und deren Inhalte bearbeiten. Die Anzahl der Blöcke bleibt gleich, ihre Reihenfolge ist jedoch flexibel.

Wann du sie verwendest: Seiten mit einer festen Anzahl von Abschnitten, die Kunden neu anordnen können sollen. Zum Beispiel eine Portfolioseite, auf der die Anzahl der Abschnitte feststeht, aber Kunden die Reihenfolge bestimmen.

"contentOnly"

JSON
{
  "name": "homepage",
  "templateLock": "contentOnly"
}

Kunden können Textinhalte bearbeiten, aber keine Blöcke hinzufügen, entfernen oder verschieben. Der Unterschied zu "all": "all" verhindert auch die Bearbeitung von Inhalten, während "contentOnly" sie ausdrücklich erlaubt.

Wann du es verwendest: Die häufigste Wahl für Kundenseiten. Der Entwickler bestimmt das Layout, der Kunde füllt den Text aus.

false

JSON
{
  "name": "blog",
  "templateLock": false
}

Keine Sperre. Kunden haben volle Kontrolle: Sie können beliebige Blöcke hinzufügen, entfernen, verschieben und bearbeiten. Die Vorlage liefert eine Ausgangsstruktur, über die Kunden anschließend selbst bestimmen.

Wann du sie verwendest: Blog-Übersichtsseiten, Seiten mit frei gestaltbaren Inhalten und alle Seiten, auf denen Kunden redaktionelle Freiheit haben sollen.

Block-Bearbeitungsmodus

Während templateLock die Struktur steuert (Hinzufügen, Entfernen, Verschieben), steuert blockEditingMode die Interaktion mit einzelnen Blöcken: ob Blöcke überhaupt ausgewählt, konfiguriert oder bearbeitet werden können.

Lege einen Standardwert für die gesamte Seite in page.json fest:

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

"default"

Volle Bearbeitungsmöglichkeiten. Blöcke können ausgewählt, ihre Einstellungen geändert und ihre Inhalte bearbeitet werden. Das ist die übliche Editoransicht.

"contentOnly"

Blöcke lassen sich bearbeiten, aber nur ihr Textinhalt. Du kannst keine Blockeinstellungen öffnen, Farben ändern, Abstände anpassen oder andere Attribute bearbeiten. Die Block-Symbolleiste zeigt nur Optionen zur Textformatierung.

"disabled"

Blöcke sind vollständig nicht interaktiv. Sie werden im Editor angezeigt, können aber weder angeklickt noch ausgewählt oder anderweitig bearbeitet werden. Der Kunde sieht den Inhalt, kann ihn aber nicht verändern.

Überschreibungen für einzelne Elemente

Hier wird es interessant. Die Einstellung auf Seitenebene blockEditingMode legt einen Standard für alle Blöcke auf der Seite fest. Du kannst sie aber für einzelne Elemente in der Vorlage überschreiben:

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<block name="core/cover" url="https://example.com/hero.jpg">
  <h1 blockEditingMode="contentOnly">Edit This Heading</h1>
  <p blockEditingMode="contentOnly">Edit this paragraph too.</p>
</block>

<div>
  <h2>Features</h2>
  <p>This paragraph cannot be edited (inherits "disabled").</p>
  <p blockEditingMode="contentOnly">But this one can.</p>
</div>

<block name="core/buttons">
  <block name="core/button" url="/contact">This button is frozen</block>
</block>

Der Seitenstandard ist "disabled", deshalb sind alle Blöcke zunächst nicht interaktiv. Bestimmte Elemente erhalten dann ausdrücklich "contentOnly", sodass sich nur ihr Text bearbeiten lässt. Das Ergebnis: Der Kunde kann genau zwei Textfelder (die Hero-Überschrift und den Absatz) sowie einen Feature-Absatz bearbeiten. Alles andere ist gesperrt.

Das funktioniert mit jedem Element vom Typ HTML (<h1>, <p>, <div> usw.) und mit Elementen vom Typ <block>. Du kannst auch für bestimmte Elemente blockEditingMode="default" festlegen, um den vollständigen Bearbeitungszugriff zu gewähren:

HTML
<block name="core/buttons" blockEditingMode="default">
  <block name="core/button" url="/contact">Fully editable button</block>
</block>

Jetzt kann der Kunde den Buttontext, URL, Stile und alle weiteren Einstellungen ändern. Der Rest der Seite bleibt unverändert.

Kaskade der übergeordneten Blöcke

Ein wichtiges Detail: Überschreibungen für einzelne Elemente wirken sich auf Containerblöcke aus. Wenn der Seitenstandard "disabled" ist und du für eine Überschrift innerhalb einer Gruppe blockEditingMode="contentOnly" festlegst, muss die Überschrift erreichbar sein. Die übergeordnete Gruppe ist jedoch auf "disabled" gesetzt und kann deshalb gar nicht geöffnet werden.

Blockstudio erledigt das automatisch. Wenn für einen untergeordneten Block ein Bearbeitungsmodus überschrieben wird, werden alle übergeordneten Blöcke auf "contentOnly" gesetzt, damit der untergeordnete Block zugänglich bleibt. Du musst die Modi der übergeordneten Container nicht manuell festlegen. Überschreibe einfach den Modus des Blocks, den du bearbeiten lassen möchtest, und der Pfad dorthin wird geöffnet.

HTML
<!-- page default: "disabled" -->
<div>
  <!-- this group is auto-set to "contentOnly" because it contains an override -->
  <div>
    <!-- this group is also auto-set to "contentOnly" -->
    <p blockEditingMode="contentOnly">Deeply nested but still editable.</p>
  </div>
</div>

Die Kaskade setzt Container höchstens auf "contentOnly", niemals auf "default". Übergeordnete Gruppen lassen sich dadurch öffnen und darin navigieren, aber nicht vollständig bearbeiten, also auch nicht in ihren Einstellungen ändern.

Entscheidungsmatrix

Mit templateLock und blockEditingMode kannst du die Zugriffsrechte flexibel festlegen. Hier sind die nützlichsten Kombinationen:

Entwickler kontrolliert alles

JSON
{ "templateLock": "all" }

blockEditingMode ist nicht nötig. Der Standardwert templateLock: "all" verhindert alle Änderungen. Verwende diese Einstellung für Seiten, die vollständig über Code verwaltet werden.

Kunde bearbeitet alle Texte

JSON
{ "templateLock": "contentOnly" }

Der Kunde kann den Text in jedem Block bearbeiten, aber nicht die Seitenstruktur ändern. Einfach und großzügig.

Kunde bearbeitet nur bestimmte Texte

JSON
{
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

In Kombination mit blockEditingMode="contentOnly" für bestimmte Elemente in der Vorlage. Das ist die präziseste Option: Der Kunde kann nur die Blöcke bearbeiten, die du ausdrücklich freigibst.

Kunde ordnet festgelegte Abschnitte neu an

JSON
{ "templateLock": "insert" }

Der Kunde kann Abschnitte neu anordnen und Inhalte bearbeiten, aber keine Blöcke hinzufügen oder löschen. Ideal für Seiten mit einer festen Auswahl an Abschnitten, deren Reihenfolge flexibel ist.

Kunde hat volle Kontrolle

JSON
{ "templateLock": false }

Die Vorlage dient als Ausgangspunkt. Danach kann der Kunde alles machen.

Änderungen des Kunden erhalten

Standardmäßig ersetzt Blockstudio den gesamten Seiteninhalt, wenn du eine Vorlagendatei aktualisierst. Hat der Kunde im Editor eine Überschrift bearbeitet, ist diese Änderung nach der nächsten Synchronisierung verschwunden. Bei Seiten, die Entwickler verwalten, ist das kein Problem. Wenn Kunden Inhalte beitragen, brauchst du jedoch eine Möglichkeit, ihre Arbeit zu erhalten.

Schlüssel

Füge einem beliebigen Element ein Attribut key hinzu, damit es beim Zusammenführen erhalten bleibt, statt ersetzt zu werden:

HTML
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
  <h1>Default Hero Title</h1>
  <p>Default hero description.</p>
</block>

<div key="features">
  <h2>Features</h2>
  <p>Feature introduction text.</p>
</div>

<div>
  <h2>Unkeyed Section</h2>
  <p>This gets replaced on every sync.</p>
</div>

Wenn sich die Vorlage ändert und die Seite erneut synchronisiert wird:

  • Blöcke mit Schlüssel behalten die Inhalte des Kunden (Text, innere Blöcke und Formatierung). Strukturelle Attribute der Vorlage, etwa url des Covers, werden weiterhin aktualisiert.
  • Blöcke ohne Schlüssel werden vollständig durch die Version aus der Vorlage ersetzt.

Ein Schlüssel schützt den gesamten Block einschließlich aller untergeordneten Blöcke. Du musst einzelne Absätze innerhalb einer Gruppe mit Schlüssel nicht zusätzlich markieren. Der Schlüssel der Gruppe schützt alles darin.

Schlüssel müssen eindeutig sein

Schlüssel müssen in der gesamten Vorlage eindeutig sein. Haben zwei Elemente denselben Schlüssel, wird das zweite wie ein Element ohne Schlüssel behandelt und eine PHP-Warnung ausgegeben. Verwende aussagekräftige Namen: "hero", "features", "cta", "testimonial-section".

Vorlagen weiterentwickeln

Mit Schlüsseln kannst du einer Vorlage neue Abschnitte hinzufügen, ohne vorhandene Kundeninhalte zu beeinträchtigen:

HTML
<h1 key="title">Welcome</h1>
<div key="services">
  <h2>Our Services</h2>
  <p>We do great work.</p>
</div>
HTML
<h1 key="title">Welcome</h1>
<div key="services">
  <h2>Our Services</h2>
  <p>We do great work.</p>
</div>
<div key="testimonials">
  <h2>What Clients Say</h2>
  <p>Default testimonial text.</p>
</div>

Bei der Synchronisierung bleiben die Änderungen des Kunden an Titel und Leistungen erhalten. Der neue Abschnitt mit Kundenstimmen wird mit dem Standardinhalt der Vorlage eingefügt. Entfernst du später einen Block mit Schlüssel aus der Vorlage, wird er von der Seite gelöscht.

Der vollständige Ablauf für Kunden

So sieht das Ganze bei einem echten Projekt aus:

JSON
{
  "name": "homepage",
  "title": "Home",
  "slug": "home",
  "postStatus": "publish",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
  <h1 blockEditingMode="contentOnly">Your Company Name</h1>
  <p blockEditingMode="contentOnly">Your tagline goes here.</p>
  <block name="core/buttons">
    <block name="core/button" url="/contact">Contact Us</block>
  </block>
</block>

<div key="features">
  <h2 blockEditingMode="contentOnly">What We Do</h2>
  <block name="core/columns">
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service One</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service Two</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service Three</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
  </block>
</div>

<block name="core/media-text" key="about" mediaurl="https://example.com/team.jpg" mediatype="image">
  <h2 blockEditingMode="contentOnly">About Us</h2>
  <p blockEditingMode="contentOnly">Tell your story here.</p>
</block>

<div key="cta">
  <h2 blockEditingMode="contentOnly">Ready to get started?</h2>
  <block name="core/buttons">
    <block name="core/button" url="/contact">Get in Touch</block>
  </block>
</div>

Diese Seite hat vier Abschnitte mit Schlüsseln. Der Kunde kann die Überschriften und Absätze bearbeiten, die mit blockEditingMode="contentOnly" markiert sind; diese Änderungen bleiben bei Vorlagenaktualisierungen erhalten. Der Entwickler kontrolliert Layout, Bilder, Button-URLs und die gesamte Struktur. Fügt der Entwickler später zwischen „about“ und „cta“ einen Abschnitt mit Kundenstimmen hinzu, erscheint er bei der nächsten Synchronisierung, ohne die Texte des Kunden zu verändern.

Blockbindungen: eine Alternative zu Schlüsseln

Mit WordPress 6.5 wurden die Blockbindungen API eingeführt. Sie verbinden Blockattribute mit Post-Metadaten. Statt bearbeitbare Inhalte im Block-Markup zu speichern, wo Schlüssel sie schützen, liegen die Inhalte in wp_postmeta und können von der Vorlagensynchronisierung nicht verändert werden.

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

<p metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_description"}}}}'>
  Default description.
</p>

Die Metaschlüssel müssen in PHP registriert sein:

PHP
register_post_meta( 'page', 'hero_title', array(
    'show_in_rest' => true,
    'single'       => true,
    'type'         => 'string',
    'default'      => 'Default Title',
) );

Blockbindungen haben zwei Vorteile gegenüber Schlüsseln: Die Daten lassen sich mit WP_Query über meta_query abfragen und stehen im REST API zur Verfügung. Dafür musst du jeden Metaschlüssel in PHP registrieren. Außerdem funktionieren Bindungen nur mit einzelnen Blockattributen, nicht mit komplexen verschachtelten Inhalten.

Verwende Schlüssel für umfangreiche Inhaltsbereiche, bei denen die Blockstruktur wichtig ist, etwa eine Gruppe mit Überschriften, Absätzen und Bildern. Bindungen eignen sich für einzelne Textwerte, die du auch abfragen oder an anderer Stelle anzeigen möchtest.

Beitragstypvorlagen

Verwende templateFor, um eine Standard-Blockstruktur für alle neuen Beiträge eines bestimmten Typs festzulegen:

JSON
{
  "name": "product-template",
  "title": "Product Template",
  "templateFor": "product",
  "templateLock": "insert"
}
HTML
<h1>Product Name</h1>

<block name="core/columns">
  <block name="core/column">
    <img src="" alt="Product image" />
  </block>
  <block name="core/column">
    <p>Product description goes here.</p>
    <block name="core/buttons">
      <block name="core/button" url="#">Buy Now</block>
    </block>
  </block>
</block>

<div>
  <h2>Specifications</h2>
  <table>
    <thead>
      <tr><th>Feature</th><th>Value</th></tr>
    </thead>
    <tbody>
      <tr><td>Weight</td><td>1.2 kg</td></tr>
    </tbody>
  </table>
</div>

Jeder neue „product“-Beitrag beginnt mit dieser Struktur. Mit templateLock: "insert" können Redakteure Abschnitte neu anordnen und Inhalte bearbeiten, aber keine Blöcke hinzufügen oder entfernen.

Tipps

Synchronisiere an einem bewusst gewählten Deployment-Punkt. Führe wp bs pages sync nach dem Ändern oder Deployen von Seitenquellen aus. Besuche im Frontend oder Adminbereich lösen keine Synchronisierung aus. PHP Deployment-Tools können Blockstudio\Pages::reconcile() aufrufen und den maschinenlesbaren Bericht auswerten.

Wichtige Beitrags-IDs festlegen. Verwende postId in page.json für Seiten, auf die Menüs, fest codierte Links oder externe Systeme verweisen. Wird eine Seite ohne festgelegte ID gelöscht und neu erstellt, erhält sie eine neue ID und diese Verweise funktionieren nicht mehr.

Verwende sync: false für Grundgerüste. Wenn du eine Seite einmal erstellen und dann vollständig an den Kunden übergeben möchtest, setze "sync": false und erstelle sie mit Blockstudio\Pages::force_sync(). Bei der normalen Abstimmung wird sie anschließend ignoriert.

Sperren und Entsperren mit PHP. Rufe Blockstudio\Pages::lock('about') auf, um die Synchronisierung einer bestimmten Seite zu verhindern, etwa während einer intensiven Bearbeitungsphase des Kunden. Mit Blockstudio\Pages::unlock('about') aktivierst du die Synchronisierung wieder.

Template-Engines. Neben PHP kannst du Vorlagen mit Twig (erfordert Timber) oder Blade (erfordert illuminate/view) schreiben. Das ist nützlich für Schleifen und Filter. Seitenvorlagen werden jedoch bei einer ausdrücklichen Synchronisierung kompiliert, nicht während der Frontend-Anfrage. Verwende PHP, wenn die Quellkompilierung selbst ausschließlich PHP-Helfer benötigt.

Erzwungene Synchronisierung ignoriert Schlüssel. Der Aufruf von Pages::force_sync('about') ersetzt den gesamten Seiteninhalt und ignoriert Schlüssel sowie Prüfungen des Änderungszeitpunkts. Verwende ihn, wenn du eine Seite absichtlich auf den Vorlagenstand zurücksetzen möchtest.

Nächste Schritte

  • Seitenreferenz: alle Eigenschaften von page.json, das PHP API und den Algorithmus zum Zusammenführen von Blöcken mit Schlüsseln im Detail.
  • Übersicht zu Seiten und Mustern: der HTML-Parser, die Referenz zur Blocksyntax, benutzerdefinierte Renderer und die Zuordnung von Elementen.
  • Muster: dieselbe Vorlagensyntax für wiederverwendbare Blockmuster statt für Seiten.