USiteSearch 0.6675.0

dotnet add package USiteSearch --version 0.6675.0
NuGet\Install-Package USiteSearch -Version 0.6675.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="USiteSearch" Version="0.6675.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add USiteSearch --version 0.6675.0
#r "nuget: USiteSearch, 0.6675.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install USiteSearch as a Cake Addin
#addin nuget:?package=USiteSearch&version=0.6675.0

// Install USiteSearch as a Cake Tool
#tool nuget:?package=USiteSearch&version=0.6675.0

This file is best viewed at [GitHub] Image are blocked when viewed on NuGet.

Add full text search to your Umbraco website in 15 minutes flat

I build websites using the Umbraco content management system, and one feature that is often necessary is a site search. While you can use Examine for this purpose, my sites often require a Google-like search rather than a search specific to the site's content. Additionally, I need a user-friendly interface for the search and syntax highlighting to make the results more readable.

In the past, I have copied and pasted my site search code between projects, but this has not been efficient and has resulted in bugs and other issues. To improve the quality of my code and make it easier to use, I have decided to add unit and integration tests and turn it into a system that can be easily installed in just 15 minutes. This system is called USiteSearch.

Earlier versions of the code used in USiteSearch can be seen in action on Mysterious Universe which has a total of 20,000 blog posts.

Need an Umbraco developer?

You can reach me at my website.


Contact me if you need support, this is free 😃


Let's get USiteSearch working in a sample Umbraco website so you can see exactly how it works. Installing on the sample site will teach you how to install it in your own site. Set up should take no longer than 15 minutes.

Note: This help can also be viewed as a YouTube tutorial if you prefer watching a video.

Installation steps

We will install USiteSearch on an Umbraco 11 or 12 website to show how it works.

  1. Clone this basic Umbraco 11 website. The website comes with an embedded database so it should run without further modifications. The back office login for the website is:

    Password: admin12345

    Alternatively clone the same website in Umbraco 12 website

    Check the website runs and you can log in to the backoffice.

  2. Install the latest nuget USiteSearch package via the NuGet package manager:

    nuget install

  3. Unzip this zip file site files

    Unzip the files in the project folder.

    This installs some css, images, javascript and a partial view. The files it installs are show below:

    setup sample

  4. Run the project to view the sample website. Now let's add USiteSearch. Open startup.cs and add this using statement at the top of the file:

      using SiteSearch.USiteSearch.Notifications;

    Add AddUSiteSearch to ConfigureServices:

     public void ConfigureServices(IServiceCollection services)
     	services.AddUmbraco(_env, _config)
     		.AddNotificationHandler<UmbracoApplicationStartingNotification, Bundling>()
     		.AddUSiteSearch(services, "app_data/USiteSearch", 9) //add this

    This configures the USiteSearch to a LuceneProvider search provider:

    app_data/USiteSearch - is the relative path where Lucene will store data in the application.

    9 - When displaying search results, the number of words to display each side of a word match.

    Note the line AddNotificationHandler which adds bundling via Bundling.cs. This is an addition to the base Umbraco project but is something you should probably be adding for all css and javascript. Read more about Umbraco Bundling

  5. Next we need to enable the css and javascript used by USiteSearch. Add these lines in views/master.cshtml in the head section:

     <link rel="stylesheet" href="usitesearch-css-bundle" />
     <script src="usitesearch-js-bundle"></script>

    This includes these files via bundling:

    ~/USiteSearch/css/usitesearch.min.css and

  6. Add this line in Views/master.cshtml under the body tag:

    <partial name="~/Views/Partials/USiteSearch/USiteSearch.cshtml" />
  7. Next we need to index the site, to do this, log into the backoffice and save and publish each of the pages.
    This will create the lucene index under the app_data folder as specified in startup.cs:

    app_data folder

    This folder can be deleted to clear the search.

  8. In order to engage the search, we need to give a front end element the attribute id="site-search"
    This has been done for you in master.cshtml:

     	<a href="#" id="site-search" title="Search the site">Site search</a>

    Click on the element and you should see the search bar, enter the term animals. After typing a few characters you should see these results:

    app_data folder

    Refine the search, search for animals lions. Note the results reduce and each search term is highlighted with 9 words either side of the word match. This is the variable we set earlier in startup.cs.

  9. Search for the term play close and notice it matches all pages:

    Search for pay close

    This is because this text is in the margin. In order to remove this text from the search, add this tag to html elements you want excluded from the site search:

    Search exclusion

    Typically you would exclude the navigation, footer and common margins. You will need to save each page again to reindex these pages.

  10. If you want to remove whole pages from the site search, add the property blockFromSearch to document types:

    Search exclusion

    This is already present in the sample project and when you check it on, pages will be removed from the search if you resave them after checking the option.

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
0.6675.0 185 10/16/2023
0.6674.0 136 7/29/2023
0.6673.0 119 7/29/2023
0.6672.0 121 7/28/2023
0.667.0 133 7/28/2023
0.666.0 154 7/28/2023
0.665.0 145 7/28/2023
0.664.0 130 7/28/2023
0.662.0 192 6/17/2023
0.652.0 322 1/12/2023
0.651.0 274 1/11/2023
0.650.0 281 1/10/2023
0.650.0-alpha 130 1/10/2023
0.641.0 272 12/21/2022
0.66.1 128 6/17/2023
0.66.0 132 6/17/2023
0.66.0-alpha 99 1/10/2023
0.65.0-alpha 114 1/10/2023

0.6675 - readme updates