Orchard Core 示例项目教程

Orchard Core 示例项目教程

1. 项目目录结构及介绍

Orchard Core 示例项目的目录结构如下：

OrchardCore.Samples/
├── DashboardApplication/
├── ModularApplication/
├── Module1/
├── Module2/
├── MultiTenantApplication/
├── .gitignore
├── LICENSE.txt
├── NuGet.config
├── OrchardCore.Samples.sln
├── README.md
└── logo.png

目录结构介绍

• DashboardApplication: 一个包含 Orchard Admin UI 的 ASP.NET Core MVC 应用程序，引用模块项目。该应用程序具有最小的功能和依赖项，包含用户、角色和功能管理。
• ModularApplication: 一个简单的 ASP.NET Core 应用程序，引用模块。
• Module1: 一个包含 ASP.NET Core MVC 控制器、视图和页面的示例模块。
• Module2: 一个注册自定义中间件的示例模块。
• MultiTenantApplication: 一个引用模块项目的 ASP.NET Core MVC 应用程序，提供两个具有不同模块启用的租户。
• .gitignore: Git 忽略文件。
• LICENSE.txt: 项目许可证文件。
• NuGet.config: NuGet 配置文件。
• OrchardCore.Samples.sln: 项目解决方案文件。
• README.md: 项目自述文件。
• logo.png: 项目图标文件。

2. 项目启动文件介绍

启动文件

在 OrchardCore.Samples 项目中，启动文件通常位于每个应用程序的根目录下，例如 DashboardApplication、ModularApplication 和 MultiTenantApplication 目录中。

示例启动文件

以 DashboardApplication 为例，启动文件通常为 Startup.cs，内容如下：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace DashboardApplication
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            // 配置 Orchard Core 服务
            services.AddOrchardCms();
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();
            app.UseOrchardCore();
        }
    }
}

启动文件功能

• ConfigureServices: 配置 Orchard Core 服务。
• Configure: 配置应用程序的中间件管道，包括 Orchard Core 中间件。

3. 项目配置文件介绍

配置文件

在 OrchardCore.Samples 项目中，配置文件通常为 appsettings.json，位于每个应用程序的根目录下。

示例配置文件

以 MultiTenantApplication 为例，配置文件内容如下：

{
  "OrchardCore": {
    "Default": {
      "State": "Running"
    },
    "CustomerA": {
      "State": "Running",
      "RequestUrlPrefix": "customer-a"
    },
    "CustomerB": {
      "State": "Running",
      "RequestUrlPrefix": "customer-b"
    }
  }
}

配置文件功能

• OrchardCore: 配置 Orchard Core 的租户信息。
  • Default: 默认租户配置。
  • CustomerA: 租户 A 的配置。
  • CustomerB: 租户 B 的配置。

通过以上配置，可以为不同的租户设置不同的 URL 前缀和状态。