SearchWPハイライト
SearchWPには、投稿コンテンツ内で見つかった検索語を特定および強調表示する組み込みのハイライト機能が搭載されています。検索結果ページにキーワードがハイライトされたテキストのスニペットを表示し、ユーザーが関連コンテンツ部分を簡単に見つけられるようにします。この機能は、特にマルチページPDFなどの大規模なメディアドキュメントに役立ちます。なぜなら、ドキュメント全体のドキュメントコンテンツをスキャンし、検索語のインスタンスを見つけ、それらのキーワードを含むセクションから抜粋を生成するからです。
ハイライト機能は、Advanced Custom Fields(ACF)のようなカスタムフィールドプラグインと完全に互換性があり、ACFテキストフィールドやその他のカスタムフィールドコンテンツで見つかった検索語から抜粋を生成できます。
ハイライトの有効化
ハイライト機能は、WordPress管理エリアのSearchWP一般設定ページから有効にできます。有効にすると、SearchWPは結果内の一致する検索語をハイライトするカスタム抜粋を自動的に生成します。
コンテンツ処理順序
ハイライトシステムは、抜粋を生成する場所を決定するために、ソース属性を特定の順序で処理します。この優先順位付けアプローチにより、検索実装全体で効率的な処理と一貫した結果が保証されます。
投稿抜粋: SearchWPは最初に手動で作成された投稿抜粋をチェックします。投稿にカスタム抜粋が定義されている場合、このコンテンツが最初に検索語の存在について評価されます。
投稿コンテンツ: 抜粋が存在しないか、抜粋にキーワードが見つからない場合、SearchWPはメインの投稿コンテンツフィールドで検索語のインスタンスを調べます。
ドキュメントコンテンツ: PDFなどのメディアファイルの場合、SearchWPは抽出されたドキュメントコンテンツを処理して、ファイル内のテキストで検索語を見つけます。
カスタムフィールド: 最後に、SearchWPは、前の属性のいずれにも検索語が見つからなかった場合に、カスタムフィールドコンテンツで検索語の存在をチェックします。
検索されたキーワードがいずれかの属性で見つかった場合、後続の属性は処理されません。たとえば、投稿抜粋に検索キーワードが含まれている場合、SearchWPは抜粋を生成するために投稿コンテンツまたはカスタムフィールドを調べません。
注意: 単一の属性フィールド内にキーワードの複数のインスタンスが存在する場合、キーワードの最初の出現箇所が抜粋の生成に使用されます。
抜粋生成
SearchWPは、強調表示するキーワードを含むコンテンツを見つけると、キーワードの前後のテキストの一部を抽出して抜粋を生成します。このコンテキストアプローチにより、ユーザーは一致した用語だけでなく、一致のコンテキストを提供する周囲のコンテンツも確認できます。抜粋の長さはWordPressの設定によって制御され、WordPressのexcerpt_lengthフィルターフックを使用してカスタマイズできます。詳細はこちらに記載されています。
SearchWP Live Searchの結果に対して抜粋の長さを特別に変更するには、次のカスタマイズを実装できます。
| <?php | |
| // Set excerpt length to 20 words for live search results | |
| function swp_excerpt_length( $length ) { | |
| if ( did_action( 'wp_ajax_searchwp_live_search' ) || did_action( 'wp_ajax_nopriv_searchwp_live_search' ) ) { | |
| return 20; | |
| } | |
| return $length; | |
| } | |
| add_filter( 'excerpt_length', 'swp_excerpt_length', 9999 ); |
強調表示された用語のスタイル設定
デフォルトの強調表示マークアップにはsearchwp-highlight CSSクラスが含まれており、カスタムスタイルでターゲットにして強調表示された検索用語の視覚的な外観を制御できます。テーマのスタイルシートにカスタムCSSルールを追加して、強調表示されたキーワードの背景色、テキストの色、フォントの太さ、その他の視覚的プロパティを変更できます。これにより、強調表示された用語が明確に見え、サイト全体のデザイン美学に適合していることを確認できます。
