原文地址: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。