Kentico.Xperience.Lucene 1.0.0

Xperience by Kentico Lucene

About The Project

Xperience by Kentico search integration with the latest 4.8 beta version of Lucene.NET, enabling auto-indexing of content in Xperience based on application-local, code-defined search indexes and search results retrieval.

Getting Started

Prerequisites

• Xperience by Kentico >= 26.2.0

Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Lucene

Setup

1. Define a custom (or multiple) LuceneSearchModel implementation to represent the content you want index.

2. Define a custom DefaultLuceneIndexingStrategy implementation to customize how page content/fields are processed for the index.

3. Add this library to the application services, registering your custom LuceneSearchModel.

   builder.Services.AddKentico();
   // ... other registrations
   builder.Services.AddLucene(new[]
   {
       new LuceneIndex(
           typeof(MySearchModel),
           new StandardAnalyzer(Lucene.Net.Util.LuceneVersion.LUCENE_48),
           MySearchModel.IndexName,
           indexPath: null,
           new MyCustomIndexingStrategy()),
   });
   

4. Rebuild the index in Xperience's Administration within the Lucene application added by this library.

5. Use the ILuceneIndexService (via DI) to retrieve the index populated by your custom LuceneSearchModel.

6. Execute a search with a customized Lucene Query (like the MatchAllDocsQuery) using the ILuceneIndexService.

7. Return or display the results on your site 👍.

Usage

• Review the "Search" functionality in the src\Kentico.Xperience.Lucene.Sample Dancing Goat project to see how to implement search.
• Read the Lucene.NET introduction or full documentation to explore the core library's APIs and functionality.
• Explore the Lucene.NET source on GitHub

Sample features

Trigger rebuild of index via webhook

Rebuild of index could be triggered by calling POST on webhook /search/rebuild with body

{
  "indexName": "...",
  "secret": "..."
}

This could be used to trigger regular reindexing of content via CRON, Windows Task Scheduler or any other external scheduler.

Contributing

• .NET SDK >= 7.0.109

  • https://dotnet.microsoft.com/en-us/download/dotnet/7.0

• Node.js >= 18.12

  • https://nodejs.org/en/download
  • https://github.com/coreybutler/nvm-windows

Sample Project

To run the Sample app Admin customization in development mode, add the following to your User Secrets for the application.

"CMSAdminClientModuleSettings": {
  "kentico-xperience-integrations-lucene": {
    "Mode": "Proxy",
    "Port": 3009
  }
}

For Contributing please see CONTRIBUTING.md for more information and follow the CODE_OF_CONDUCT.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

This contribution has Full support by 7-day bug-fix policy.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.