求人、物件、店舗、施設。件数が数十を超えたあたりで、一覧を上から順に見てもらう運用は成立しなくなります。そこで「勤務地」「職種」「雇用形態」のような条件で絞り込める検索フォームを付けたい、という話になります。WordPressで作る場合、この条件はカスタムタクソノミーで持たせるのが素直な設計です。ただし、設計に入る前に決めておかないと後から作り直しになる分岐が1つあります。親のカテゴリそのものを選択肢にする必要があるかどうかです。ここを確認せずにHTMLのoptgroupで組むと、要件を満たせないことが後半で判明します。
作るものの内訳
絞り込み検索と一口に言っても、手を入れる場所は3つに分かれます。1つ目が条件を選ぶフォーム、2つ目がその条件で投稿を取り出すクエリ、3つ目が結果を並べる一覧と、その下のページ送りです。見た目の作業はフォームに集中しますが、あとから不具合として返ってくるのは2つ目と3つ目です。
投稿の側は、カスタム投稿タイプを1つ用意し、絞り込みたい条件の数だけカスタムタクソノミーを登録します。求人であれば、職種、勤務地、勤務時間帯といった単位です。条件が階層を持つ場合、たとえば「関東」の下に「東京」「神奈川」がぶら下がる形は、タクソノミーの親子で表現します。編集画面でチェックを入れるだけで登録できるので、運用する人にとってはこれが最も扱いやすい形になります。
ここでよく迷うのが、タクソノミーではなくカスタムフィールドで持たせるべきかどうかです。判断は単純で、絞り込みの条件として使うならタクソノミー、表示するだけの情報ならカスタムフィールドです。給与額や面積のように数値の範囲で絞りたいものはカスタムフィールドで持ち、クエリ側で範囲指定をかけます。その形についてはカスタムフィールドで検索や並び替えができる一覧ページの作り方のほうに書いています。
設計の分かれ道:親そのものを選べる必要があるか
階層のあるタクソノミーをセレクトボックスに出すとき、最初に思いつくのがHTMLの optgroup です。親タームをグループの見出しにして、その下に子タームを並べる。見た目は整然としますし、選択肢が多いときは読みやすくなります。
ところが、optgroup のラベルは選択できません。これはHTMLの仕様で、グループの見出しはあくまで見出しであり、選択肢ではないためです。つまり「関東」を選んで関東全域を検索する、という動きは optgroup では作れません。選べるのは「東京」「神奈川」といった子だけです。
この制約は、実装が半分ほど進んでから顕在化します。フォームの見た目ができて、依頼した側が触ってみて「親のほうが選べないのですが」となる。そこから設計をやり直すことになります。実際に、この確認を先に取っていなかったために組み直しが発生した案件があります。
| 要件 | 取るべき形 | 実装 |
|---|---|---|
| 子だけ選べればよい | optgroup でグループ化 | 親を <optgroup label>、子を <option> にする |
| 親でまとめて検索したい | 全件を <option> にする | 子の表示ラベル先頭に「→」や全角スペースを付けてインデントを表現する |
| 親を選んだら子を出す | 2段階のセレクトボックス | 親の選択に応じて子の選択肢を差し替える |
| 複数の条件を組み合わせる | チェックボックス | 配列で受け取り、クエリ側で結合の条件を指定する |
2行目の「先頭に記号を付けてインデントする」は、見た目としては素朴ですが、要件を確実に満たします。親も子も同じ <option> なので、どちらを選んでも検索が成立します。階層を表現したいだけなら、この方法で足ります。
親と子を出し分ける処理そのものは、1行の判定で済みます。タームのオブジェクトが持つ parent の値が 0 なら、それはトップレベルの親です。$term->parent == 0 という条件だけで、「親のみ表示」「子のみ表示」「親を見出しにして子を並べる」のどれにも切り替えられます。階層のあるタクソノミーを扱う実装では、この分岐が中心になります。
実装の要点
フォームのHTMLは searchform.php に置きます。テンプレート側から get_search_form() を呼べばこのファイルが読み込まれるので、一覧ページでも検索結果ページでも同じフォームを使い回せます。選択中の値をフォームに反映させる処理も、ここに1か所書いておけば全ページで揃います。
受け取った条件で投稿を取り出す部分は WP_Query の tax_query です。条件が複数あるときは、それぞれをタクソノミー単位の配列にして並べ、全体の結合方法を relation で指定します。
$args = array(
'post_type' => 'recruit',
'posts_per_page' => 20,
'tax_query' => array(
'relation' => 'AND',
array(
'taxonomy' => 'jobarea',
'field' => 'slug',
'terms' => $area,
),
array(
'taxonomy' => 'jobstatus',
'field' => 'slug',
'terms' => $status,
),
),
);
$the_query = new WP_Query( $args );relation を AND にすると「勤務地が東京、かつ夜勤」という絞り込みになり、OR にすると「どちらかに当てはまる」になります。ここは要件の言葉と実装がずれやすいところで、依頼の文面にある「かつ」「または」を、この1語に落とし込む作業だと考えてください。なお、親タームを選んだときに子タームの投稿まで含めるかどうかは include_children で制御します。既定では含まれるため、「親を選んだのに子の投稿しか出ない」という状態にはなりませんが、逆に「親に直接ひも付いた投稿だけを出したい」場合は明示的に切る必要があります。
件数の表示は、ループを回す前に出せます。$the_query->found_posts がその条件に一致する総件数を持っているので、「◯件見つかりました」を結果一覧の上に置けます。foreachの中で数え上げる必要はありません。
ハマりどころ
実装そのものより、動き始めてから指摘されるものを先に挙げます。
1つ目が、フォームの初期状態です。チェックボックス形式の検索フォームで、何も選んでいない状態を「すべて選択済み」として組んでしまうと、初期表示で全部にチェックが入った状態になります。多段階の選択UIでは特に起きやすく、初期化の書き忘れがそのまま画面に出ます。何も選ばれていない状態と、全部が選ばれている状態を、コード上で明確に分けてください。
2つ目がページ送りです。絞り込んだ結果を非同期で切り替える作りにすると、ページ番号のリンクを組み立てる部分が弱点になります。ページ番号をリンクの表示テキストから取ってはいけません。「«」「前へ」「最後へ」のような数字でないリンクを1つ足した瞬間に、その方式は破綻します。リンク側に data-page のような属性で番号を持たせ、そこから読む形にしてください。実際に、表示テキストから番号を取る実装で、矢印を追加したときに動かなくなった案件があります。
同じくページ送りで、表示するページ番号の数も設計に含めます。「現在のページの前後2件」という組み方だと、1ページ目や最終ページの付近で表示される番号が減り、「表示が少ない」と必ず指摘されます。端に寄ったら反対側にずらして、常に一定の件数を出す。この形にしておけば指摘は出ません。そして、同じ検索用のスクリプトを複数のページで使い回している場合、1ページだけ直しても他のページには残ります。修正の前に、そのスクリプトを読み込んでいるページを全部洗い出してください。1ページ見落としたために、直したはずの不具合が再度報告される、というのはよくあります。
3つ目が、非同期のページ送りに共通する制約です。ブラウザの戻る・進むや、絞り込んだ状態のURLを人に共有する動きに対応していないことが多く、これは実装方式そのものから来ます。必要かどうかを先に確認しておくと、あとから設計変更にならずに済みます。
4つ目がキャッシュです。JavaScriptやCSSを更新したときに「ボタンが効かない」という報告が来たら、まずブラウザキャッシュを疑ってください。納品の連絡に「Ctrl+F5で読み込み直してください」と最初から入れておくだけで、無駄な調査が消えます。
実際にあった事例:求人サイトの絞り込みと、多段階の検索フォーム
求人情報のカスタム投稿に対して、職種・勤務地・勤務時間帯の3つのタクソノミーで絞り込めるようにした案件があります。optgroup の制約が判明したのがこの案件で、親タームを選択肢にする形へ組み替えて着地しました。
この案件でやってよかったことが1つあります。着手前に、編集する予定のファイルを列挙して共有したことです。検索フォーム、検索結果、一覧テンプレートの3つに手を入れ、共通の関数を置くファイルには触らない、と先に宣言しました。稼働中の本番サイトで、依頼した側も並行して作業をしている状況だったため、どちらが何を触ったのかを後から追える状態になっていたのが効いています。実際、作業期間の途中で「見覚えのない検索フォームが表示された」という報告がありましたが、こちらの変更範囲が明確だったため、すぐに切り分けられました。
もう1つ、地域の階層と属性を組み合わせて段階的に絞り込むタイプの検索フォームを作った案件もあります。こちらは条件の追加が何度も発生し、選択肢に使うタグを増やす、複数条件の同時指定に対応する、結果の件数を表示する、といった要望が段階的に積み上がりました。この過程で分かったのは、検索に使う項目を増やすたびにテーマファイルを編集する設計は、運用上の負債になるということです。短期的には作業が発生しますが、依頼した側から見れば、選択肢を1つ増やすたびに外部への発注が必要になります。設計の段階で「管理画面から検索対象を選べるようにするか、都度の編集にするか」を決めておくのが本来の姿です。
この案件で明確に効いた判断がもう1つあります。テスト環境で完成させたあと、テーマ全体を本番へ上書きせず、機能単位で必要な部分だけを本番に足したことです。テスト環境と本番では、カテゴリーやタグに割り当てられるIDが違います。丸ごと移すと、検索の条件に埋め込んだIDが本番の別の項目を指してしまい、静かに壊れます。IDが異なる可能性があることは、作業に入る前に共有しておいてください。
加えて、通販機能と記事のタクソノミーが連携しているサイトでは、カテゴリの構造を変える前に影響範囲を確認します。商品側のデータと記事のカテゴリがひも付いている構成では、記事側のつもりで触った変更が商品側を壊します。物件や求人のような一覧ページ全体の構成は不動産の物件一覧ページをWordPressで作るときの構成と求人・施設一覧をカスタム投稿で作るときのテンプレート構成にまとめてあります。
運用が始まってからの注意
納品時に、変更したファイルの一覧を渡してください。検索フォーム、テンプレート、スタイル、スクリプト。どこに手が入っているかが分かれば、後で別の会社に引き継ぐときにも、自分たちで触るときにも迷いません。これは引き渡しの定型項目にする価値があります。
そして、絞り込みの条件は運用の中で必ず増えます。増やしたときに、フォームの選択肢、クエリの条件、結果の表示の3か所すべてに反映されるか。1か所だけ足して、他が古いまま、という状態が最も見つけにくい不具合になります。条件を1つ増やす手順を、納品時に書き残しておいてください。検索フォームの設計から実装までを任せたい場合は開発の対応内容に対応範囲を書いています。
よくある質問
絞り込みプラグインを使うのと、作るのとではどちらがよいですか
条件が少なく、階層も無く、見た目にこだわらないのであれば、プラグインで足ります。作る判断になるのは、親のタームを選択肢に含めたい、条件を段階的に出し分けたい、既存のテーマのデザインに合わせたい、といった要件が出てきたときです。プラグインの設定画面で表現できる範囲を超えた瞬間に、無理に設定で寄せるより作ったほうが速くなります。判断のためには、絞り込みたい条件の数と、それぞれが階層を持つかどうかを先に洗い出してください。
条件を選んでも結果が0件になります
まず、フォームから送られている値と、タクソノミーに登録されている値が一致しているかを確認します。field に slug を指定しているのに、フォームからはIDが送られている、というずれが最も多い原因です。次に、その条件に当てはまる投稿が実際に存在するかを、管理画面のタクソノミー一覧で件数を見て確かめてください。実装ではなく、単にデータが登録されていないだけ、ということもあります。
検索した結果のURLを共有したいのですが
フォームの送信方法をGETにしておけば、選んだ条件がURLのパラメータとして残るため、そのまま共有できます。非同期でページを書き換える方式にすると、この共有ができなくなります。共有や、ブラウザの戻る操作に対応する必要があるかどうかは、実装方式を決める前に確認しておいてください。あとから対応しようとすると、ページ送りの部分を含めて作り直しになります。
絞り込み検索は、フォームの見た目より、条件の持ち方と親子の扱いを最初に決めるかどうかで作業量が変わります。すでにあるサイトへの追加でも、条件の一覧と現在の件数をお知らせいただければ、実現できる形をお伝えできます。