Vai al contenuto

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.

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

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

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