Twig
Twig é um mecanismo de templates flexível, rápido e seguro para PHP. Ele permite que desenvolvedores escrevam código conciso e legível em templates, aumentando a produtividade e a facilidade de manutenção. Twig oferece vários recursos para tornar a criação de templates poderosa e simples, sendo ideal para projetos que exigem templates robustos e reutilizáveis.
Configuração
Para usar templates Twig com Blockstudio, instale o pacote timber/timber (que inclui Twig) usando Composer. Blockstudio detectará automaticamente se Timber está instalado e habilitará templates Twig para seus blocos.
composer require timber/timber
Depois que Timber for instalado, Blockstudio cuidará automaticamente da renderização dos arquivos index.twig encontrados nas pastas dos seus blocos.
Variáveis de template
Todos os arquivos Twig terão acesso ao contexto Timber, que inclui dados e funções WordPress comuns, bem como variáveis específicas de Blockstudio:
| Variável | Descrição |
|---|---|
a |
Um alias para attributes |
attributes |
Os atributos do bloco |
b |
Um alias para block |
block |
Dados relacionados ao próprio bloco (inclui postId, postType, context etc.) |
c |
Um alias para context |
context |
O contexto do bloco (e.g., postId, postType quando estiver em um loop) |
isEditor |
Booleano, verdadeiro se o bloco estiver sendo renderizado no editor |
isPreview |
Booleano, verdadeiro se o bloco estiver sendo renderizado na prévia do inseridor |
Uso
Para usar Twig no template do seu bloco, basta criar um arquivo index.twig no diretório do bloco. Blockstudio usará esse arquivo automaticamente para renderizar o bloco.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>