テンプレートでの出力(基本の型)


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

値は、フィールド定義のキーで、従来のカスタムフィールドと同じテーブルに保存されます。そのため、従来のカスタムフィールドと同じモジュール・同じ変数で出せます。メディア・参照・地図などは「テンプレートでの出力(メディア・参照・地図・アップロード)」を参照してください。

値を出すモジュールと書く場所

対象

標準のテンプレート

Twig

エントリー

エントリーの詳細ページの Entry_Field モジュールの中。または Entry_Body・Entry_Summary などの entry:loop の中(エントリーのカスタムフィールドの表示が有効なとき)

module('V2_Entry_Field').fields(URL のエントリー)

カテゴリー

Category_Field モジュールの中

module('V2_Category_Field').fields(URL のカテゴリー)

ブログ

Blog_Field モジュールの中

module('V2_Blog_Field').fields

ユーザー

User_Field モジュールの中

module('V2_User_Field').fields(URL のユーザー)

モジュール

そのモジュール ID のモジュールの <!-- BEGIN moduleField --> の中(モジュール ID で「カスタムフィールドを表示」にチェックが要ります)

V2 モジュールの戻り値の moduleFields

このページの例は、エントリーの詳細ページで Entry_Field を使って書いています。ほかのモジュールでも、変数の書き方は同じです。

<!-- BEGIN_MODULE Entry_Summary id="topics" -->
<!-- BEGIN moduleField --><h2>{cf_section_title}</h2><!-- END moduleField -->
<!-- BEGIN unit:loop -->
<!-- BEGIN entry:loop -->
<article>
  <h3><a href="{url}">{title}</a></h3>
  <p>{cf_lead}</p>
</article>
<!-- END entry:loop -->
<!-- END unit:loop -->
<!-- END_MODULE Entry_Summary -->

上の例の {cf_section_title} はモジュール ID「topics」に定義したフィールド、{cf_lead} はエントリーに定義したフィールドです。Entry_Summary でエントリーのカスタムフィールドを出すには、モジュール ID の設定でエントリーのカスタムフィールドの表示が有効になっている必要があります(既定で有効です)。

標準のテンプレートの基本

書き方

意味

{キー}

値を出します。HTML の特殊文字はエスケープされます。

<!-- BEGIN キー:veil -->…<!-- END キー:veil -->

値があるときだけ中を出します。

<!-- BEGIN キー:loop -->{キー}<!-- END キー:loop -->

複数の値を 1 つずつ出します。

{キー[0]}・{キー[1]}

複数の値のうち、何番目かを出します(0 から数えます)。

{キー}[nl2br]

改行を <br> にします。

{キー}[date('Y年n月j日')]

日付の形を変えます。

{キー}[number_format(2)]

3 桁区切り・小数部の桁数をそろえます(1500.5 は 1,500.50)。桁数を書かない [number_format] は小数点以下を四捨五入します(1500.5 は 1,501)。

{キー}[raw]

エスケープせずに出します(ブロックエディターなど HTML の値だけに使います)。

<!-- BEGIN_IF [{キー}/eq/値] -->…<!-- END_IF -->

値で出し分けます。

セレクトボックス・チェックボックス・ラジオボタンは、選んだ選択肢の「値」を保存します。表示名を出すときは、BEGIN_IF で値から読み替えます。

型ごとの例

次のフィールドを定義したときの例です。

キー

型

設定

cf_lead

テキスト

—

cf_body

テキストエリア

—

cf_type

セレクトボックス

選択肢 seminar(セミナー)・workshop(ワークショップ)

cf_features

チェックボックス

複数選択。選択肢 parking(駐車場あり)・wifi(Wi-Fi あり)

cf_reserved

チェックボックス

「複数選択できるようにする」をオフ(単一の on/off)

cf_date

日付

表示フォーマットは既定(Y-m-d)

cf_open_time

時刻

既定(H:i)

cf_deadline

日時

既定(Y-m-d H:i)

cf_price

数値

—

cf_tel・cf_email・cf_url

電話番号・メールアドレス・URL

—

cf_note

ブロックエディター

—

<!-- BEGIN_MODULE Entry_Field -->
<!-- テキスト -->
<!-- BEGIN cf_lead:veil --><p class="lead">{cf_lead}</p><!-- END cf_lead:veil -->

<!-- テキストエリア(改行を <br> にする) -->
<!-- BEGIN cf_body:veil --><p>{cf_body}[nl2br]</p><!-- END cf_body:veil -->

<!-- セレクトボックス(単一)・ラジオボタン: 値で表示名に読み替える -->
<p>種類:
<!-- BEGIN_IF [{cf_type}/eq/seminar] -->セミナー
<!-- ELSE_IF [{cf_type}/eq/workshop] -->ワークショップ
<!-- END_IF -->
</p>

<!-- チェックボックス(複数選択)・セレクトボックス(複数選択) -->
<!-- BEGIN cf_features:veil -->
<ul class="features">
  <!-- BEGIN cf_features:loop -->
  <li><!-- BEGIN_IF [{cf_features}/eq/parking] -->駐車場あり<!-- ELSE_IF [{cf_features}/eq/wifi] -->Wi-Fi あり<!-- ELSE -->{cf_features}<!-- END_IF --></li>
  <!-- END cf_features:loop -->
</ul>
<!-- END cf_features:veil -->

<!-- チェックボックス(単一の on/off。チェック時の値は既定の on) -->
<!-- BEGIN_IF [{cf_reserved}/eq/on] --><p>要予約</p><!-- END_IF -->

<!-- 日付・時刻・日時 -->
<p>開催日: {cf_date}[date('Y年n月j日')]</p>
<p>開場: {cf_open_time}</p>
<p>受付終了: {cf_deadline}[date('Y/m/d H:i')]</p>

<!-- 数値 -->
<p>料金: {cf_price}[number_format]円</p>

<!-- 電話番号・メールアドレス・URL -->
<p><a href="tel:{cf_tel}">{cf_tel}</a></p>
<p><a href="mailto:{cf_email}">{cf_email}</a></p>
<!-- BEGIN cf_url:veil --><p><a href="{cf_url}">{cf_url}</a></p><!-- END cf_url:veil -->

<!-- ブロックエディター(HTML をそのまま出す) -->
<!-- BEGIN cf_note:veil --><div class="note">{cf_note}[raw]</div><!-- END cf_note:veil -->
<!-- END_MODULE Entry_Field -->

保存される値の形

型

保存される値

例

テキスト・テキストエリア・電話番号・メールアドレス・URL

入力した文字列(入力の変換を設定していれば変換後)

東京国際フォーラム

セレクトボックス(単一)・ラジオボタン

選んだ選択肢の値

seminar

チェックボックス・セレクトボックス(複数選択)

選んだ選択肢の値を、選択肢の並び順に複数

parking、wifi

チェックボックス(単一の on/off)

チェック時の値(既定 on)。外すと空

on

日付・時刻・日時

表示フォーマットの形の文字列

2026-11-10、09:30、2026-11-10 09:30

数値

半角の数値

1500、1.5

隠し値(hidden)

値

v1

ブロックエディター

HTML

<p>…</p>

Twig で書く

Twig を使うテーマでは、フィールドを取り出すモジュールの fields から読みます。

  • 1 つの値は f.キー.value、すべての値は f.キー.array で読みます。

  • 数字だけの値は数値に、true / false は真偽値に、空の値は null になります。先頭が 0 の 2 文字以上の値(電話番号など)は文字列のままです。

  • ブロックエディターの値は |raw で出します。ほかの値には |raw を使わないでください。

{% set f = module('V2_Entry_Field').fields %}

{% if f.cf_lead.value %}<p class="lead">{{ f.cf_lead.value }}</p>{% endif %}
{% if f.cf_body.value %}<p>{{ f.cf_body.value|nl2br }}</p>{% endif %}

{% set typeLabels = {'seminar': 'セミナー', 'workshop': 'ワークショップ'} %}
<p>種類: {{ typeLabels[f.cf_type.value] ?? '' }}</p>

{% set featureLabels = {'parking': '駐車場あり', 'wifi': 'Wi-Fi あり'} %}
{% if f.cf_features.array %}
<ul class="features">
  {% for feature in f.cf_features.array %}
  <li>{{ featureLabels[feature] ?? feature }}</li>
  {% endfor %}
</ul>
{% endif %}

{% if f.cf_reserved.value == 'on' %}<p>要予約</p>{% endif %}

<p>開催日: {{ f.cf_date.value|date('Y年n月j日') }}</p>
<p>料金: {{ f.cf_price.value|number_format }}円</p>
<p><a href="tel:{{ f.cf_tel.value }}">{{ f.cf_tel.value }}</a></p>

{% if f.cf_note.value %}<div class="note">{{ f.cf_note.value|raw }}</div>{% endif %}

つまずきやすい点

  • 値が出ないときは、まずモジュールの種類と書く場所を確かめます。エントリーのカスタムフィールドは、entry:loop の外に書いても出ません。

  • 表示名が出ない(値が出る)のは仕様です。選択肢は値を保存します。

  • 日付の表示フォーマットを変えた場合、[date(...)] で読めない形(例: Y年m月d日)にすると、並べ替えや整形に使いにくくなります。保存の形は既定の Y-m-d を勧めます。

  • ほかのよくある問題は「よくあるつまずきと注意点」を参照してください。