チュートリアル: ページへの検索機能の追加
SXA で検索を使用および設定する方法。
訪問者が探しているものをすばやく見つけることができるように、SXA には、すぐに使用できる柔軟な検索機能があります。ツール ボックスには、検索ボックスを追加するレンダリング、検索結果を並べ替えまたはフィルター処理するレンダリングなど、さまざまな検索レンダリングがあります。これにより、サイトにシンプルな検索ソリューションを簡単にセットアップできます。
たとえば、ページに基本的な検索ソリューションを追加することができます。このソリューションは、検索クエリ ボックスを含んでおり、改ページで結果を一覧表示します。
注記
検索コンポーネントの検索要求の結果を表示するには、プレビュー モードに切り替える必要があります。
このチュートリアルでは、次の方法について説明します。
検索ボックス レンダリングの追加
検索結果レンダリングの追加
ページ セレクター レンダリングの追加
訪問者がサイトを検索できるようにページに検索ボックスを追加できます。既定では、検索ボックス レンダリングにより、検索テキスト ボックスがページに追加されます。アイテムを設定してプロパティを変更することで、検索ボックスをカスタマイズできます。
ページに検索ボックスを追加するには、以下の手順に従います。
ツールボックスから、ページに [検索ボックス] レンダリングをドラッグします。
[関連付けられたコンテンツを選択してください。] ダイアログ ボックスの検索ボックスで、既定のアイテムを選択します。
ページ上の検索ボックスのテキストを変更するには、[検索ボックス] ツールバーで、[コンポーネント設定アイテムの編集]
をクリックします。
ダイアログ ボックスで、次のフィールドを編集し、[OK] をクリックします。
[検索ボタンのテキスト] – レンダリングのボタンのテキストです。このフィールドを空のままにすると、ボタンはページに表示されません。
[テキストボックスのプレースホルダー テキスト] – 期待される値を説明するヒントとして機能する検索ボックス内のテキストです。
[検索テキストボックスのラベル] – 検索レンダリングのタイトルです。
たとえば、次のフィールドに、
ページに次の検索ボックスを表示します。
検索ボックスのレンダリング プロパティを変更するには (検索スコープや検索する単語のヒントを追加するなど)、[検索ボックス] ツールバーで、[詳細] をクリックし、[コンポーネント プロパティを編集] をクリックします。
[コントロール プロパティ] ダイアログ ボックスでは、基本的な検索ソリューションの場合、既定の値のままにすることができます。より複雑なソリューションの場合は、次のフィールドを編集できます。
[検索結果シグネチャ] – 特定の検索結果レンダリングの一意のシグネチャを入力して、検索結果を制限します。これは、ページに複数の検索結果レンダリングがある場合に便利です。
[ターゲット シグネチャ] – 別の検索結果ページを作成した場合は、そのページの検索結果レンダリングのシグネチャをここに入力します。
[検索スコープ] - スコープを選択して、検索結果を制限します。
[最大予測結果数] – ドロップダウンに表示される予測結果の最大数を設定します。このフィールドを空のままにすると、予測は表示されません。
[検索結果ページ] – 別のページに移動する場合は、特定の検索ページを選択します。
注記
検索結果ページは、検索結果というコンポーネントを持つ、Web サイトの別のページです。このページは、ユーザーがサイト内の任意の場所から検索を行ったときに、検索結果を表示するランディング ページとして機能します。通常、このページには、他の関連する検索コンポーネント、(検索ボックス、ページ セレクター、結果の並べ替え、いくつかのフィルターなど) も含まれています。検索ボックス コンポーネントは検索結果ページ パラメーターが設定されていると、この検索結果のランディング ページにリダイレクトされます。
[検索テキスト ボックスを表示] – 既定で選択されています。クリアすると、検索テキスト ボックスが削除されます。
[提案モード] – ドロップダウン ボックスからオプションを選択します。
オプションは次のとおりです。
[検索結果を表示]: レンダリング バリアントによってレンダリングされた検索結果を示します。ユーザーはクリックしたアイテムにリダイレクトされます。
[予測を表示]: 検索エンジンが提供する検索フレーズ予測を表示します。このモードは Solr でのみサポートされています。
[検索結果を予測として表示する]: クリックしたテキストが検索ボックスに入力され、検索が実行されます。
警告
SXA は、
sxaSuggester
と呼ばれる提案機能を使用します。Solr で検索候補を設定する場合は、必ずその名前を使用してください。
ユーザーが検索結果を表示するには、ページに検索結果レンダリングを追加する必要があります。シンプルな解決策として、検索結果を同じページに表示させることができます。
検索結果レンダリングを追加するには、次の手順に従います。
ページに検索結果セクションを追加するには、ツールボックスからページに [検索結果] レンダリングをドラッグします。
ページ上にある検索ボックスのテキストを変更するには、[検索結果] ツールバーで [コンポーネント設定アイテムの編集]
をクリックし、検索で結果が返されなかったときに表示するテキストを入力します。[OK] をクリックします。
一度に読み込む結果の数や、結果の並べ替え方法を決定するなどのために検索結果レンダリングのパラメーターを変更するには、[関連付けられたコンテンツを選択してください。] ダイアログ ボックスで、既定のアイテムを選択します。
[コントロール プロパティ] ダイアログ ボックスで、次のフィールドを編集して、検索結果の配置方法を指定します。
[検索結果シグネチャ] – 結果をさらに表示レンダリングなどの別の検索レンダリングとの組み合わせに使用できる固有のシグネチャを入力します。これは、ページ上に 1 つ以上の検索レンダリングがあり、特定の検索結果をフィルター処理する場合に便利です。このフィールドを空のままにすると、シグネチャのないすべての検索結果のレンダリングがフィルター処理されます。
[検索スコープ] - スコープを選択して、検索結果を制限します。
[ページ サイズ] – レンダリングで読み込む結果の数を入力します。
[既定の言語フィルター処理] – 検索に使用する言語を選択します。
[既定の並べ替え順] – ページで結果を並べ替える方法を選択します。これは、結果の並べ替えレンダリングが使用されていない場合にのみ使用されます。
[条件が設定されていない場合は自動的に検索をやめる] - オンにすると、検索はユーザーが検索条件を指定するまでトリガーされません。
ページ セレクター レンダリングを使用すると、結果ページの表示方法を決定できます。表示されるページ数は、検索結果レンダリングで設定された既定のページ サイズによって、ページ サイズ レンダリングが使用されている場合はページ サイズ レンダリングで設定されたページ サイズによってそれぞれ異なります。
ページ セレクター レンダリングを追加するには、次の手順に従います。
ツールボックスから、[ページ セレクター] レンダリングをページにドラッグします。
[ページ セレクター] ツールバーで、[コンポーネント設定アイテムを編集します]
をクリックします。
ダイアログ ボックスで、フィールドに入力し、[OK] をクリックします。
たとえば、次のフィールドに、
次のように表示されます。
ボタンに表示されるページ数を決定する場合など、ページ セレクター レンダリングのプロパティを変更するには、[検索ボックス] で、[その他] をクリックし、[コンポーネント プロパティの編集] をクリックします。
[コントロール プロパティ] ダイアログ ボックスで、次のフィールドを編集してから、[OK] をクリックします。
検索結果のシグネチャ– 特定の検索結果レンダリングでフィルター処理する場合は、検索する検索結果レンダリングのシグネチャ (コンマ区切り) を入力します。
[折りたたみモードのしきい値] – 多くのページで結果が予想される場合は、これらのページの一部をドットに置き換えることができます。
たとえば、[折りたたみモードのしきい値] フィールドに「10」を入力すると、次の検索結果が表示されます。