Kentico.Xperience.Algolia 6.0.0

Prefix Reserved
dotnet add package Kentico.Xperience.Algolia --version 6.0.0                
NuGet\Install-Package Kentico.Xperience.Algolia -Version 6.0.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="Kentico.Xperience.Algolia" Version="6.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Kentico.Xperience.Algolia --version 6.0.0                
#r "nuget: Kentico.Xperience.Algolia, 6.0.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 Kentico.Xperience.Algolia as a Cake Addin
#addin nuget:?package=Kentico.Xperience.Algolia&version=6.0.0

// Install Kentico.Xperience.Algolia as a Cake Tool
#tool nuget:?package=Kentico.Xperience.Algolia&version=6.0.0                

Xperience by Kentico Algolia

7-day bug-fix policy CI: Build and Test NuGet Package

Description

This integration enables you to create Algolia search indexes to index content of web pages from an Xperience website channel using a code-first approach. To provide a search interface for the indexed content, developers can use the .NET API, JavaScript API, or the InstantSearch.js library.

Library Version Matrix

Xperience Version Library Version
>= 30.0.0 >= 6.0.0
>= 29.5.0 >= 5.0.0
>= 29.0.0 >= 4.1.0
28.x >= 3.x
>= 26.2.0, < 27.0.0 2.x

Dependencies

Package Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Algolia

Quick Start

  1. Add configuration from your Algolia account to the ASP.NET Core appsettings.json file:

    "CMSAlgoliaSearch": {
        "ApplicationId": "<your application ID>",
        "ApiKey": "<your Indexing API key>",
        "SearchKey": "<your Search API key>"
    }
    
  2. Define a custom DefaultAlgoliaIndexingStrategy implementation to customize how content pages/content items are processed for the index. See Custom-index-strategy.md

  3. Add this library to the application services, registering your custom DefaultAlgoliaIndexingStrategy and Algolia services

    // Program.cs
    services.AddKenticoAlgolia(configuration);
    services.RegisterStrategy<GlobalAlgoliaIndexingStrategy>("DefaultStrategy");
    
  4. Create an index in Xperience's Administration within the Search application added by this library. Administration search edit form

  5. Rebuild the index in Xperience's Administration within the Search application added by this library. Administration search edit form

  6. Display the results on your site with a Razor View 👍.

Full Instructions

View the Usage Guide for more detailed instructions.

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

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

Support

7-day bug-fix policy

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

See SUPPORT.md for more information.

Security

For any security issues see Kentico's SECURITY.md.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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
6.0.0 41 12/19/2024
5.0.1 100 10/29/2024
5.0.0 171 10/1/2024
4.1.0 420 4/30/2024
4.0.0 131 4/10/2024
4.0.0-prerelease-1 105 4/10/2024
3.0.0 271 2/13/2024
3.0.0-prerelease-1 98 2/9/2024
2.0.2 263 5/29/2023
2.0.1 163 5/26/2023
2.0.0 168 5/17/2023
1.0.0 224 11/7/2022