コンテンツへスキップ

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>