「都道府県を選ぶと、その県の市区町村だけがプルダウンに出るようにしたい」。物件情報や施設情報を管理画面から登録するサイトで、まず出てくる要望です。そしてこれは、Advanced Custom Fields(ACF)の標準機能では作れません。ACFのセレクトフィールドは選択肢を静的に持つ設計になっているためで、プラグインの設定をどう探しても該当する項目は見つかりません。作るとすればPHPとJavaScriptの自作になります。ここでは不動産の物件登録システムで都道府県・市町村・路線・駅の4段を連動させたときの設計と、その後に必ず出てくる追加要望まで含めて書きます。
ACFのselectが連動しない理由
ACFのセレクトフィールドは、フィールドを定義した時点で選択肢が確定します。フィールドグループの編集画面に「選択肢」の入力欄があり、そこに書いた値がそのまま候補になる。この作りなので、「別のフィールドで選ばれた値によって候補が変わる」という状態を持てません。
acf/load_fieldというフィルタを使えば、フィールドを描画する直前に選択肢を差し替えられます。ただしこれはページが組み立てられる時点の処理です。編集画面を開いたまま都道府県のプルダウンを操作したときには、サーバーに問い合わせが行かないので何も起きません。ブラウザの中で完結する動きが必要な以上、JavaScriptを書くしかない、というのが結論になります。
やることは3つに分かれます。マスタデータをどこかに持つこと、そのマスタをブラウザから引ける形で出すこと、選択に応じて次のプルダウンを組み替えることです。見積りの段階でこの3つが工数に入っているかどうかで、金額も期間も変わります。「ACFで項目を追加するだけ」という前提で話が進んでいると、着手してから食い違いが出ます。発注する側としても、連動が要る項目がいくつあるかを先に伝えておくと、見積りの精度が上がります。
マスタをどこに置くかで、後の運用が決まる
いちばん設計が分かれるのがここです。都道府県が47、市区町村が1,700前後、鉄道の駅まで含めると1万件規模になります。この量をどう保持するかで、更新のしかたも実装の重さも変わります。
| 持たせ方 | 向いている場面 | 注意点 |
|---|---|---|
| ACFのフィールド設定に直接書く | 選択肢が数個で、今後も変わらない | 件数が多いとフィールドグループのエクスポートが巨大になり、扱えなくなる |
| CSVファイルとして持つ | マスタが外部由来で、更新のときは丸ごと差し替える | 置き場所と読み込みのキャッシュを決めておく。他の案件へそのまま流用できる |
| カスタム投稿タイプやタクソノミー | 運用者が管理画面から1件ずつ追加・編集したい | 件数が多いと管理画面の一覧が重くなる。本当に編集させる必要があるか先に確認する |
| 専用のテーブルを作る | 件数が多く、マスタ側でも検索や並び替えが要る | WordPressの標準機能から外れるため、サーバー移行やバックアップで持ち出し漏れが起きやすい |
不動産の案件で選んだのはCSVです。都道府県・市町村・路線・駅のマスタは、市町村合併や新駅の開業で変わりますが、変わるときは1件ずつ直すのではなく丸ごと差し替えたい種類のデータです。そして管理画面から編集させる必要がありません。CSVで持たせておくと、同じ構造の依頼が来たときにファイル一式をそのまま持っていけます。実際、この案件で作ったマスタは他の案件でも使えました。
逆に、選択肢が10件程度で、しかも運用側が自分で足したい種類のもの(自社の商品カテゴリなど)であれば、タクソノミーにしておくほうが素直です。判断の軸は件数ではなく、「誰が、どのくらいの頻度で、どう変えるか」です。
4段を連動させるときの実装の勘どころ
実装は次の順で組みます。
- マスタのCSVをPHP側で読み、必要な階層だけを返す関数を用意する
- 編集画面でその関数の出力をJavaScriptから引けるようにする
- 親のセレクトのchangeイベントで、子のセレクトを空にしてから作り直す
- 保存前に、送られてきた値がマスタに存在するコードかをPHP側で検証する
3番目に落とし穴があります。新規投稿では素直に動くのに、既存の投稿を開いたときに選択が消えるという不具合です。編集画面を開いた時点では、子のセレクトには選択肢が1つも入っていません。保存されている値だけがあって、それを表示するための候補が無い状態です。初期表示のタイミングで、親の値から子の候補を組み立て直し、保存済みの値を選択状態にする処理を明示的に書く必要があります。ここを忘れると、編集画面を開いて別の項目だけ直して保存した人が、意図せず住所を空にしてしまいます。
4段になると、階層をまたいだときの初期化も決めておく必要があります。都道府県を変えたら市町村は当然作り直しますが、路線と駅はどうするか。県をまたいで走る路線もあるので、一律に消すのが正しいとは限りません。仕様として先に決めておかないと、テストのたびに挙動が変わって見えます。
ブラウザに全件を送るのは避けます。都道府県を選んだ時点で、その県の市町村だけを返す。1万件の駅データを最初に全部読み込ませると、編集画面を開くだけで待たされます。ACFの管理画面はもともと軽くありません。
もう1つ、ACF側から見るとこのセレクトは「選択肢が空のフィールドにJavaScriptが値を入れたもの」です。ACFの必須チェックや値の検証は、マスタに存在する値かどうかまでは見てくれません。保存時にPHP側で照合する処理を自分で入れます。
値は保存されるが、ラベルは残らない
連動セレクトを作った案件のあとに、ほぼ必ず追加で依頼が来る改修があります。「一覧に市町村の名前を出したい」「投稿タイトルに地名を入れたい」というものです。
理由は単純で、JavaScriptで差し替えたセレクトは、選ばれたコード値だけが保存され、表示名が残らないからです。ACFのフィールド定義に選択肢が登録されていないので、get_field()を呼んでもコードしか返ってきません。フロント側に「13104」のような値が出てしまい、そこで気づきます。
対処はラベル取得のヘルパー関数を作ることですが、ここで市町村用・路線用・駅用と3つ作ると、マスタが増えるたびに関数も増えます。get_field_city_label($value)のような汎用の1関数にして、どのマスタから引くかを内部で判断させる形にしておくほうが保守が楽です。呼び出す側で1点だけ注意が要るのは、ACFのreturn formatの設定によってget_field()が配列を返すことがある点で、その場合はget_field('xxx')['value']を渡すことになります。ここは案件ごとに実物を確認したほうが早いです。
投稿タイトルの自動生成に組み込むときは、別の確認が要ります。「〇〇市の中古マンション」のようなタイトルを保存時に組み立てる処理を入れると、保存のたびにタイトルが上書きされます。手でタイトルを調整したい運用が残っていないかを、実装前に聞いておく必要があります。可変項目をどこまで自動で反映させるかは、ACFの繰り返しフィールドで可変レイアウトを作る実装と注意点でも同じ論点になります。
実際に出た不具合と、その原因
物件登録システムでは、物件の種別ごとにフィールドグループを分ける設計にしていました。中古マンション、1棟もの、区分店舗、戸建て、貸事務所、貸店舗、土地の7種別です。種別によって入力項目がまったく違うため、1つのグループにまとめると使わない欄が並びます。
この構成で出たのが、検索フォームのセレクトボックスに別の種別の選択肢が混ざる、という不具合でした。症状としては、中古マンションを探しているのに土地用の項目の候補が並ぶ。原因は、検索側が種別を区別せずフィールドを走査していたことです。フィールドを種別で分けたなら、参照する側も種別で絞る。当たり前のようですが、登録側だけ見て設計すると抜けます。修正は検索側のフィールド参照範囲を種別で限定することで済みました。フロント側の絞り込みをどう組むかはタクソノミーで絞り込み検索を作る手順とoptgroupの罠にまとめています。
もう1つがマスタとデータのズレです。マスタのCSVを新しいものに差し替えたとき、既存の投稿に入っているコードが新しいマスタに存在しないと、ラベルの取得が空になって表示が壊れます。市町村合併でコードが変わる場合が典型です。差し替えるときは、既存投稿に入っている値の一覧を先に取り、新マスタに存在するかを突き合わせる工程を挟みます。
データ投入型のサイトでは、テンプレート側の値チェック不足も表面化します。ある施設検索サイトでは、表計算ソフト経由で流し込んだ施設データに欠損があり、いくつかの個別ページでPHPのエラーが出ていました。テンプレートが値の存在を確認せずに配列やオブジェクトへアクセスしていたためです。対処としては、テンプレート側にempty()のチェックとデフォルト値を先に仕込むこと、そして公開前に全ページをプログラムで巡回して200が返るかを確認することです。手で数ページ見て終わりにすると、欠損のあるデータだけが漏れます。
細かいところでは、入力欄の型と単位も指摘を受けやすい部分です。建蔽率や容積率の「%」、面積の「㎡」や「坪」は、ACFのappend/prependで最初から欄に付けておく。数値項目をテキスト型のままにしておくと、スマートフォンで入力するときにキーパッドが数字にならず、全角の数字も通ってしまいます。number型にしておけば両方防げます。この手の指摘は、公開直前に一気に来ます。
種別が増えるほど、工数は掛け算になる
連動セレクトそのものより、規模を読み違えるほうが痛手になります。物件種別が7つあり、1種別あたりの入力項目が数十ある場合、フィールドの定義、登録画面の調整、一覧と詳細のテンプレート、検索側の対応が、全部種別の数だけ増えます。最初に数えるべきは「何種別あるか」です。
分類を細かくしすぎない判断も要ります。施設検索の案件では、競技の種別を細かく分けるとアイコンの点数が跳ね上がるため、たとえばサッカーの人工芝・天然芝・土といった違いはアイコンを分けず、テキスト表記で吸収しました。選択肢を1つ増やすたびに、マスタも分岐も表示も増えます。「あとから足せる形にしておく」ことと「最初から全部作る」ことは違います。カスタムフィールドで検索や並び替えができる一覧ページの作り方で書いたとおり、検索側の複雑さは項目数にそのまま比例します。
よくある質問
連動プルダウンのプラグインでは足りませんか
都道府県から市区町村までの2段であれば、既製のもので足りることがあります。判断が分かれるのは、マスタを自分たちで差し替えたいかどうかと、階層が3段以上になるかどうかです。マスタの更新方法が運用に合わないと、結局そこを作り直すことになり、既製のものを入れた意味が薄れます。3段以上でマスタも自前で持つなら、最初から作るほうが見通しが立ちます。
フロント側の検索フォームでも同じ連動が使えますか
使えます。マスタを返すPHP側の処理は共通化して、画面の組み立てだけ別に書くのが素直です。管理画面用に書いたJavaScriptをそのままフロントで読ませると、ACFの管理画面に依存している部分で動かなくなります。共通にするのはデータを返すところまで、と割り切ったほうが結果的に短く済みます。
すでに物件データが入っている状態でも導入できますか
できます。ただし既存のデータで住所がテキストとして入力されている場合、コード値への変換が別作業になります。「東京都渋谷区」「渋谷区」「渋谷」のような表記ゆれの分だけ、機械的に変換できない行が残ります。件数を先に数えて、変換できない分を手で直すか、旧データはテキストのまま表示するかを決めてから着手します。
マスタは何件くらいまで扱えますか
選択のたびに必要な範囲だけを返す作りにしていれば、駅まで含めた1万件規模でも問題ありません。重くなるのは、編集画面を開いた瞬間に全件をブラウザへ送っている場合です。表示が遅いという相談を受けたときは、まずこの点を確認します。
入力の連動やマスタの持たせ方は、あとから直そうとすると既存データの移し替えまで含めた作業になります。仕様が固まりきっていない段階でも、どこを可変にしておくべきかの整理からお引き受けしています。