Setup Orchard Core CMS
Install .NET 5
Launch a new shell.
Use the following commands to install .NET 5 on Ubuntu Linux 18.04.
wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.debsudo dpkg -i packages-microsoft-prod.debsudo apt-get update; \sudo apt-get install -y apt-transport-https && \sudo apt-get update && \sudo apt-get install -y dotnet-sdk-5.0To install .NET on other platforms/versions, please check https://docs.microsoft.com/en-us/dotnet/core/install/.
Check .NET SDK version with a command:
dotnet --list-sdksIt should return
5.0.202 [/usr/share/dotnet/sdk]
or a newer version of .NET Framework.
Install Orchard Template
- Use the following command to install a new project template
It'll use nightly build packages.dotnet new -i "OrchardCore.ProjectTemplates::1.0.0-rc2-*" --nuget-source https://nuget.cloudsmith.io/orchardcore/preview/v3/index.json
- Create a new folder with name
orchard-example
as a root folder of your project. - Inside the root folder, create a folder
src
to store the project's source code. - CD To
orchard-example/src
. - Use
dotnet new occms
command to create OrchardCore CMS project with nameOrchard.Web
. - You can change a project's name to any name that you want.mkdir -p orchard-example/srccd orchard-example/srcdotnet new occms --name Orchard.Web
Open the project with VS Code
- CD the root folder (
codesanook-example
). - Launch VS Code.cd orchard-examplecode .
Add preview package source
- At root of the project, create
nuget.config
file. - Add the following code to the file.
<?xml version="1.0" encoding="utf-8"?><configuration><packageSources><clear /><add key="NuGet" value="https://api.nuget.org/v3/index.json" /><add key="OrchardCorePreview" value="https://nuget.cloudsmith.io/orchardcore/preview/v3/index.json" /></packageSources><disabledPackageSources /></configuration>
- Waring, we do not suggest you to use the dev packages in production.
Project file structure
tree -I "bin|obj" orchard-exampleorchard-example├── nuget.config└── src└── Orchard.Web├── NLog.config├── Orchard.Web.csproj├── Program.cs├── Properties│ └── launchSettings.json├── Startup.cs├── appsettings.json└── wwwroot
Launch a website
- Use VS Code integrated terminal by pressing ctrl+`
- CD to
src/Orchard.Web
folder. - Run the project with the following command:
Note Please make sure you've saved all changes before running the command.cd src/Orchard.Webdotnet run - FYI,
dotnet run
automatically download all Nuget packages so you don't need to explicitly rundotnet restore
. - Please refer to https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-run#implicit-restore for more information.
Set up new Orchard CMS website
- Open a browser and navigate to http://localhost:5000.
- You will find Orchard Core CMS setup page.
- Tip you can put chrome://flags/#allow-insecure-localhost command setting in Chrome's address bar, enable that setting and relaunch Chrome to not show warning message on localhost.
- Set up a new website with any name you want and use Blog recipe.
- Use SQLite to simplify our project. For using it as production database, please check https://www.sqlite.org/whentouse.html.
- Note If you are going to use other database types, you need to create an empty database before setting up a website.**.
- Set admin username and email to any value you want.
- Click
Finish setup
button. - You will be redirected to a home page.
- Go to an admin panel by navigating to http://localhost:5000/admin and log in with your admin's username and password.
Example of a home page with blog recipe
Example of an admin page
All Orchard Core Cms Templates
- You can use
dotnet new
for listing all installed templates, and you can select by usingShort Name
of the template.
Update Orchard Core CMS template
- Execute the following command to update Orchard Core CMS template:dotnet new --install OrchardCore.ProjectTemplates::1.3.0
Templates Short Name Language Tags-------------------------------------------- -------------- ---------- ----------------------Orchard Core Cms Module ocmodulecms [C#] Web/Orchard Core/CMSOrchard Core Cms Web App occms [C#] Web/Orchard Core/CMSOrchard Core Theme octheme [C#] Web/Orchard Core/CMSOrchard Core Mvc Module ocmodulemvc [C#] Web/Orchard Core/MvcOrchard Core Mvc Web App ocmvc [C#] Web/Orchard Core/Mvc
For example: Orchard Core Cms Web App: to create a new Orchard Core CMS website project.
dotnet new occms --name [PROJECT_NAME]
Loading comments...