Przejdź do treści

Twig

Twig to elastyczny, szybki i bezpieczny silnik szablonów dla PHP. Pozwala programistom pisać zwięzły, czytelny kod w szablonach, zwiększając produktywność i ułatwiając utrzymanie. Twig obsługuje wiele funkcji, które sprawiają, że tworzenie szablonów jest zarówno wszechstronne, jak i proste, dzięki czemu idealnie nadaje się do projektów wymagających solidnych, wielokrotnego użytku szablonów.

Konfiguracja

Aby używać szablonów Twig z Blockstudio, zainstaluj pakiet timber/timber (który zawiera Twig) za pomocą Composer. Blockstudio automatycznie wykryje, czy zainstalowano Timber, i włączy obsługę szablonów Twig w Twoich blokach.

Powłoka
composer require timber/timber

Po zainstalowaniu Timber, Blockstudio automatycznie zajmie się renderowaniem plików index.twig znalezionych w katalogach bloków.

Zmienne szablonów

Wszystkie pliki Twig będą miały dostęp do kontekstu Timber, który obejmuje typowe dane i funkcje WordPress, a także zmienne specyficzne dla Blockstudio:

Zmienna Opis
a Alias dla attributes
attributes Atrybuty bloku
b Alias dla block
block Dane powiązane z samym blokiem (obejmują postId, postType, context itd.)
c Alias dla context
context Kontekst bloku (np. e.g, postId, postType w pętli)
isEditor Wartość logiczna, prawda, jeśli blok jest renderowany w edytorze
isPreview Wartość logiczna, prawda, jeśli blok jest renderowany w podglądzie wstawiania

Użycie

Aby użyć Twig jako szablonu bloku, po prostu utwórz plik index.twig w katalogu bloku. Blockstudio będzie wtedy automatycznie używać tego pliku do renderowania bloku.

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

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