Twig
Twig è un motore di template flessibile, veloce e sicuro per PHP. Consente agli sviluppatori di scrivere codice conciso e leggibile nei template, migliorando produttività e manutenibilità. Twig offre diverse funzionalità pensate per rendere la creazione di template potente e semplice, ideale per progetti che richiedono template riutilizzabili e affidabili.
Configurazione
Per usare i template Twig con Blockstudio, installate il pacchetto timber/timber (che include Twig) con Composer. Blockstudio rileverà automaticamente se Timber è installato e abiliterà i template Twig per i vostri blocchi.
composer require timber/timber
Dopo aver installato Timber, Blockstudio gestirà automaticamente il rendering dei file index.twig presenti nelle cartelle dei vostri blocchi.
Variabili dei template
Tutti i file Twig avranno accesso al contesto Timber, che include dati e funzioni WordPress comuni, oltre a variabili specifiche di Blockstudio:
| Variabile | Descrizione |
|---|---|
a |
Alias di attributes |
attributes |
Gli attributi del blocco |
b |
Alias di block |
block |
Dati relativi al blocco stesso (includono postId, postType, context ecc.) |
c |
Alias di context |
context |
Il contesto del blocco (e.g., postId, postType quando si è all’interno di un loop) |
isEditor |
Booleano, true se il blocco viene renderizzato nell’editor |
isPreview |
Booleano, true se il blocco viene renderizzato nell’anteprima dell’inseritore |
Utilizzo
Per usare Twig nel template del vostro blocco, create semplicemente un file index.twig nella directory del blocco. Blockstudio userà quindi automaticamente questo file per renderizzare il blocco.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>