Best Practices

In order to aid Product Owners in developing according to agile principles, we have expressed our recommended best practices as user stories. Feel free to copy and paste this to your backlog.

Basic SmartQuery Implementation

Story
As a customer, I want to see search results that are optimized using CXP search|hub (https://commerceexperts.github.io/searchhub-docs/index.html) and which are frequently updated using recent KPI data.
Acceptance criteria

Query Correction Feedback

Story
As a customer, I want to see the corrected query and retain have the opportunity to search for my inserted query instead.
Acceptance criteria
  • If a mapping took place, display a text about the corrected query
  • Additionally, I want the system to add a link that enables the user to search for the original query instead.
  • When clicking the above mentioned link, no mapping should take place.
Technical hint
  • You can use the bypass feature of SmartQuery by wrapping the query into quotes. Passing that query will not do any mapping but, rather, remove the quotes again.
  • In the event the direct integration is implemented, the util function io.searchhub.smartquery.util.QueryAssessment.isOnlyWordReorder can be used to avoid displaying the query correction feedback resulting from the query consisting of the same words.

Search|Hub Redirects

Story
As a search manager, I want users to be redirected to landing pages for certain queries according to the configuration within search|hub.
Acceptance criteria
  • The usage of queries, that are configured for a redirect, should lead to the configured landing page / URL.