Twig
TwigはPHP向けの柔軟で高速かつ安全なテンプレートエンジンです。開発者はテンプレート内に簡潔で読みやすいコードを書けるため、生産性と保守性が向上します。Twigはテンプレート作成を強力かつシンプルにするさまざまな機能を備えており、堅牢で再利用可能なテンプレートを必要とするプロジェクトに最適です。
セットアップ
BlockstudioでTwigテンプレートを使うには、Composerでtimber/timberパッケージ(Twigを含む)をインストールする必要があります。BlockstudioはTimberがインストールされているか自動的に検出し、ブロックでTwigテンプレートを有効にします。
シェル
composer require timber/timber
Timberをインストールすると、Blockstudioはブロックのフォルダー内にあるindex.twigファイルを自動的にレンダリングします。
テンプレート変数
すべてのTwigファイルからTimberコンテキストを利用できます。これには一般的なWordPressデータと関数、およびBlockstudio固有の変数が含まれます。
| 変数 | 説明 |
|---|---|
a |
attributesの別名 |
attributes |
ブロックの属性 |
b |
blockの別名 |
block |
ブロック自体に関するデータ(postId、postType、contextなどを含む) |
c |
contextの別名 |
context |
ブロックのコンテキスト(ループ内ではe.g、postId、postTypeなど) |
isEditor |
ブロックがエディター内でレンダリングされている場合はtrueとなるブール値 |
isPreview |
ブロックが挿入ツールのプレビュー内でレンダリングされている場合はtrueとなるブール値 |
使い方
ブロックのテンプレートにTwigを使うには、ブロックのディレクトリにindex.twigファイルを作成します。Blockstudioは、このファイルを使ってブロックを自動的にレンダリングします。
Twig
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>