原文地址:http://skywalkersoftwaredevelopment.net/blog/writing-an-orchard-webshop-module-from-scratch-part-3
创建Orchard.Webshop模块项目
这是从头开始编写一个新的Orchard模块的教程的第3篇。
对于本教程的概述,请参阅介绍。
Orchard模块是一个真正的ASP.NET MVC的Area类库,同时遵循了ASP.NET MVC和Orchard的特定的规范。
Orchard 规范提升了您的ASP.NET MVC Area,因此,它可以集成到Orchard中。
现在,我们可以使用Orchard命令行应用程序为我们生成一个基本结构,但是让我们使用Visual Studio从头开始,使我们充分理解,一个模块可以简单到一个空类库加一个module.txt文件,作为模块清单。
最后,我们的模块将包括:
- A Module Manifest
- Models & ViewModels
- Views
- Controllers
- Drivers
- Service classes
- Handlers
- Shapes
- Javascript
- Css
- A Migration
- A ResourceManifest
- Routes
- Helpers methods
我们将进行过程中讨论每一项。
首先,我们将由简单的创建一个新的类库项目开始。
在Visual Studio中,在模块的解决方案文件夹下创建一个新的类库项目,并确保该项目位于物理位置\src\Orchard.Web\Moduels:
Orchard需要您的模块位于存在物理位置Modules目录下。
下一步,我们将创建模块的Manifest文件,这是一个简单的文本文件,说明我们的模块,如我们的模块的名称,描述,版本号,公司网址等
让我们的开始给Module.txt输入以下信息:
Name: Orchard.WebShop
AntiForgery: enabled
Author: Sipke Schoorstra
Website: http://skywalkersoftwaredevelopment.net
Version: 1.0
OrchardVersion: 1.3.10
Description: Orchard Webshop Module Demo
Category: Webshop
然后,我们就有了一个基本的Orchard模块,但它什么功能也没有。
但是,这就是我们下面要作的。
让我们确认Orchard识别了我们的模块。按Ctrl + F5启动网站。
网站启动后,导航到管理页面。
可以通过,敲入网址http://localhost:30320/OrchardLocal/admin直接进入管理页面,或点击网站页脚上的”Dashboard”连接进入。
一旦进入管理页面,选择Modules,启用我们的Orchard Webshop Module:
这样我们就创建了一个模块的骨架!接下来,让我们使它能做一些有用的事。
我们要的是,使管理员可以定义各种产品:书籍,光盘,DVD光盘,手机等
所有这些产品至少有两个共同的特点:一个单位的价格和一个SKU属性。
在Orchard的核心,每一部分内容事实上都是由Content Parts组成。
例如,管理员可以定义一个新的内容类型:
Book。Book的内容类型是由它的Content Parts定义的。
管理员可以挑选他喜欢的Content Parts(内容部分),如:BodyPart,CommentsPart,RoutePart等。
为了Book变成一个产品,我们需要先创建一个自己的自定义Part(部分):ProductPart。