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
<PackageReference Include="Relewise.Integrations.Umbraco" Version="1.8.1" />
paket add Relewise.Integrations.Umbraco --version 1.8.1
#r "nuget: Relewise.Integrations.Umbraco, 1.8.1"
// 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
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:
Start by cloning the repository.
Setting up the frontend.
- Navigate to
samples/UmbracoV10/client
(also if intend to run the v9 sample - see above) - Run
npm install
via a command prompt - Run
npm run serve
via a command prompt
- Navigate to
Spinning up the site.
- Navigate to
samples/UmbracoV9
orsamples/UmbracoV10
, depending on whether you want to sample v9 or v10. - Run
dotnet run
via a command prompt. - Access the website from your browser
- Navigate to
Installing Umbraco - When visiting the site for the first time, you are asked to configure Umbraco. Just follow the instructions.
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 | Versions 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. |
-
net6.0
- Relewise.Client (>= 1.96.0 && < 2.0.0)
- Relewise.Client.Extensions (>= 1.4.1 && < 2.0.0)
- Umbraco.Cms.Web.BackOffice (>= 9.0.0 && < 11.0.0)
- Umbraco.Cms.Web.Common (>= 9.0.0 && < 11.0.0)
-
net7.0
- Relewise.Client (>= 1.96.0 && < 2.0.0)
- Relewise.Client.Extensions (>= 1.4.1 && < 2.0.0)
- Umbraco.Cms.Web.BackOffice (>= 10.0.0 && < 13.0.0)
- Umbraco.Cms.Web.Common (>= 10.0.0 && < 13.0.0)
-
net8.0
- Relewise.Client (>= 1.96.0 && < 2.0.0)
- Relewise.Client.Extensions (>= 1.4.1 && < 2.0.0)
- Umbraco.Cms.Web.BackOffice (>= 10.0.0 && < 14.0.0)
- Umbraco.Cms.Web.Common (>= 10.0.0 && < 14.0.0)
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 |