Relewise.Integrations.Umbraco 1.8.1

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

// Install Relewise.Integrations.Umbraco as a Cake Tool
#tool nuget:?package=Relewise.Integrations.Umbraco&version=1.8.1                

Relewise.Integrations.Umbraco GitHub license NuGet version PRs Welcome

Installing Relewise.Integrations.Umbraco

First make sure to have Umbraco installed:

dotnet new umbraco

Then you can install the Relewise.Integrations.Umbraco Package through the .NET CLI by running this command:

dotnet add package Relewise.Integrations.Umbraco

... or from the NuGet Package Manager Console by running this command:

Install-Package Relewise.Integrations.Umbraco

Using Relewise.Integrations.Umbraco

Open Program.cs and add Relewise to the IServiceCollection-instance:

builder.Services.AddRelewise(options => options.ReadFromConfiguration(builder.Configuration));

... where the above configuration, requires Relewise configuration in appsettings.json:

"Relewise": {
  "DatasetId": "insert-dataset-id-here",
  "ApiKey": "insert-api-key-here",
  "ServerUrl": "insert-server-url-here"
}

Find more details about this here: https://github.com/Relewise/relewise-sdk-csharp-extensions

To integrate with Umbraco, you need to add Relewise to the UmbracoBuilder (.AddUmbraco(...)), and optionally specify which ContentTypes, that you would like exported into Relewise for content search and recommendations.

In the example below we are exporting four content types into Relewise:

builder.CreateUmbracoBuilder()
    .AddBackOffice()
    .AddWebsite()
    .AddDeliveryApi()
    .AddComposers()
    .AddRelewise(options => options
        .AddContentType("landingPage", contentType => contentType.AutoMap())
        .AddContentType("blogList", contentType => contentType.UseMapper(new BlogMapper()))
        .AddContentType("contentPage", contentType => contentType.AutoMap())
        .AddContentType("blogEntry", contentType => contentType.AutoMap()))
    .Build();

If you'd also like these content types to be automatically tracked, you can add our middleware to the UmbracoBuilder (.UseUmbraco(...)):

app.UseUmbraco()
    .WithMiddleware(u =>
    {
        u.UseBackOffice();
        u.UseWebsite();
        u.TrackContentViews();
    })
    .WithEndpoints(u =>
    {
        u.UseInstallerEndpoints();
        u.UseBackOfficeEndpoints();
        u.UseWebsiteEndpoints();
    });

Sample site for v9 and v10 - Get it up and running.

The sample site requires .NET 6 and NPM. There is a sample site for both Umbraco v9 and Umbraco v10. The sample site share the same frontend client, which is located in the Umbraco v10 sample site folder. The sample site has demo content, so once it's up and running, you can have a look around.

If you wish to setup and run, then just follow the steps below:

  1. Start by cloning the repository.

  2. Setting up the frontend.

    1. Navigate to samples/UmbracoV10/client (also if intend to run the v9 sample - see above)
    2. Run npm install via a command prompt
    3. Run npm run serve via a command prompt
  3. Spinning up the site.

    1. Navigate to samples/UmbracoV9 or samples/UmbracoV10, depending on whether you want to sample v9 or v10.
    2. Run dotnet run via a command prompt.
    3. Access the website from your browser
  4. Installing Umbraco - When visiting the site for the first time, you are asked to configure Umbraco. Just follow the instructions.

  5. Publish the content of the site. The site comes with content already created. You just need to login and publish the content

14-day Free Trial

You can get access to a 14-day free trial of Relewise to get you started with Relewise.

Resources

Find more information on the Umbraco Marketplace: https://umbraco.com/marketplace/relewise/

Documentation can be found at https://docs.relewise.com.

Please don't hesitate to reach out to us - www.relewise.com - if you'd like to know more, including how to gain access to our API.

Contributing

Pull requests are always welcome.
Please fork this repository and make a PR when you are ready with your contribution.

Otherwise you are welcome to open an Issue in our issue tracker.

License

Relewise.Integrations.Umbraco is MIT licensed.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  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 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
1.8.1 143 7/31/2024
1.8.0 131 6/21/2024
1.7.2 188 3/2/2024
1.7.1 127 3/2/2024
1.7.0 126 3/1/2024
1.6.1 1,285 10/2/2023
1.6.0 139 9/24/2023
1.5.2 172 8/29/2023
1.5.1 1,725 1/26/2023
1.5.0 350 1/18/2023
1.4.2 333 1/13/2023
1.4.1 378 11/30/2022
1.4.0 508 10/25/2022
1.3.0 439 9/2/2022
1.2.0 438 8/31/2022
1.1.0 487 7/8/2022
1.0.0 492 6/23/2022