テンプレートでの出力(基本の型)
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
値は、フィールド定義のキーで、従来のカスタムフィールドと同じテーブルに保存されます。そのため、従来のカスタムフィールドと同じモジュール・同じ変数で出せます。メディア・参照・地図などは「テンプレートでの出力(メディア・参照・地図・アップロード)」を参照してください。
値を出すモジュールと書く場所
対象 | 標準のテンプレート | Twig |
|---|---|---|
エントリー | エントリーの詳細ページの |
|
カテゴリー |
|
|
ブログ |
|
|
ユーザー |
|
|
モジュール | そのモジュール ID のモジュールの | V2 モジュールの戻り値の |
このページの例は、エントリーの詳細ページで 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 の特殊文字はエスケープされます。 |
| 値があるときだけ中を出します。 |
| 複数の値を 1 つずつ出します。 |
| 複数の値のうち、何番目かを出します(0 から数えます)。 |
| 改行を |
| 日付の形を変えます。 |
| 3 桁区切り・小数部の桁数をそろえます( |
| エスケープせずに出します(ブロックエディターなど HTML の値だけに使います)。 |
| 値で出し分けます。 |
セレクトボックス・チェックボックス・ラジオボタンは、選んだ選択肢の「値」を保存します。表示名を出すときは、BEGIN_IF で値から読み替えます。
型ごとの例
次のフィールドを定義したときの例です。
キー | 型 | 設定 |
|---|---|---|
| テキスト | — |
| テキストエリア | — |
| セレクトボックス | 選択肢 |
| チェックボックス | 複数選択。選択肢 |
| チェックボックス | 「複数選択できるようにする」をオフ(単一の on/off) |
| 日付 | 表示フォーマットは既定( |
| 時刻 | 既定( |
| 日時 | 既定( |
| 数値 | — |
| 電話番号・メールアドレス・URL | — |
| ブロックエディター | — |
<!-- 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 | 入力した文字列(入力の変換を設定していれば変換後) |
|
セレクトボックス(単一)・ラジオボタン | 選んだ選択肢の値 |
|
チェックボックス・セレクトボックス(複数選択) | 選んだ選択肢の値を、選択肢の並び順に複数 |
|
チェックボックス(単一の on/off) | チェック時の値(既定 |
|
日付・時刻・日時 | 表示フォーマットの形の文字列 |
|
数値 | 半角の数値 |
|
隠し値(hidden) | 値 |
|
ブロックエディター | HTML |
|
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を勧めます。ほかのよくある問題は「よくあるつまずきと注意点」を参照してください。