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.
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.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>