Manuell installation av SiteSeekers sökintegration för EPiServer
2013-01-28Guiden beskriver hur SiteSeekers sökintegration manuellt konfigureras i EPiServer.
Den senaste versionen av sökintegrationen går att ladda ner här. För kodexempel av söksidan rekommenderas WebForms-exemplet.
Installationspaketet innehåller följande kataloger:
- Documentation – Innehåller chm-fil skapad baserat på kommentarer från kodbasen.
- EPiServer installer – Innehåller msi-fil för installation. Filen finns i två varianter, en signerad och en osignerad.
- Examples – Innehåller ett exempelprojekt i WebForms och ett i MVC. För kodexempel av söksidan rekommenderas WebForms-exemplet.
- Release Assemblies – Innehåller binärer som möjliggör integration av SiteSeeker i EPiServer.
- Kopiera binärerna till webbprojektets bin-katalog.
- Uppdatera webbplatsens
web.config
enligt exemplet nedan. Detta kan också göras direkt i kod, vilket ej tas upp i denna guide utan visas i exempelprojekten.
Sektionen "siteseeker" måste registreras.
<section name="siteseeker" type="SiteSeeker.Configuration.SiteSeekerConfigurationSection"/>
Konfigurationen kan se ut enligt följande:
<siteseeker> <searchIndices> <add name="exampleSearchIndex" displayName="the example index" url="http://siteseeker-knowledgebase.siteseeker.se/ws/siteseeker-knowledgebase" userName="ws" password="gnus5/dopier"></add> <add name="exampleSearchIndex1" displayName="the example index1" url="http://siteseeker-knowledgebase.siteseeker.se/ws/siteseeker-knowledgebase" userName="ws" password="gnus5/dopier"></add> <add name="exampleSearchIndex2" displayName="the example index2" url="http://siteseeker-knowledgebase.siteseeker.se/ws/siteseeker-knowledgebase" userName="ws" password="gnus5/dopier"></add> </searchIndices> <siteseeker>
Eftersom sökintegrationen använder HTTP-handlers för bl.a. klickspårning och sökordsförslag i sökrutan måste de registreras. De registreras olika beroende på vilken version av Internet Informations Services (IIS) som används.
- För IIS 6.0 registreras handlers i sektionen
httpHandlers
iweb.config
. - För IIS 7.0 som körs i Classic mode ska de registreras i sektionen
httpHandlers
och mappas tillAspnet_isapi.dll
. - För IIS 7.0 som körs i Integrated mode ska de registreras i elementet
handlers
i sektionensystem.WebServer
.
I configuration/httpHandlers:
<add path="*.siteseeker" verb="*" type="SiteSeeker.UI.FactoryHandler, SiteSeeker, Version=4.0.2.0, Culture=neutral"/>
I configuration/system.WebServer/handlers:
<add name="siteseeker" path="*.siteseeker" verb="*" type="SiteSeeker.UI.FactoryHandler,SiteSeeker" preCondition="integratedMode"/>
Kom ihåg att lägga mer generiska handlers, t.ex. path="*", under din siteseeker-handler. Annars kommer fel handler att anropas vid klickspårningen, vilket brukar resultera i ett http 404 eller 500-fel.
Nu ska SiteSeeker vara konfigurerat för EPiServer. I EPiServers redigeraläge finns nu en ny flik kallad sökning.