Xperience by Kentico Training Guides starter repository

This repository is the starting point for the Xperience by Kentico technical Training Guides. Use this branch to follow along with the Training guides.

Note

This repository uses Xperience by Kentico version 29.6.1.

The finished branch contains the cumulative results of the Training guides, as well as some sample widgets and can be used for reference. As it contains several independent examples, it is not built comprehensively, and we recommend against using it as a boilerplate. We continuously add new features to this repository as we create new Training guide materials.

The goal of the Training Guides is to teach recommended development practices with Xperience by Kentico. However, keep in mind that the code in this repository is intended to be examined in the context of individual guides -- some aspects are simplified to keep attention on the main topic of the corresponding lesson.

Installation requirements

• The database backup included in this repository requires SQL Server 2022 or newer.
  • If you are using an older version of SQL server, you can prepare a fresh database by installing a fresh instance of Xperience by Kentico version 29.6.1
• This repository targets the .NET 8 SDK.
  • If you are using a different .NET version, you can update the target framework in your solution. Note that the files in this repository use C# 12 features and syntax, some of which are not supported in lower versions.

Getting started

1. Clone or download this repository to your development environment
2. Open TrainingGuides.sln under the src folder and restore all NuGet packages.
3. Restore Xperience.TrainingGuides.bak from the Database folder to your SQL server
4. Update the connection string in the appsettings.json file under the .\src\TrainingGuides.Web folder to point to your newly restored database
5. Run a Continuous integration restore to populate the database with the necessary data
6. Clean and rebuild the solution
7. Log in with the username administrator and the password TrainingGuides123*
8. Apply your license key to the instance.
   • If you are using an up-to-date license key , access the Settings application and paste your license key into the License key field under the System → License category.
   • If you are using an old-format license key, access the License keys application and paste your key there.

Tip

You can obtain a license key from your agency, supervisor, or team lead.
Alternatively, you can create an account at the Client Portal, and generate a temporary key valid for 30 days.
Learn more about licensing in our documentation.

Contributing

This repository is related to Training Guides for developers and has an educational purpose. For this reason, please do not submit ideas for new functionality. However, please do let us know if you encounter a bug that needs to be fixed, either by submitting an issue or contributing a fix directly.

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.