2. Creating your project
In this step, you create an Episerver CMS sample website, add and configure the CMS integration for Find, and do an initial content indexing. If you already have a website to which you want to add Find, skip the website creation step. After completing this step, you are ready to start developing.
Creating the website
Follow steps 1-2 in Creating your project for CMS. In step 3, select Alloy(MVC) to create a sample website based on MVC (alternatively, you can use WebForms). Let the installation finalize, and open the website in a browser to ensure that it is working properly.
Adding Find to the website
Ensure that the Episerver NuGet feed is added as a package source for the website for which you want to add Find. If you installed the EPiServer sample site, this is automatically added.
Note: If you selected the Episerver Find option while installing the Episerver CMS, you can skip this step.
- Open the solution file for the website in Visual Studio.
- Right-click on References, and select Manage NuGet Packages, Online and EPiServer.
- Locate the EPiServer.Find.Cms package and click Install.
- Verify that Find components are added under References for your project.
Configuring Find for the website
- Log in to your account on the Episerver Find site, go to My Services and click index Details.
- Copy the configuration code snippet displayed for the web.config file.
- Go to your solution and paste the configuration code into the relevant sections in the web.config file for your website. The code to paste looks something like this:
<configuration> <configSections> <section name="episerver.find" type="EPiServer.Find.Configuration, EPiServer.Find" requirePermission="false"/> </configSections> <episerver.find serviceUrl="http://es-api01.episerver.com/ClDVQsXo9DlI1M6IQn6PSDwAiqRGi22G/" defaultIndex="yourname_testing"/> </configuration>
Note: Check the <handlers> section of your web.config to ensure that you do not have a duplicate "ExtensionlessUrlHandler-Integrated-4.0" statement. If there are two, delete one of them.
- Open the Package Manager Console and run the Update-EPiDatabase command.
- Rebuild the project and verify that the site is running properly.
Note: To ensure maximum availability and scaling flexibility, Episerver Find uses dynamic IP ranges. If you for example require whitelisting of IP addresses in the firewall, make sure that your firewall supports domain-based whitelisting.
Indexing the website
- Log in to the site.
- Go to the CMS admin view.
- Select EPiServer Find Content Indexing Job and click Start Manually. This action indexes the site content. Note that you do not need to set up the indexing scheduled job to run automatically, since content changes are instantly indexed.
- Log in to the CMS edit view, go to Find, select Overview, and explore the index. For the sample site, you see something like this:
Note: If multiple sites are associated with the index, objects from other sites may appear. Refer to Indexing for more information on how indexing works.
Continue to creating the basic search.