物件、求人、施設、店舗。投稿にカスタムフィールドを足していく作業自体は、管理画面から数分で終わります。難しくなるのは、その値で「探せる」ようにした瞬間からです。賃料で絞る、面積の広い順に並べる、募集中だけ出す。依頼の文面では一行の要望に見えても、中で起きていることはまったく別で、しかも後から項目を足すほど重くなっていきます。どこまでを検索対象にするかを最初に決めておくかどうかで、この先の運用コストが変わります。
「並べ替え」と「絞り込み」は、まず言葉を揃える
一覧ページの依頼で最初に食い違うのがここです。賃料の安い順に並べる機能を実装して確認してもらったところ、「募集中をクリックしたら募集中の物件だけが表示されると思っていた」と返ってきたことがあります。並べ替えは全件が出たまま順番だけが変わる機能で、絞り込みは条件に合うものだけが残って件数が減る機能です。作る側には自明でも、依頼する側にとっては「一覧を操作する機能」というひとくくりです。
この確認を先に一往復入れておくだけで、実装後の作り直しが消えます。並べ替えだけでよいのか、絞り込みも要るのか、両方要るならどの項目でか。三つの質問で済みます。実装後に絞り込みを足すと、クエリの組み立てもフォームも作り直しになるので、追加の工数として見積もり直す話になります。
どのテンプレートが効いているかを、先に確定させる
一覧にカスタムフィールドの値を出す作業は、コードを書く時間より「どのファイルが表示に使われているのか」を突き止める時間のほうが長くなります。標準の投稿でカテゴリ一覧を出しているなら category-{スラッグ}.php、カスタム投稿タイプにカスタムタクソノミーを紐づけているなら taxonomy-{タクソノミー名}-{ターム名}.php が候補になります。
やっかいなのは、Custom Post Type UI などでカスタム投稿タイプを作りながら、分類だけは標準のカテゴリを流用している構成です。この形だと、カスタム投稿の編集画面でカテゴリを選んでも標準のカテゴリ一覧には出てきません。「カテゴリを選んでいるのに一覧に出ない」という症状はプラグインの不具合に見えますが、実際にはタクソノミーの参照関係の問題です。
さらに、管理画面のメニュー表示名は自由に変えられます。「投稿」が「入居受入中の施設一覧」という名前になっていることがあり、画面を見ただけでは標準の投稿なのかカスタム投稿タイプなのか判別できません。表示名ではなく、投稿タイプ名とタクソノミーのスラッグで判断してください。着手前に「投稿タイプ」「タクソノミー」「一覧のURL」の対応関係を書き出して確認を取る。これだけで手戻りの大半が消えます。求人や施設の一覧を組む場合の構成は求人・施設一覧をカスタム投稿で作るときのテンプレート構成にまとめています。
検索対象にする項目を、最初に絞る理由
カスタムフィールドの値は wp_postmeta というテーブルに、投稿IDとキーと値の組み合わせで保存されます。この構造で「賃料が10万円以下、かつ間取りが2LDK、かつ最寄駅が徒歩10分以内」のような検索をすると、条件を一つ足すごとにテーブルの結合が一つ増えます。投稿が100件の段階では誰も気づきませんが、1,000件を超えたあたりから体感できる遅さになり、「検索が重い」という別件の相談になります。
だから設計の最初に、項目を三つに仕分けます。検索と並べ替えの対象にするもの、一覧に表示するだけのもの、詳細ページでしか使わないもの。この三つです。検索対象は、実際に使われる数個に絞り込みます。全項目で検索できる一覧は、一見親切に見えて、使う人にとっても選択肢が多すぎて使いにくくなります。
| 項目の使われ方 | 持たせ方 | 検索 | 並べ替え |
|---|---|---|---|
| 毎回条件に使う(価格・エリア・種別) | 単独のカスタムフィールド、または分類として持つ | する | する |
| 一覧に出すが条件にはしない(写真・キャッチ) | カスタムフィールド | しない | しない |
| 詳細ページだけで使う(設備・備考) | まとめて1項目でも可 | しない | しない |
| 行が増えていく(履歴・複数の担当者) | 繰り返しフィールド、または別投稿タイプ | 向かない | 向かない |
最後の行は補足が要ります。繰り返しフィールドに入れた値は、保存されるキーに行番号が含まれます。1行目と4行目では別のキーとして扱われるため、「何行目でもよいからこの値を含む投稿」という条件が素直に書けません。検索したい値は繰り返しの中に入れない、と覚えておけば足ります。
実装で必ず踏む三つのバグ
カスタムフィールドでの絞り込みは WP_Query の meta_query で組みます。ここで起きる不具合は、経験上ほぼ三種類に収束します。
一つ目は数値比較が文字列比較になっているパターンです。'type' => 'NUMERIC' の指定を忘れると、値が文字列として比較され、価格や面積の範囲検索で桁数の違う数字が正しく並びません。「1000万」が「900万」より小さいと判定される、あの症状です。二つ目は relation の指定漏れで、複数条件を入れ子にする場合は各階層それぞれに relation が必要になります。三つ目が最も見つけにくく、未入力の条件をそのまま条件配列に入れてしまうケースです。値が空でも条件としては生きているので、何も選んでいないのに結果が減ります。空チェックを通してから条件を積むだけで防げます。
$meta = array( 'relation' => 'AND' );
if ( $_GET['rent_max'] !== '' ) {
$meta[] = array(
'key' => 'rent',
'value' => (int) $_GET['rent_max'],
'compare' => '<=',
'type' => 'NUMERIC',
);
}条件が五つを超えたら、組み立て方を変える
meta_query は条件が増えるほど結合が積み上がります。保育施設向けの求人サイトで、勤務地の範囲、職種、雇用形態、給与といった条件を同時に受ける検索を組んだ例では、meta_query を使わず posts_clauses フィルタで直接WHERE句を書き換える方式が採られていました。条件をまとめてEXISTSのサブクエリとして注入する形で、条件数が増えても結合が増えません。値は $wpdb->prepare() を通します。
ただしこれは万能ではありません。SQLを直接書き換える以上、多言語化プラグインや検索拡張プラグインなど、同じフックでSQLを触る他のプラグインと衝突する可能性があります。条件が二つ三つで済むなら素直に meta_query で書き、増えてきたら移行を検討する、という順序が現実的です。
この方式では、検索フォームそのものをカスタムフィールドの定義から自動生成する作りも併用されていました。項目を追加すればフォームにも反映されるので運用は楽になりますが、フィールドグループの識別子をコードに直書きしていると、サーバー移行時にフィールドを作り直した時点でフォームが空になります。移行するときは定義をエクスポートしてそのまま持っていく必要があります。
実際にあった事例:物件一覧をページごとに増やせるようにする
不動産の物件情報を、物件番号、状態、種別、間取り、建物面積、賃料、保証金、交通、設備条件といった独自項目で登録しているサイトからの相談でした。要望は、エリアごとの物件一覧ページを作り、賃料での並べ替えと、募集状態での絞り込みを付けること。
作りは、一覧を出力するショートコードと、専用のページテンプレートの組み合わせにしました。ショートコードは [show-article-list area="○○市"] のように条件を引数で受け取ります。こうしておくと、新しいエリアの一覧が欲しくなったときに、固定ページを一枚作ってショートコードのエリア名を書き換え、ページテンプレートを選ぶだけで済みます。作業手順が三つに収まるので、その後のエリア追加は事業者側で完結し、追加の開発費用は発生しません。似た構成を店舗一覧に応用した例は店舗一覧と店舗ページを1つのサイトで運用する構成の作り方にあります。
作業中に効いたことが二つあります。列数の多い一覧は表の横幅が足りなくなりますが、専用のページテンプレートを用意しているので、そのテンプレートからサイドバーの出力を外すだけで解決しました。もう一つは確認作業です。既存の項目と一覧に出す列名の対応付けで、賃料の列に保証金が入っていた取り違えが起きました。この種のマッピングのミスは、数字が並んでいるだけなので目視では気づきにくく、実データで金額の大小関係がおかしくないかを見て初めて分かります。保証金が賃料より小さい、といった不自然さを確認項目に入れておくべきです。列名と既存項目名の対応表を先に作って承認をもらうと、確認そのものが速くなります。物件系の一覧全体の考え方は不動産の物件一覧ページをWordPressで作るときの構成にまとめています。
納品してからのほうが長い
カスタムフィールドを扱う実装では、フィールドの識別子と項目名の対応表を作業メモとして残しておいてください。半年後に一項目足すだけの依頼が来たとき、この対応表があるかないかで調査時間が変わります。
ページテンプレートはテーマの中に置くファイルなので、テーマを更新すると消えます。親テーマを直接触っている構成なら、子テーマ化できるかを先に確認しておきます。出力するHTMLには意味のあるクラス名を付けておくと、見た目の調整を事業者側やデザイン担当が行えるようになり、責任の分かれ目もはっきりします。実装側はHTMLの出力まで、見た目のCSSはそちら側、という線を納品時に伝えておくと、「実装したのに表示に出ていない」というやり取りが減ります。ソース上は出力されていることを、ブラウザの検証機能で示せば数分で片が付きます。
よくある質問
プラグインで済ませることはできませんか
項目が数個で、絞り込みの条件も単純なら、既製の検索プラグインで足ります。合わなくなるのは、範囲での検索、項目同士を組み合わせた条件、検索結果の並び順を独自に決めたい、といった要件が入ってきたときです。プラグインの設定で無理に寄せるより、その時点でクエリを自前で組んだほうが結果的に軽くなります。
すでに公開している一覧に、あとから絞り込みを足せますか
足せます。ただし既存のデータが検索に耐える形で入っているかを先に確認します。賃料が「10万円」のように単位付きの文字列で保存されていると数値として比較できないため、データの整形が先に必要になります。この整形作業のほうが、絞り込みの実装より時間がかかることがあります。
件数が増えてから遅くなった場合、どこから手を付けますか
まず実際に発行されているクエリを確認し、条件ごとの結合がいくつ生まれているかを見ます。そのうえで、検索対象から外せる項目がないか、分類として持たせ替えられる項目がないかを検討します。分類として持てる項目を分類に移すだけで、結合が減って速くなることは多いです。それでも足りなければ、SQLの組み立て方そのものを変える話になります。
どの項目で検索させるかを決めた時点で、その一覧の速さと拡張しやすさはほぼ決まります。これから作る場合の設計も、すでに重くなっている一覧の作り直しも承ります。