引用符（フレーズ、文）検索サポート

SearchWPは、フレーズ検索または文ベースの検索とも呼ばれる引用符付き検索をサポートしています。これにより、訪問者は検索に引用符を追加して、その引用符で囲まれた文字列の完全一致を強制できます。

たとえば、コーヒーマグと"コーヒーマグ"の検索の違い

この機能を使用するには、SearchWP設定ページの「一般設定」タブにある該当するチェックボックスをオンにしてください。

有効にすると、SearchWPは検索クエリで引用符で囲まれた用語をチェックし、引用符で囲まれた文字列の完全一致を見つけようとします。前のコーヒーマグと"コーヒーマグ"の例を再度参照してください。

コーヒーマグ

SearchWPの動作方法 に従って、SearchWPは最初にANDロジックを使用して検索を実行し、すべての検索用語が存在することを確認します。そのパスで結果が見つからない場合、SearchWPは自動的にORロジックに切り替わります。この動作は、フックを使用してカスタマイズできます。

"コーヒーマグ"

検索文字列が引用符で囲まれているため、SearchWPは検索を実行する際にコーヒーマグの完全一致の結果を見つけようとします（注意点を参照）。完全一致の結果が見つからない場合は、引用符が削除され、そのパターンに従って再度検索が実行されます。

注記

性質上、引用符付き検索は検索結果を制限/絞り込みます。これにより、結果が返されない場合があります。SearchWPでは、引用符付き検索で結果が見つからない場合、アルゴリズムは引用符なしで検索を実行するようにフォールバックします。変更を示す通知が自動的に出力されます。

上記のスクリーンショットは、WordPressのデフォルトテーマであるTwenty Nineteenでの自動出力を概説しています。外観を改善するために、次のCSSを追加できます。

注意：（WordPressダッシュボードの[外観] > [カスタマイズ] > [追加CSS]に移動して、カスタムCSSをサイトに追加できます）

これにより、サイトのデザインにより一致する通知が表示されます。

注意点

SearchWPの完全一致の実装を評価する際には、考慮すべきいくつかの制限があります。SearchWPはトークンベースの検索システムであるため、性質上、SearchWPのインデックスには、検索インデックス全体での完全一致に関する詳細情報は含まれていません。SearchWPのインデクサーは、インデックス作成中のコンテンツのカスタマイズも許可するため、場合によっては完全一致がさらに不明瞭になる可能性があります。

その結果、SearchWPは次のケースで完全一致を見つけることができません。

• ショートコード生成コンテンツ
• 追加のメタデータ（ただし、回避策があります）
• インデックス作成中に変更されたコンテンツ

これらの制限のため、SearchWPの引用符付き検索サポートはオプトイン機能であり、SearchWP設定画面の「詳細設定」タブのチェックボックスをオンにすることで機能が有効になります。

回避策

以下に概説するように、SearchWPの引用符付き検索サポートの制限を回避するための限定的な方法がいくつかあります。

追加メタデータの回避策

SearchWPが追加のメタデータをインデックス化すると、データはSearchWPのインデックスにのみ保存されます。これは、データの唯一の記録がインデクサーによってトークン化されたものであることを意味します。

SearchWP がコンテンツをトークン化して完全一致クエリを実行できないという問題を回避するために、フックをカスタマイズして update_post_meta を呼び出すことができます。これによりデータが永続化され、そのレコードの引用符付きフレーズ検索がサポートされます。

注意: 引用符付き検索を有効にするには、使用している meta_key を、作業中の各ソースのカスタムフィールドに追加する必要があります。SearchWP は、このアクションを実行する際にこれらのキーを明示的に使用します。

これはオプトインの動作です。SearchWP はデータベースの使用量を最小限に抑えるために、追加メタデータをインデックスにのみ保存します。