Q.StudioからWordPressへ移るとき、StudioのCMSプロパティとACFのフィールドの対応表はどう作りますか？

WordPressへの引っ越しを考えるとき、StudioのCMSに入力してきたデータがどのような仕組みで成り立っているのか、全体像が把握しにくくて迷ってしまう場面があります。

Studioのデータは、モデル、アイテム、プロパティの3段で管理されています（StudioのCMSの基本）。モデルは「ブログ」「メンバー」のようにアイテムをまとめる入れ物です。アイテムは記事1本や人物1人分のデータで、プロパティはそのアイテムに付ける画像や公開日などの項目にあたります。

プロパティには、後から任意で増やせる項目のほかに、削除できないシステム定義の必須プロパティが存在します。記事タイプのモデルでは「本文」、ユーザータイプのモデルでは「アバター」が固定の必須項目です。さらに、ページのURLを決定づけるスラッグも削除できない必須プロパティとして扱われます。同じモデルの中で同じ値は使えず、入力ルールは半角英数字、ハイフン、アンダーバーのみ。動的ページのパスが blog/:slug でスラッグが about なら、公開URLは blog/about になります。

もうひとつ、データとページの見た目は別々に管理されています。データはCMSダッシュボード側で登録しますが、それだけでは公開サイトに表示されません。デザインエディタ側で画面上のボックスとプロパティを紐付けることで、初めて閲覧者の目に触れる形になります。公開ページに出ている項目と、CMSに入っている項目は同じとは限らないわけですね。

ちなみに、ACFは、編集画面に追加の入力欄を作るプラグインです。Studioのプロパティのうち、WordPressの標準項目に入らないものをACFで受けることになります。

Studioで使っていたプロパティは、WordPress側でどの標準機能やACFフィールドに割り振ればよいのでしょうか。

移行を始める際、すべてのプロパティをACFのカスタムフィールドへ移す必要はありません。WordPressの投稿オブジェクト仕様に示されている通り、WordPressの投稿には標準でタイトル、スラッグ、公開日時、本文、アイキャッチ画像が用意されています。Studioのタイトルはtitle、スラッグはslug、公開日時はdate、本文はcontent、代表画像はアイキャッチへと割り当てるのが自然な形です。投稿のdateはサイトのタイムゾーンでの公開日時なので、イベント日など別の日付まで入れる欄ではないでしょう。そうした日付は、ACFのDate PickerかDate Time Pickerで受けます。

標準の枠に収まらない追加プロパティに対して、ACFのフィールドを当てはめていきます。基本となる型の組み合わせは次の通りです。

• テキスト: Text
• 画像: Image
• 数値: Number
• ブール値: True / False
• リッチテキスト: Wysiwyg Editor

ただし、これは型を見比べた対応の候補で、公式の移行対応表があるわけではありません。外部リンクのURLをテキストプロパティに保存していた場合は、ACFのURLフィールドやLinkフィールドを選択します。

判断が分かれやすいのは、他のモデルとデータを結びつける参照プロパティの扱いです。カテゴリーやタグのような分類として扱いたいデータなら、WordPress標準のタクソノミーへ移行します。一方で、特定のライター情報や関連する別記事を直接結びつけたい場合は、ACFのRelationshipフィールドを選択するのが適しています。Relationshipフィールドは設定次第で投稿オブジェクトや投稿IDの配列を出力できるため、テンプレートでの表示方法に合わせて受け取る形式を決めておきましょう。

いざ移行の設計書を作ろうとしても、対応表にどんな列を用意すれば作業の漏れを防げるのか迷ってしまう読者も多いはずです。

StudioはCMSデータもページ情報も書き出せないため（Studioのエクスポート仕様）、対応表は手作業で移すときのチェック表も兼ねます。公開ページのデータや管理画面の内容を確認しながら移し替える作業が中心になるため、事前の対応表がそのまま移行の設計図になります。

なお、ACFのフィールド設定一覧で定められているように、フィールド名は空白を含まない単一語で指定し、アンダースコアやハイフンを用いて命名しましょう。英小文字にそろえるかどうかは決まりではないので、チームの命名ルールとして決めます。

必須の列は2つに分けます。Studioの必須プロパティは、削除できないシステム側の項目という意味です。ACFの必須は入力のチェックで、空のまま投稿を保存するとエラーが出ます。同じ「必須」でも意味が違うので、同じ列にまとめると混乱しやすいですね。

Studioで記事に挿入していた画像や添えられたキャプション、複数枚の画像プロパティは、どのようにWordPressへ移せばよいのでしょうか。

StudioにはCMSのモデル構成やアイテムの内容を書き出す機能がないので、画像もWordPressのメディアライブラリへ入れ直すことになります。外部サーバーのURLを直接参照し続ける方法もありますが、参照元が削除されたり接続が途絶えたりすると画像が表示されなくなるリスクを抱えます。画像データはWordPress側へ直接取り込んでおくのが無難な進め方です。

キャプションはWordPressのメディアライブラリで画像ごとに編集できます。Studio側で登録していた説明文は、WordPress側のキャプション欄へ手動で移し替えます。また、Studioのリッチテキスト内の画像にはクリック時の遷移先URLが埋め込まれている場合もあるため、リンク設定の有無も忘れずに点検しましょう。

複数画像を1つの欄で管理したいときは、ACFのGalleryフィールドが候補です。ただ、GalleryはACF PROの機能で、無料版にはありません。Galleryの中でも、画像ごとにキャプションを編集できます。