kontent-ai/sample-app-razorpages

Sample .NET Core Razor Pages project using the Kontent.ai Delivery .NET SDK to retrieve content

Kontent.ai sample ASP.NET Core Razor Pages web application

Sample .NET Core Razor Pages project using the Kontent.ai Delivery .NET SDK to retrieve content.

This application is meant for use with the Dancing Goat sample project within Kontent.ai. The project contains the home page and article content for Dancing Goat – an imaginary chain of coffee shops. If you don't have your own Sample Project, any administrator of a Kontent.ai subscription can generate one.

Application setup

Running the application

To run the app:

1. Clone the app repository with your favorite GIT client
2. Open the solution
3. Run the app.

Connecting to your sample project

If you already have a Kontent.ai account, you can connect this sample Razor Pages application to your version of the Sample project.

1. In Kontent.ai, choose Project settings from the app menu.

2. Under Development, choose API keys and copy the Project ID.

3. Open the \sample-app-razorpages\appsettings.json file.

4. Use the values from your Kontent.ai project in the appsettings.json file:

   • Project ID: Insert your project ID into the ProjectId application setting.

    {
    "DeliveryOptions": {
      "ProjectId": "<your Kontent.ai project ID>"
    },
  }

1. Save the changes.
2. Run the application.

Content administration

1. Navigate to https://app.kontent.ai in your browser.
2. Sign in with your credentials.
3. Manage content in the content administration interface of your sample project.

Learn more about content editing with Kontent.ai.

Content delivery

You can retrieve content either through the Kontent.ai Delivery SDK or the Kontent.ai Delivery API.

sample-app-razorpages's Issues

Migrate to .NET Core 3.1

Motivation

.NET Core 2.2's end-of-life was on December 23rd, 2019, and .NET Core 3.0 end-of-life was on March 3rd, 2020.

Proposed solution

Follow https://docs.microsoft.com/en-us/aspnet/core/migration/22-to-30?view=aspnetcore-3.1&tabs=visual-studio and subsequently 3.0 to 3.1.

Update to latest Nugets and .NET 8

Motivation

This project should be updated to .NET 8 and the latest nugets.

There are breaking changes that this project does not address such as this: kontent-ai/delivery-sdk-net#390

Proposed solution

Update solution to .NET 8 and latest nugets.

Upgrade to .NET 5

Motivation

Let's keep up to date with MS's best practices.

Proposed solution

• Tag the current latest commit as a release (similarly to https://github.com/Kentico/kontent-sample-app-net/releases) so that people can get back to the netcore3.1 version
• Upgrade the codebase to .NET 5 + fix all potential warnings/errors

Add support for Coffee pages

Motivation

Prevents users from being redirected to the "404" page when clicking inline links on the "Coffee Processing Techniques" page.

Proposed solution

Create coffee detail and listing pages similar to the Articles section.

Additional context

Inspiration taken from the Kentico Kontent .Net Dancing Goat sample site .