検索フォーム全体の設定
管理画面にログインし、左列メニューの「検索」ページを開くと、ページ上段に下記のようなセクションが表示されます。このセクションで、右上のドロップダウンで選択された検索フォームの全体的な設定を行います。設定はフォームIDごとに独立しています。
名称
検索フォームの名称を設定します。機能に影響するものではなく、管理しやすい名称を任意に設定してください。
フォームID
検索フォームのIDです。
検索対象の投稿タイプ
ターゲットとする投稿タイプ（Post Type）を指定します。これにより特定の投稿タイプに絞って検索することができます。「attachment」を選択した場合は、記事の編集画面において「メディアを追加」ウィンドウの「タイトル」欄に入力した文字（post_name）が検索されます。
Sticky Posts について
投稿 > 文書 > ステータスと公開状態 > 「ブログのトップに固定」にチェックを付けた記事も検索対象に含む場合はチェックを入れます。FEASはデフォルトではStick Postsを検索から省くようになっています。
固定タクソノミ/ターム
特定のタクソノミ/タームをあらかじめ検索条件として設定できます。ポータルサイトなど、１つのサイトに様々なジャンル/コーナーのコンテンツを作成してタクソノミ/タームで分類している場合に、それぞれのジャンル/コーナーの記事に絞った検索フォームを作成できます。
検索条件に件数を表示
「表示する」にチェックを入れると、各検索条件の右側に括弧付きの数字で、条件ごとの対象記事数を表示します。
検索結果から除外
検索結果から除外したい記事がある場合は、記事IDを半角カンマ区切りで入力することで、検索結果から省くことができます。
検索条件が指定されずに検索された場合
検索条件がいずれも指定されない状態で検索ボタンがクリックされた場合の挙動を選択できます。
- 0件を返す：検索結果には記事を表示しません（該当なし）。
- 固定タクソノミ/タームの記事の一覧を表示：前述の「固定タクソノミ/ターム」で設定した記事一覧を表示します。
検索結果の並び順
検索を実行した際に記事が並ぶ順序を指定できます。WordPressの標準では「投稿日の新しい順」に記事が並びますが、投稿日の他に下記の順で表示できます。
- 投稿日時 ＝ 投稿日の古い順/新しい順（昇順/降順）に並びます。
- タイトル ＝ タイトルの50音順（昇順/降順）に並びます。
- スラッグ ＝ 記事のスラッグ（URLに含まれる文字列）の50音順（昇順/降順）に並びます（スラッグを編集するには、設定 > パーマリンク設定にて、「共通設定」に%postname%が含まれる構造にした上で、記事編集画面のタイトル欄をクリックすると表示されるパーマリンクの「編集」ボタンをクリックして設定します）。
- カスタムフィールド ＝ 右隣に表示されるドロップダウンで指定したカスタムフィールドのキーの昇順/降順に並びます。価格やよみがななど、値の種別に応じて「文字列」か「数値」を指定してください。
- ランダム ＝ 検索を実行する度に、違った順に並びます。
オプションで第二条件を指定できます。第一条件でソートした際に同じ順位の記事がある場合に、それらの並び順を第二条件で指定できます。
昇順/降順
- 昇順 ＝ 値の小さい順（例：0〜99..、A〜Z、あ〜ん、ア〜ン）に並びます。
- 降順 ＝ 値の大きい順（例：99..〜0、Z〜A、ん〜あ、ン〜ア）に並びます。
カスタムフィールドのキー（カスタムフィールド選択時のみ）
- 作成済みのカスタムフィールドのキーが並びます。ソートの基準になるキーを選択してください。
数値/文字（カスタムフィールド選択時のみ）
- 数値 ＝ カスタムフィールドの値を数値として扱います。価格などでのソート時はこちらを選択
- 文字列 ＝ カスタムフィールドの値を文字列として扱います。よみがななどでのソート時はこちらを選択
数値が保存されたカスタムフィールドは注意が必要です。
- 「数値」の場合の並び順 ＝ 50、100、2000、10000
- 「文字列」の場合の並び順 ＝ 100、10000、2000、50
フォームの内容
全体設定の下部には、次のようなセクションが表示されます。
- 初期状態で、１つ目の検索パーツの詳細設定欄と検索ボタンが表示されています。
- 左下の「設定を保存」をクリックすると設定が保存されます。
※条件を１パーツ分設定するごとに「設定を保存」してください。保存せずに右上の「項目を追加」ボタンをクリックすると、直前の作業内容がリセットされます。 - 下部の「プレビュー」欄に保存した検索フォームの内容が反映されます（この段階では「投稿年月」のドロップダウンと検索ボタンのみ）。
- 作成する検索フォームに合わせてつくりこんでいきます。
見出し
検索パーツの前に挿入される文字列です。HTMLタグが使えます（省略可能）。例えば求人サイトにおいて業種のドロップダウンを表示する際に、「業種で検索」などと記述します。
条件
検索パーツに呼び出される条件（投稿年月/タグ/カテゴリ/カスタムタクソノミ/カスタムフィールド）を選択します。「投稿年月」は記事が公開された年月が表示されます（公開記事がある年月のみ表示）。「タグ」を選択すると、記事の登録があるタグの一覧が表示されます。カテゴリとカスタムタクソノミは、検索パーツに表示したいリストの親カテゴリ/タームを指定します。指定された親カテゴリ/タームの子カテゴリ/タームが検索パーツに表示されます。カスタムフィールドには登録のあるカスタムフィールドのキー一覧が表示されますので、検索対象とするキーを選択してください。
形式
- ドロップダウン ＝ １つの項目を選択できます。省スペースですが項目数が多い場合は使いにくくなります。
- セレクトボックス ＝ 複数の項目を選択できます（キーボードのShift/Ctrl（Windows）、Shift/Command（Mac）キーを使用）。
- チェックボックス ＝ 複数の項目を選択できます。一覧性が高いですが、スペースを取ります。
- ラジオボタン ＝ １つの項目を選択できます。性別/有無など、選択肢が少ない項目に向いています。
- フリーワード ＝ キーワード検索用です。キーワードを探す箇所（検索対象）を指定できます。
要素内の並び順
検索パーツ内の要素の並び順を設定します。
投稿年月は昇順/降順を指定できます。タグ/カテゴリ/タームはID/名称/スラッグ/ランダムの他、「カスタム」を選択した場合はプラグイン「Category Order and Taxonomy Terms Order」等のプラグインを併用して、各プラグインで設定した並び順で表示することができます。
複数選択時の検索方法
複数項目の選択ができる形式（チェックボックス/セレクトボックス）の場合のみ指定できます。
- OR検索 ＝同検索パーツ内で複数選択した場合、そのいずれかの項目に当てはまる記事を検索
- AND検索 ＝同上 そのすべての項目に当てはまる記事を検索
フォームの内容の２段目
未選択時の文字列
デフォルトで「—未指定—」と表示される文字列を変更できます。ラジオボタン形式の場合は、選択状態をリセットするためのラジオボタン（空のvalue）を表示するかどうかを「表示」のチェックボックスで指定できます。
前に挿入／後に挿入
検索パーツの前後に挿入するHTMLコードなどを記述します。
下記の様に記述し、使用中のテーマのスタイルシートに「.search-category」のCSSを記述することで検索パーツのデザインがしやすくなります。
前に挿入：<div class="search-category"> 後に挿入：</div>
または、インラインで下記のようにCSSを記述することもできます。
<div style="border:1px solid silver; padding:3px;"> <!--1ピクセルの薄いグレーの枠線で囲み、枠の内側に3pxの余白が付きます。-->
並び順
検索フォーム全体の中の各検索パーツの並び順を設定します。数値で並び順を指定し「設定を保存」ボタンでクリックしてください。
表示する
検索パーツの設定を残したまま一時的に検索フォーム上に表示しない場合「表示しない」に設定します。
消去
検索パーツを削除したい場合に「消去」にチェックを入れて「設定を保存」をクリックしてください。
除外ID（タグ/カテゴリ/ターム）
「条件」にタグ/カテゴリ/タームを設定したとき、特定のタグ/カテゴリ/タームを検索パーツに表示したくないときは、半角カンマ区切りでタグ/カテゴリ/タームIDを入力してください。
階層（カテゴリ/ターム）
「条件」にタグ/カテゴリ/タームを設定したとき、表示する子カテゴリ/タームの階層を半角数字で指定します。未入力または「-1」の場合は無制限（下階層がある限り表示）に表示します。例えば「0」を入力の場合は「条件」に指定した親カテゴリ/ターム直下の第一階層のみ、「 1」を入力の場合は、子カテゴリ/タームがある場合に1階層分がインデント表示されます。
また、後述の「Ajaxフィルタリング」を設定したとき、階層指定することで初期状態で表示するドロップダウンの数を指定できます。
登録件数が0件のカテゴリ/タームは表示しない（タグ/カテゴリ/タクソノミ）
登録が1件もないタグ/カテゴリ/タームを表示しない場合はチェックを付けます（親カテゴリ/タームが0件の場合、子カテゴリ/ターム以下も非表示となります）。
Ajaxフィルタリング（カテゴリ/タクソノミ）
※現状、ドロップダウン形式のみ対応
親カテゴリ/タームのドロップダウンの値を選択すると、その子カテゴリ/タームが存在する場合に、親カテゴリ/タームのドロップダウンの右隣に、子カテゴリ/タームのドロップダウンをJavaScriptで動的に表示します。初期状態では親カテゴリ/タームのドロップダウンのみが表示されています。前述の「階層」を指定することで、初期状態で表示するドロップダウンの数を指定できます（v1.7.7以降）。
都道府県から市区町村へと絞り込む場合、あるいは沿線から各駅名へと絞り込む場合など、下層カテゴリ/タームの数が膨大になる場合に特に便利です。
v1.7.7の新機能
「階層」を指定することで、初期状態で表示するドロップダウンの数を指定できます。たとえば階層に 3 と入力すると、第一階層のドロップダウンの他に空のドロップダウンがさらに2つ、合計3つのドロップダウンが生成されます。１つ目のドロップダウンで値を選択すると、その子カテゴリ/タームの内容が2つ目のドロップダウンに反映されます。3つ目も同様です。ただし、それより深く子カテゴリ/タームが存在する場合でもドロップダウンの数は固定となるため、それ以降の階層は検索条件に指定できません。
範囲検索（投稿年月/カスタムフィールド）
“料金” や “期間” など、ある範囲に該当する記事を検索することができます。 条件にアーカイブを選択した場合は、指定した期間に投稿された記事を検索できます。 条件にカスタムフィールドの”キー”を選択した場合は、検索条件に指定した範囲にそのカスタムフィールドの”値”が含まれる記事を検索できます。ドロップダウンとラジオボタン形式のみ範囲検索を実行できます。
範囲の扱い
投稿年月の場合は、前｜以前｜以後｜後、カスタムフィールドの場合は、未満｜以下｜以上｜超から選択できます。カスタムフィールドの場合は値の種別に応じて数値か文字列かを指定してください。
テキスト入力で範囲検索
チェックを入れると、ドロップダウン/ラジオボタンの代わりにテキストフィールドを表示し、エンドユーザーの任意入力の値で範囲検索することができます。
カスタムフィールドの値
単位を付与する
カスタムフィールドの値で範囲検索できるようにするには、カスタムフィールドの値には記号など含まず、数値のみを登録する必要があります。しかしドロップダウンなど検索パーツ内や検索結果ページに検索条件を表示する際には単位や区切りがあったほうが見やすいため、この機能を使用して補うことができます。設定した単位を値の前部/後部に付加します。おもに価格（1,000円、￥5,000）や重量（1kg、5,000t）などで使用することを想定しています。
3桁ごとに半角カンマで区切る（カスタムフィールド）
前項のとおり、検索パーツなどに表示する際、カスタムフィールドの数値を3桁ごとに半角カンマで区切りを入れます。
範囲検索の設定例：
上記のように２つの検索パーツを組み合わせ、それぞれの範囲の扱いを「以上」と「以下」に設定し、「テキスト入力で範囲検索」にチェックを入れると、下記のような「○○円以上〜○○円以下」という範囲検索が実装できます。
「単位」「3桁ごと〜」をしない場合／設定した場合のドロップダウンの見え方の違いを示します。
Smart Custom Fields 関連
カスタムフィールドの値を登録する際に便利なプラグインが多数ありますが、当プラグインと互換性がないもの（例：Advanced Custom Fields）もあり注意が必要です。数あるプラグインの中でもSmart Custom Fieldsは多機能で使いやすく、このプラグインを使って登録されたカスタムフィールドの値は当プラグインで検索可能です。いくつか特徴的な機能をもっており、それらに対応するための以下の設定項目を用意しています。
真偽値
関連する投稿
関連するターム
真偽値として扱う
「真偽値」に登録された値をそのまま検索パーツに表示すると「1」か「0」と表示されてわかりづらいため、この項目にチェックを入れることにより、下記「真の場合の文字列」に表示する文字列の記述と合わせて、検索パーツに意味がわかるかたちで表示できます（例：ペット：可）。検索パーツの「条件」には真偽値として設定したカスタムフィールドのキーを指定してください。
真の場合の文字列
前項のとおりです。値が「1」＝真の場合の文字列を入力してください。例えば「ペット可であるかどうか」で検索させたい場合、このテキスト欄に「ペット可」と入力することで、ラジオボタンの隣に「1」ではなく「ペット可」とわかりやすく表示できます。
関連する投稿 v1.7.7の新機能
真偽値と同様、そのままでは記事IDが表示されてわかりづらいため、この項目にチェックを入れることにより、記事IDに基づいて記事タイトルを取得し、記事IDの代わりに表示します。検索パーツの「条件」には関連する投稿として設定したカスタムフィールドのキーを指定してください。
関連するターム v1.7.7の新機能
真偽値と同様、そのままではタームIDが表示されてわかりづらいため、この項目にチェックを入れることにより、タームIDに基づいてターム名を取得し、タームIDの代わりに表示します。検索パーツの「条件」には関連するタームとして設定したカスタムフィールドのキーを指定してください。
キーワード（フリーワード）検索
検索対象
キーワード検索時の検索対象（キーワードを探す箇所）を選択します。WordPress標準の検索機能ではタイトルと本文しか検索できませんが、当プラグインでは下記の項目を指定できます。
- タイトル (post_title)
- 本文 (post_content)
- 抜粋 (post_excerpt)
- カスタムフィールド (meta_value)
キー（指定したキーのカスタムフィールド値のみ検索） - コメント (comment_content)
- 記事が属するカテゴリ/タグ名 (terms > name)
何も選択されていない場合は、1,2,4,6が検索対象となります。カスタムフィールドの「キー」は、半角カンマ区切りで複数指定できます。なお、カスタムフィールドのキーワード検索は構造上非常に負荷がかかりますので、不要な場合はチェックを外してください。
ゆらぎ
全角/半角の表記ゆれの扱いを指定します。チェックを付けると、半角/全角の区別なく検索実行します。
例）全角で「ＰＨＰ」と入力
- チェックあり→ 全角「ＰＨＰ」半角「PHP」いずれも検索にヒット
- チェックなし→ 全角「ＰＨＰ」はヒット、半角「PHP」は検索にヒットせず
設定の保存
検索パーツの設定を終えたら、左下の「設定を保存」ボタンで保存します。プレビュー欄には、設定した内容が実際のデータに基づいて表示されます。
必要に応じて右上の「項目を追加」ボタンで検索パーツを追加して検索フォームを作り込みます。
検索フォームを複数作成/管理
検索フォームは複数作成できます。製品検索、施工実績など分野ごとに検索フォームを作成できます。
- ページ右上のドロップダウンから「新規作成」を選択し「実行」ボタンをクリックします。
- →新しく作成された検索フォームの編集画面が開きます。
- →ドロップダウンの内容が（フォームID = 1）に変わっています。
- 検索フォームを作り込みます。
検索フォームを削除する
- ページ右上のドロップダウンから「削除」を選択し「実行」ボタンをクリックします。
コード
作成した検索フォームを設置するには、以下の２つの方法があります。
- テーマのテンプレートにPHPの関数を設置
- 投稿や固定ページ、テキストウィジェットなどにショートコードで設置
また、コードには以下の３つの種類があります。
- 検索フォームを表示する関数/ショートコード
- 記事数を表示する関数/ショートコード
- 検索実行後に検索条件（クエリ）を表示する関数/ショートコード
「コード」欄にはそれぞれ表示されていますので、必要に応じてコピーして設置したい場所にペーストしてください。設置したら表示が崩れていないか、検索が機能するか動作確認を行ってください。
具体的な設置例としては以下が考えられます。
- 設定 > 表示設定 > フロントページに指定した固定ページ本文欄に検索フォームと記事数の２つのショートコードを設置
- 検索結果を表示するテーマのテンプレートはsearch.phpなので、search.phpを開き、ページ上部に検索条件と記事数を表示するPHPの関数を設置
- 検索結果ページからさらに絞り込めるように、search.php下部に検索フォームのPHP関数を設置
- フロントページに設置した検索フォームと同じフォームIDの検索フォームをsearch.phpに設置すると、ドロップダウンやチェックボックスの状態を引き継ぐことができますので、エンドユーザーはそこからさらに絞り込むことができます。