Getting started with Orchard Core as a NuGet package¶
In this article, we are going to see how easy it is to create a CMS Web application using the NuGet packages provided by Orchard Core.
You can find the original blog post written by Chris Payne here:
http://ideliverable.com/blog/getting-started-with-orchard-core-as-a-nuget-package
Create an Orchard Core CMS application¶
In Visual Studio, create a new empty .NET Core web application. Ex: Cms.Web. Do not check "Place solution and project in the same directory", because later when you create modules and themes you will want them to live alongside the web application within the solution.
If you want to use the dev packages, add this OrchardCore-preview MyGet url to your NuGet sources:
https://www.myget.org/F/orchardcore-preview/api/v3/index.json. To do this, right click on the project and click on "Manage NuGet Packages...", click the Settings cog in the top right, and add the url to Package Sources.
To add a reference to the package, right-click on the project and click on Manage NuGet packages..., check Include prerelease if required. If you added the MyGet source above, select this from the Package Source selection in the top right. In the Browse tab, search for OrchardCore.Application.Cms.Targets and Install the package.
Open Startup.cs and modify the ConfigureServices method by adding this line:
services.AddOrchardCms();
In the Configure method, replace this block:
app.UseEndpoints(endpoints =>
{
endpoints.MapGet("/", async context =>
{
await context.Response.WriteAsync("Hello World!");
});
});
with this line:
app.UseOrchardCore();
Setup your application¶
Launch your application (Ctrl+F5). The setup page is displayed.
Enter the required information about the site:
- The name of the site. Ex:
Orchard Core. - The theme recipe to use. Ex:
Agency. - The timezone of the site. Ex:
(+01:00) Europe/Paris. - The Sql provider to use. Ex:
SqLite. - The name of the admin user. Ex:
admin. - The email of the admin. Ex:
[email protected] - The password and the password confirmation.
Submit the form and your site is generated after a few seconds.
Then, you can access to the admin using the /admin url. Enjoy.