Twig
Twig ist eine flexible, schnelle und sichere Template-Engine für PHP. Sie ermöglicht Entwicklern, prägnanten und gut lesbaren Code in Templates zu schreiben und so Produktivität und Wartbarkeit zu steigern. Twig bietet zahlreiche Funktionen, die das Erstellen leistungsfähiger und einfacher Templates ermöglichen. Damit eignet sich Twig ideal für Projekte, die robuste, wiederverwendbare Templates erfordern.
Einrichtung
Um Twig-Vorlagen mit Blockstudio zu verwenden, musst du das Paket timber/timber (das Twig enthält) mit Composer installieren. Blockstudio erkennt automatisch, ob Timber installiert ist, und aktiviert Twig-Templates für deine Blöcke.
composer require timber/timber
Sobald Timber installiert ist, übernimmt Blockstudio automatisch die Darstellung von index.twig-Dateien in deinen Blockverzeichnissen.
Template-Variablen
Alle Twig-Dateien haben Zugriff auf den Timber-Kontext mit allgemeinen WordPress-Daten und -Funktionen sowie auf Variablen speziell für Blockstudio:
| Variable | Beschreibung |
|---|---|
a |
Ein Alias für attributes |
attributes |
Die Attribute des Blocks |
b |
Ein Alias für block |
block |
Daten zum Block selbst (einschließlich postId, postType, context usw.) |
c |
Ein Alias für context |
context |
Der Kontext des Blocks (e.g, postId, postType innerhalb einer Schleife) |
isEditor |
Boolean-Wert, true, wenn der Block im Editor dargestellt wird |
isPreview |
Boolean-Wert, true, wenn der Block in der Inserter-Vorschau dargestellt wird |
Verwendung
Um Twig für das Template deines Blocks zu verwenden, erstelle einfach eine index.twig-Datei im Verzeichnis deines Blocks. Blockstudio verwendet diese Datei dann automatisch, um den Block darzustellen.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>