Add menu options and user interface views
Configure shell module
The shell module must be configured so that user interface options are visible. When you create an index, you get an email with an episerver.find section that you add to the site's web.config (CMS 11) or appsettings.json (CMS 12). The Optimizely shell module registration and configuration are done automatically when you install using NuGet packages.
Below are the changes made to the configuration when you installed the packages.
Register Search & Navigation module
<episerver.shell>
<publicModules rootPath="~/modules/" autoDiscovery="Minimal" />
<protectedModules rootPath="~/epiui/">
<strong>
<add name="Find">
<assemblies>
<add assembly="EPiServer.Find.Framework" />
<add assembly="EPiServer.Find.Cms" />
</assemblies>
</add>
</strong>
<add name="Shell" />
<add name="CMS" />
</protectedModules>
</episerver.shell>Add handler for embedded resources
<location path="EPiServerFindEmbeddedResources">
<system.webServer>
<handlers>
<clear />
<add name="wildcard" path="*" verb="*" type="EPiServer.Web.StaticFileHandler, EPiServer.Framework" />
</handlers>
</system.webServer>
</location>Access rights
Access to views in the shell module is restricted to users in one of three groups:
- WebAdmins
- Administrators
- SearchAdmins (Search & Navigation-specific)
Note The first two groups have Admin view access in Optimizely Content Management System (CMS), and access to shell module views by default. To grant users without administrator access, create the SearchAdmins group for the membership and role provider you are using, and add those users to it.
Supported browsers
The shell module relies heavily on CSS 3, so only modern browsers are supported. See the system requirements for Optimizely.
Added views
When properly configured, the shell module adds the views and subviews described below to the editing interface.
Manage statistics view
This view shows Search statistics for the most frequent searches, searches without hits, and searches without relevant hits. Statistics can be displayed for the last 24 hours, week, month, or year.
Manage optimization view
- Best Bets – Can be site and language-specific or site and language-independent, depending on choices made in the site and language drop-downs (near the top of the view). To apply best bets to search results, you must apply an ApplyBestBets extension method.
- Related queries – Can be site and language-specific or site and language-independent. To use related queries, you must apply a DidYouMean method.
- Synonyms – Can be language-specific or apply to any language, but cannot be site-specific. To use synonyms, you must apply a UsingSynonyms extension method.
Configure view
- Boost with weights – Provides a form for fine-tuning weights of different content parts in search results. Site and language independent.
- .NET indexing – Lets you clear data stored in the index and index statistics.
- Connectors – Provides a view for creating and listing connectors.
Overview and explore views
The Overview and Explore views let you browse indexed content. They display information about the number of indexed documents grouped by type. Filtering by type and arbitrary search query is supported.