Relewise.Integrations.Umbraco

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();
    });

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.