Pular para o conteúdo

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.

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

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

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