Orchard 2 is the implementation of Orchard CMS in ASP.NET Core (also known as DNX). You can check out the Orchard 2 presentation from the last Orchard Harvest to get an introductory overview of its features and goals.
| Build server | Platform | Status |
|---|---|---|
| AppVeyor | Windows | |
| Travis | Linux / OS X |  |
| MyGet | Windows |
Orchard is a free, open source, community-focused Content Management System built on the ASP.NET MVC platform.
- Clone the repository using the command
git clone https://github.com/OrchardCMS/Orchard2.gitand checkout themasterbranch. - Delete
%LocalAppData%\Microsoft\dotnet– The shared runtime dotnet installer doesn’t account for the old CLI structure. - Delete
.build(or run git clean -xdf) to get the latest KoreBuild - Delete
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\dotnet-test-xunit - Run the
build.cmdfile included in the repository to dotnet CLI and build the solution. - Next navigate to
D:\Orchard2\src\Orchard.Webor where ever your retrospective folder is on the command line in Administrator mode.
- Call
dotnet run. - Then open the
http://localhost:5001URL in your browser.
- Call
dotnet run. - From here you can now execute commands in a similar fashion as before.
When running Orchard 2, you need a client. The default implementation is to have a client talk to a host.
The client can be any project that creates the host.
To create the host in a web project you would do:
public class Startup {
public IServiceProvider ConfigureServices(IServiceCollection services) {
return services
// AddHostSample is where the magic is done. This extension method lives in the Host (Orchard.Hosting.Web)
.AddHostSample()
.BuildServiceProvider();
}
}The host has a small wrapper:
public static IServiceCollection AddHostSample(this IServiceCollection services) {
// This will setup all your core services for a host
return services.AddHost(internalServices => {
// The core of the host
internalServices.AddHostCore();
//... All extra things you want registered so that you don't have to touch the core host.
});Additional locations for module discovery can be added in your client setup:
public class Startup {
public IServiceProvider ConfigureServices(IServiceCollection services)
{
services.AddWebHost();
// Add folders the easy way
services.AddModuleFolder("Core/Orchard.Core");
services.AddModuleFolder("Modules");
services.AddThemeFolder("Themes");
// Add folders the more configurable way
services.Configure<ExtensionHarvestingOptions>(options => {
var expander = new ModuleLocationExpander(
DefaultExtensionTypes.Module,
new[] { "Core/Orchard.Core", "Modules" },
"Module.txt"
);
options.ModuleLocationExpanders.Add(expander);
});
});
}All tenant configuration lives in src\Orchard.Web\App_Data\Sites\Default within settings files, e.g. Settings.txt:
State: Running
Name: Default
RequestUrlHost: localhost:5001
RequestUrlPrefix:However, you can override these values within a .json or .xml file. The order of precendence is: Settings.txt -> Settings.xml -> Settings.json
You can also override the 'Sites' folder in your client setup
public class Startup {
public IServiceProvider ConfigureServices(IServiceCollection services)
{
services.AddWebHost();
// Change the folder name here
services.ConfigureShell("Sites");
});
}Orchard now has a build in file system that is scoped to the running site. To use this, you just need to inject in IOrchardFileSystem.
You use non virtual paths for access, so for example, lets say you have this folder.
D:\Orchard2\src\Orchard.Web\Modules\Orchard.Lists\Module.txt
and in you code you want to read that file,
public void GetMeThatFile()
{
var fileText = _fileSystem.ReadFile("Modules\Orchard.Lists\Module.txt");
// The physical path will be D:\Orchard2\src\Orchard.Web\Modules\Orchard.Lists\Module.txt
}The file system is scoped to the Orchard.Web folder by default. If however you want another filesystem, you can create a new one elsewhere.
public void CreateMeAFileSystem()
{
var root = "C:\MyFileSystemRootPath";
var fileSystem = new OrchardFileSystem(
root,
new PhysicalFileProvider(root),
_logger);
// now if I get my module file..
var fileText = fileSystem.ReadFile("Modules\Orchard.Lists\Module.txt");
// The physical path will be C:\MyFileSystemRootPath\Modules\Orchard.Lists\Module.txt
}If you would like to deal with files within a particular Extension Folder you can do this:
public void GetMePlacement()
{
// First get the extension.
ExtensionDescriptor extensionDescriptor = _extensionManager.GetExtension("Orchard.Lists");
// Second use the extension to get the placement info file
IFileInfo placementInfoFile = _fileSystem
.GetExtensionFileProvider(extensionDescriptor, _logger)
.GetFileInfo("Placement.info");
}###Testing
We currently use XUnit to do unit testing.
###Contributing
We currently follow the these engineering guidelines.