Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add new guide about creating cms application #3379

Merged
merged 3 commits into from
Mar 24, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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)

## Tutorials
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.