Skip to content

Commit

Permalink
Add new guide about creating cms application (OrchardCMS#3379)
Browse files Browse the repository at this point in the history
  • Loading branch information
matiasmolleja authored and sebastienros committed Mar 24, 2019
1 parent c2c83f6 commit e819bc3
Show file tree
Hide file tree
Showing 2 changed files with 58 additions and 0 deletions.
1 change: 1 addition & 0 deletions src/docs/guides/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ Whatever you're building, these guides are designed to get you productive as qui
Designed to be completed in 15-30 minutes, these guides provide quick, hands-on instructions for building the "Hello World" of any development task with Orchard Core. In most cases, the only prerequisites are a .NET SDK and a text editor.

- [Creating a Modular ASP.NET Core Application](create-modular-application-mvc/index.md)
- [Creating an Orchard Core CMS website](create-cms-application/index.md)
- [Running Code on Startup](run-code-on-startup/index.md)

### Orchard Core CMS Guides
Expand Down
57 changes: 57 additions & 0 deletions src/docs/guides/create-cms-application/index.md
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.

0 comments on commit e819bc3

Please sign in to comment.