Orchard 2 is the implementation of Orchard CMS in ASP.NET vNext (also known as DNX).
- First off, follow the instructions here in order to install DNVM, then install Visual Studio 2015, or what ever you flavour of editor is.
- Next you want to clone the repository using the command
git clone https://github.com/OrchardCMS/Orchard2.gitand checkout themasterbranch. - Run the
build.cmdfile included in the repository to bootstrap DNX and build the solution. - Next navigate to "D:\Orchard2\src\Orchard.Web" or where ever your retrospective folder is on the command line in Administrator mode.
- Call
dnx web. - Then open the
http://localhost:5001URL in your browser.
- Call
dnx 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([NotNull] 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 host setup:
public static IServiceCollection AddHostSample([NotNull] this IServiceCollection services) {
return services.AddHost(internalServices => {
internalServices.AddHostCore();
// Add folders the easy way
internalServices.AddModuleFolder("~/Core/Orchard.Core");
internalServices.AddModuleFolder("~/Modules");
// Add folders the move configurable way
internalServices.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
The event bus must be set up in your host (anyone using the default host will have it):
public class ShellModule : IModule {
public void Configure(IServiceCollection serviceCollection) {
// More registration
serviceCollection.AddNotifierEvents(); // The important line
// More registration
}
}This will allow you to register types of IEventHandler, and in turn execute the eventing modal.
Lets take the example of a Dog, you want to tell it to bark..
public interface ITestEvent : IEventHandler {
void Talk(string value);
}
public class TestEvent1 : ITestEvent {
public void Talk(string value) {
Console.WriteLine("Talk Event ONE! " + value);
}
}
public class TestEvent2 : ITestEvent {
public void Talk(string value) {
Console.WriteLine("Talk Event TWO! " + value);
}
}Next we want to call all Talk on ITestEvent... You need to inject in IEventNotifier, then call notify on the type of interface you want to call passing the method with the properties to it.
private readonly IEventNotifier _eventNotifier;
public Class1(IEventNotifier eventNotifier) {
_eventNotifier = eventNotifier;
}
public void Call() {
_eventNotifier.Notify<ITestEvent>(e => e.Talk("Bark!"));
}The output will be:
Talk Event ONE! Bark!
Talk Event TWO! Bark!
###Testing
We currently use XUnit to do unit testing, with Coypu and Chrome to do UI testing.
###Contributing
We currently follow the these engineering guidelines.