Saltar al contenido

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.

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

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

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