スタッフと実績など、別の内容を結び付ける

関係と参照欄の役割を知り、同じ情報を何度も書かずに管理する設計を考えます。

目次

スタッフのプロフィールを一か所で管理し、複数の実績ページで使うことができます。 実績とスタッフの情報を関連付け、テーマに表示する処理を用意します。各ページへ同じ紹介文をコピーする手間を減らせます。

EmDashでは、この結び付きを**Relation(関係)**として定義し、**Reference(参照)**という入力欄から相手を選びます。URLを本文へ貼るだけのリンクとは、保存の仕組みが違います。

たとえば「実績Aの担当者は田中さん」と選び、田中さんの紹介文はスタッフ側に1つだけ保存します。実績Aのページは、その紹介文を読んで表示します。プロフィールを直すときは、元になるスタッフの情報を編集します。

準備するのは管理者と制作担当者です。編集担当者は、用意された参照欄から相手を選ぶところを担当します。最初にコレクションと入力欄を読むと、以下の作業場所をつかみやすくなります。

先に、何と何を結ぶか決める

コレクションは、同じ種類の内容をまとめる入れ物です。スタッフと実績を別のコレクションへ入れる場合、たとえば次のように設計できます。

決めることこの例での答え
選ぶ側実績
選ばれる側スタッフ
1つの実績に選べる人数複数人
1人が担当できる実績複数件

説明だけの設計例です。著者の署名が目的なら、EmDashの署名機能が合う場合もあります。似た名前の機能を重ねて作る前に、何を表示したいかを整理します。

管理者が関係と入力欄を準備する

2つのコレクションを用意したうえで、管理者が**Content Types → Relations(内容の種類 → 関係)**を開きます。

  1. **New Relation(関係を作る)**で、結ぶ2つの種類を選ぶ。
  2. Links fromに選ぶ側、Links toに選ばれる側を指定する。
  3. Rolesで画面に出る呼び名、Slugで関係を区別する名前を確認する。
  4. **How many(選べる数)を決める。この例では、両側をAny number(複数選択)にする。1人だけに限定する場合はOne(1つ)**を選ぶ。
  5. 関係を作り、実績側の**Add Field → Reference(入力欄を追加 → 参照)**で、その関係を選ぶ。

運用中のサイトでは、項目を追加するときの準備も行います。関係を作ったあとで、結ぶコレクションやスラッグを別物へ変更することはできません。

編集者は、コピーする代わりに選ぶ

実績の編集画面で**Add reference(参照を追加)**を開き、担当者を検索して選びます。実績の原稿と一緒に保存し、読者へ反映する段階で公開します。

反対側にも同じ関係の参照欄を作れば、スタッフ側から、その人と結び付く実績を確認できます。別々の名簿を2つ作るのではなく、ひとつの関係を両側から扱います。

履歴が有効なコレクションでは、公開済みの記事で相手を選び直しても、変更はまず下書きに保存され、公開したときに読者向けのページへ反映されます。プレビューでも選び直した相手を確認してください。

入力欄を作るだけでは、ページには表示されない

制作担当者が、選ばれたスタッフの紹介文を読み、実績ページに出す処理をテーマへ追加します。管理画面で田中さんを選べても、この表示処理がなければ読者には見えません。

コードでは、通常の本文などを読むentry.dataとは別に、関連する内容を読むreferences指定を使います。公式の関連付けガイド(別タブで開く)が実装の入口です。

確認するときは、担当者0人・1人・複数人を試します。選んだスタッフの情報が下書きの場合や、削除された場合にどう表示するかも決めます。選択欄に出ていても、読者へ公開してよい情報かを確認してください。

多言語化と削除で気を付けること

翻訳グループとは、日本語と英語など、同じ内容の翻訳版をひとまとめにしたものです。関係の選択は、このグループで共有されます。日本語版で選んだ相手は、英語版でも同じ組み合わせです。言語ごとに別の相手を選びたい設計なら、先に制作担当者と相談します。

また、参照欄の削除時には、関係そのものと保存済みの結び付きを消すかどうかも確認します。画面から入力欄を減らしたいだけなのか、関係を完全にやめたいのかを分けてから操作しましょう。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。