Zum Inhalt springen

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.

Shell
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.

Twig
<div class="my-block">
  {% if a.title %}
    <h2>{{ a.title }}</h2>
  {% endif %}

  {% if a.content %}
    <p>{{ a.content }}</p>
  {% endif %}
</div>