はじめてのフィールド定義
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
このページでは、エントリーにイベントの情報(開催日・会場・種類)を入力できるようにし、エントリーの詳細ページに表示します。画面の操作は、管理者の権限を持つユーザーで行います。
フィールドセットを作る
管理画面の「フィールド定義」で、対象「エントリー」のフィールドセットを追加します。ラベルは イベント情報、コードは event とし、有効にして追加します。追加したフィールドセットの編集画面で、フィールドを追加します。
フィールドを追加する
開催日・会場・種類の 3 つを追加します。
型「日付」: キー
cf_event_date、ラベル「開催日」、必須入力「公開時に必須」(キーの欄にはcf_が最初から入っています)。型「テキスト」: キー
cf_event_place、ラベル「会場」。型「セレクトボックス」: キー
cf_event_type、ラベル「種類」。選択肢は、値seminar・表示名「セミナー」と、値workshop・表示名「ワークショップ」の 2 つ。
キーはテンプレートで使う名前です
キーは追加した後は変えられません(変えるときは「キーを変更」を使います)。半角英字かアンダースコアで始め、半角英数字とアンダースコアで入力します。
編集画面で入力する
エントリーの編集画面を開くと、本文(ユニット)の上に「開催日」「会場」「種類」の入力欄が出ます。値を入力して保存します。
「開催日」は「公開時に必須」にしたため、ステータスを公開にして保存するときだけ、空だとエラーになります。下書きなら空のまま保存できます。
テンプレートで表示する
エントリーの詳細ページのテンプレートに、次のように書きます。値は {キー} で出します。
<!-- BEGIN_MODULE Entry_Field -->
<!-- BEGIN cf_event_date:veil -->
<dl class="event-info">
<dt>開催日</dt>
<dd>{cf_event_date}[date('Y年n月j日')]</dd>
<dt>会場</dt>
<dd>{cf_event_place}</dd>
<dt>種類</dt>
<dd><!-- BEGIN_IF [{cf_event_type}/eq/seminar] -->セミナー<!-- ELSE_IF [{cf_event_type}/eq/workshop] -->ワークショップ<!-- END_IF --></dd>
</dl>
<!-- END cf_event_date:veil -->
<!-- END_MODULE Entry_Field -->Entry_Fieldは、表示しているエントリーのカスタムフィールドを出すモジュールです。エントリーの一覧や本文のモジュール(Entry_Bodyなど)では、従来どおりentry:loopの中に書きます。<!-- BEGIN cf_event_date:veil -->は、開催日に値があるときだけ中を出します。セレクトボックスは選んだ「値」を保存します。表示名を出すときは、値で分岐して書きます。
Twig のテンプレートでは、次のように書きます。
{% set f = module('V2_Entry_Field').fields %}
{% set typeLabels = {'seminar': 'セミナー', 'workshop': 'ワークショップ'} %}
{% if f.cf_event_date.value %}
<dl class="event-info">
<dt>開催日</dt>
<dd>{{ f.cf_event_date.value|date('Y年n月j日') }}</dd>
<dt>会場</dt>
<dd>{{ f.cf_event_place.value }}</dd>
<dt>種類</dt>
<dd>{{ typeLabels[f.cf_event_type.value] ?? '' }}</dd>
</dl>
{% endif %}カテゴリーで出し分ける
イベント情報を「event」カテゴリーのエントリーだけに出すには、フィールドセットに表示条件を付けます。
フィールドセットの編集画面の「フィールドセットの設定」で、「表示条件」に「カテゴリー」が「のいずれかと等しい」の条件を追加し、「event」カテゴリーを選んで保存します。子カテゴリーのエントリーにも出すときは、範囲を「それと配下すべて」に変えます。
エントリーの編集画面で、カテゴリーを「event」にしたときだけ入力欄が出ることを確かめます。
次に読むページ
フィールドの追加と共通の設定: 必須・入力チェック・条件付き表示の詳しい設定
入力の型の設定(文字・選択・日付・数値): 型ごとの設定項目
テンプレートでの出力(基本の型): 型ごとのテンプレートの書き方
テーマでフィールド定義を宣言する: 作った定義をテーマに入れて、ほかのサイトでも使う
