Twig
Twig es un motor de plantillas flexible, rápido y seguro para PHP. Permite a los desarrolladores escribir código conciso y legible en las plantillas, lo que mejora la productividad y la facilidad de mantenimiento. Twig ofrece funciones que hacen que las plantillas sean potentes y sencillas, ideales para proyectos que necesitan plantillas robustas y reutilizables.
Configuración
Para usar plantillas Twig con Blockstudio, instale el paquete timber/timber (que incluye Twig) con Composer. Blockstudio detectará automáticamente si Timber está instalado y habilitará las plantillas Twig para sus bloques.
composer require timber/timber
Una vez instalado Timber, Blockstudio se encargará automáticamente de representar los archivos index.twig que haya en las carpetas de sus bloques.
Variables de plantilla
Todos los archivos Twig tendrán acceso al contexto de Timber, que incluye datos y funciones comunes de WordPress, así como variables específicas de Blockstudio:
| Variable | Descripción |
|---|---|
a |
Un alias de attributes |
attributes |
Los atributos del bloque |
b |
Un alias de block |
block |
Datos relacionados con el bloque (incluye postId, postType, context, etc.) |
c |
Un alias de context |
context |
El contexto del bloque (e.g, postId y postType dentro de un bucle) |
isEditor |
Booleano: verdadero si el bloque se está representando en el editor |
isPreview |
Booleano: verdadero si el bloque se está representando en la vista previa del insertador |
Uso
Para usar Twig en la plantilla de su bloque, solo tiene que crear un archivo index.twig en el directorio del bloque. Blockstudio usará automáticamente este archivo para representar el bloque.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>