forked from OrchardCMS/OrchardCore
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add new guide about creating cms application (OrchardCMS#3379)
- Loading branch information
1 parent
c2c83f6
commit e819bc3
Showing
2 changed files
with
58 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
# Creating an Orchard Core CMS website | ||
|
||
In this guide you will setup Orchard Core as a Content Management System from a project template. | ||
|
||
## What you will need | ||
|
||
- The current version of the .NET Core SDK. You can download it from here [https://www.microsoft.com/net/download/core](https://www.microsoft.com/net/download/core). | ||
- A text editor and a terminal where you can type dotnet commands. | ||
|
||
## Creating the projects | ||
|
||
There are different ways to create sites and modules for Orchard Core. You can learn more about them [here](../../templates/README.md). In this guide we will use our "Code Generation Templates". | ||
|
||
You can install the latest released templates using this command: | ||
|
||
```dotnet new -i OrchardCore.ProjectTemplates::1.0.0-*``` | ||
|
||
!!! note | ||
To use the development branch of the template add `--nuget-source https://www.myget.org/F/orchardcore-preview/api/v3/index.json` | ||
|
||
Create an empty folder that will contain your site. Open a terminal, navigate to that folder and run this: | ||
|
||
```dotnet new occms -n MySite``` | ||
|
||
This creates a new Ochard Core CMS project in a folder named `MySite`. | ||
|
||
## Setting up the site | ||
|
||
The application has been created by the template, but it has not been setup yet. | ||
|
||
Run the application by executing this command: | ||
|
||
`dotnet run --project .\MySite\MySite.csproj` | ||
|
||
!!! note | ||
If you are using the development branch of the templates, run `dotnet restore .\MySite\MySite.csproj --source https://www.myget.org/F/orchardcore-preview/api/v3/index.json` before running the application | ||
|
||
Your application should now be running and contain the open ports: | ||
|
||
``` | ||
Now listening on: https://localhost:5001 | ||
Now listening on: http://localhost:5000 | ||
Application started. Press Ctrl+C to shut down. | ||
``` | ||
|
||
Open a browser on <https://localhost:5001>, it should display the setup screen. | ||
|
||
In order to build a site with all the features of a CMS with are going to use the __Blog__ recipe. Recipes contains a list of modules and steps to configure an Orchard Core website. | ||
|
||
Fill the form and select the __Blog__ recipe and __SQLite__ for the database. | ||
|
||
Submit the form. A few seconds later you should be looking at a Blog Site. | ||
In order to configure it and start writing content you can go to <https://localhost:5001/admin>. | ||
|
||
## Summary | ||
|
||
You just created an Orchard Core CMS powered blog engine. |