1.2. Liquid の使用方法

Liquid のマークアップには、ロジックタグとアウトプットタグの 2 種類があります。ロジックタグ (MISSING で識別) は、if 節やループ等の標準的なプログラミング言語の要素が含まれる条件付き Liquid ステートメントです。

{% if current_user %}           <!-- if the user is logged in -->
  <a href="/logout">Logout</a>  <!-- show the logout link -->
{% else %}                      <!-- if the user is not logged in -->
  <a href="/login">Login</a>    <!-- display the login link -->
{% endif %}

アウトプットタグ ({{ }}で識別) は、中かっこ間のタグの値を表示するのに使用されます。

{{ current_user.username }}     <!-- display the logged-in user's username value -->

ロジックタグに関するドキュメントは、Shopify のチュートリアル を参照してください。3scale の Liquid アウトプットタグに関する詳細なリファレンスは、このページ および管理ポータルの Help > Liquid Reference の両方に記載されています。

1.2.1. Liquid ドロップ、タグ、およびその意味

3scale の CMS では、以下の 3 種類の Liquid マークアップを使用することができます。

  • liquid ドロップ (例: {{ current_account.name }})
  • liquid タグ (例: {% content %})
  • フィルター (例: {{ form.errors.description | error_class }})

すべての Liquid タグ、ドロップ、およびフィルターの全リストは、このページ を参照してください。

これらは、ロジックタグおよびアウトプットタグとほとんど同じで、ほぼ同じように機能します。Liquid ドロップは最も基本的な構造で、ほとんどのケースで使用されます。これを使用して、ユーザー名やアプリケーション ID 等の、システムに保管されている特定の値にアクセスすることができます。これらは、他のアウトプットタグと同様に、インタープリターにより処理されます。

一方、Liquid タグはロジックタグの一種で、より高度なカスタマイズのためにシステムの特定部分をレンダリングしたり、アクセスしたりするのに使用されます (例: レイアウト内のコンテンツのレンダリング、メールテンプレートのカスタマイズ)。

その名前から分かるように、フィルターはドロップからの結果の絞り込み、値の変換、特定のキーによるグルーピングのオプションを有効にします。標準 Liquid フィルターのグループ (詳細は Shopify の Web サイト を参照) および特殊な 3scale 内部フィルターのグループ (詳細は 参照ページ に記載) があります。