dariusz-wozniak.EPiServer.Labs.Find.Toolbox
2.0.0
dotnet add package dariusz-wozniak.EPiServer.Labs.Find.Toolbox --version 2.0.0
NuGet\Install-Package dariusz-wozniak.EPiServer.Labs.Find.Toolbox -Version 2.0.0
<PackageReference Include="dariusz-wozniak.EPiServer.Labs.Find.Toolbox" Version="2.0.0" />
paket add dariusz-wozniak.EPiServer.Labs.Find.Toolbox --version 2.0.0
#r "nuget: dariusz-wozniak.EPiServer.Labs.Find.Toolbox, 2.0.0"
// Install dariusz-wozniak.EPiServer.Labs.Find.Toolbox as a Cake Addin #addin nuget:?package=dariusz-wozniak.EPiServer.Labs.Find.Toolbox&version=2.0.0 // Install dariusz-wozniak.EPiServer.Labs.Find.Toolbox as a Cake Tool #tool nuget:?package=dariusz-wozniak.EPiServer.Labs.Find.Toolbox&version=2.0.0
🍴 Forked EPiServer.Labs.Find.Toolbox information
This is a fork of the EPiServer.Labs.Find.Toolbox library.
The purpose of the fork is to provide a Nuget.org package for the library along with possible version updates and improvements.
Notes:
- Versioning of the package might differ from the original library.
- The forked library version starts with 2.0.0 version to indicate support of .NET 6 and Find 14.
- Licensing is the same as the original library, i.e. Apache-2.0.
- For version history, refer to the Releases.
Original readme just below the line 👇
EPiServer.Labs.Find.Toolbox
Please note that this project is not officially supported by Optimizely just like most EPiServer.Labs projects. Should be considered stable and is currently used in production environments.
What you get
- An improved synonym implementation
- An overall relevance improvement by utilizing MatchPhrase, MatchPhrasePrefix and MatchPrefix
- Support for MinimumShouldMatch which improves search experience further
- FuzzyMatch and WildcardMatch improving searches with typos and partial words
- Three (pages, media and blocks) new CMS search providers that utilize all of the above to provide an improved search experience for the CMS UI
- Set a custom request timeout for your search
These features can be used together or independently and depend on the .For() call, which spawns the original queryStringQuery.
.UsingSynonymsImproved()
The improved synonym implementation solves limitations in the following scenarios:
- Missing or unexplainable hits when using .WithAndAsDefaultOperator()
- Multiple term synonyms
- Multiple term synonyms bidirectional
- Multiple term synonyms within quotes
- Multiple term synonyms requires all terms to match
- Does not rely on an synonym index to be up to date
- No unwanted built-in synonyms
Currently the synonym expansion is done in backend (Elastic Search) and relies on a synonym index. We solve this by retrieving and caching the synonym list and expand the matching synonyms on the query, on the client side.
Searching for 'episerver find' where find is a synonym for 'search & navigation" will result in 'episerver (find OR (search & navigation))'
Note!
- There will always be an OR relationship between the synonym match and the expanded synonym regardless if you use WithAndAsDefaultOperator() or MinimumShouldMatch().
- There will always be an AND relationship between terms of the phrase in the synonym match and the expanded synonym regardless if you use OR.
.MinimumShouldMatch()
With MinimumShouldMatch it's possible to set or or more conditions for how many terms (in percentage and absolutes) should match. If you specify 2<60% all terms up to 2 terms will be required to match. More than 2 terms 60% of the terms are required to match. If you specify 2 all terms up to 2 terms will be required to match. This is prefered over using purely OR or AND where you will either get too many hits (OR) or no hits (AND). MinimumShouldMatch() has to be called before calling UsingImprovedSynonyms() to be utilized.
.UsingRelevanceImproved()
UsingRelevanceImproved() applies Elastic Search's MatchPrefix, MatchPhrase, MatchPrefixPhrase for new subqueries by using the query generated by For() and/or .UsingSynonyms() to improve the search relevance for a handful of common search patterns. This also includes the synonym expanded query variations.
.FuzzyMatch() and .WildcardMatch()
FuzzyMatch() finds terms even if the wording is not quite right. WildcardMatch() find terms even if they are not completed or are part of another word. The two latter are only applied to terms longer than 2 characters and only the first 3 terms out of these. Wildcard is only added to the right. FuzzyMatch() gets a negative boost. Wildcard matches gets a slightly higher negative boost.
Note! WildcardQuery and FuzzyQuery should be considered heavy for the backend and should only be used on few fields and only on fields with little content. FuzzyMatch() does not use a true FuzzyQuery but a QueryStringQuery with fuzzysupport which gives better relevance than multiple FuzzyQuery queries.
CMS Search providers for pages, media and blocks
All toolbox features added to three new CMS search providers that gives you overall improved search experience for your editors and administrators using the CMS UI.
Follow this steps to enable the search providers
- Navigate to CMS Admin → Config → Search providers
- Check 'Find Toolbox - Pages', 'Find Toolbox - Media' and 'Find Toolbox - Blocks' and drag them to the top
- Disable Find pages, Find blocks, Find files
.SetTimeout()
Finally, you are able to set a proper timeout for all your search requests. Note! MultiSearch not supported
MatchQueryPhrase documentation
Table of Contents
System requirements
- 1.x requires Find 13 / .NET Framework
- 2.x requires Find 14 / .NET Core 6 or higher
- MinimumShouldMatch() requires that you're using a Find V3 index. If you're unsure reach out to Optimizely support and they will be able to help you migrate your index.
See also the general Optimizely system requirements on Episerver World.
Installation
Install NuGet package or copy all files into your project
Make sure you use
using EPiServer.Find.Cms;
Remove any use of .UsingSynonyms()
Add .WithAndAsDefaultOperator if you want but we recommend .MinimumShouldMatch(). Not specifying either will allow for OR as the default operator. Using MinimumShouldMatch() will take precedence over any use of .WithAndAsDefaultOperator() or the default OR.
Add .UsingSynonymsImproved([cacheDuration]) The cache duration parameter defaults to 3 hours but could be set to something shorter during testing.
Add .UsingRelevanceImproved([fields to query])
It could look like this
// With MinimumShouldMatch() with conditions UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2<60%") .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .GetResult();
// With MinimumShouldMatch() absolutes UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2") .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .GetResult();
// With WithAndAsDefaultOperator() UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .WithAndAsDefaultOperator() .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .GetResult();
// Without WithAndAsDefaultOperator() which is the default behaviour which sets the default operator to OR UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .GetResult();
// Boosting matches for phrase searches overall and in beginning of fields UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2") .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .GetResult();
// Let clients do some typos and write half-words and still get some hits UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2") .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .FuzzyMatch(x => x.SearchTitle) .WildcardMatch(x => x.SearchTitle) .GetResult();
// Set your request timeout to 10 seconds UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2") .UsingSynonymsImproved() .UsingRelevanceImproved(x => x.SearchTitle) .FuzzyMatch(x => x.SearchTitle) .WildcardMatch(x => x.SearchTitle) .SetTimeout(10000) .GetResult();
// When testing set synonym cache duration to a few seconds UnifiedSearchResults results = SearchClient.Instance.UnifiedSearch(Language.English) .For(query) .MinimumShouldMatch("2") .UsingSynonymsImproved(TimeSpan.FromSeconds(1)) .UsingRelevanceImproved(x => x.SearchTitle) .FuzzyMatch(x => x.SearchTitle) .WildcardMatch(x => x.SearchTitle) .SetTimeout(10000) .GetResult();
Enjoy!
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- EPiServer.Find.Cms (>= 14.2.4)
- Microsoft.CSharp (>= 4.7.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.0.0 | 14,178 | 8/24/2023 |