はじめてのフィールド定義


この機能は 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」にしたときだけ入力欄が出ることを確かめます。

次に読むページ