總目錄
本實例旨在以一個實際的項目中的例子來介紹如何在dtcms中制作插件,本系列文章非入門教程,部分邏輯實現一帶而過,敬請諒解。
項目要求是在dtcms中增加一個電子資源管理,並且提供靈活的篩選方式。
由於涉及內容比較多,打算分4個部分來描述,內容頁是我自己一點一點摸索出來的,在原有的基礎上進行開發已經是第3次了,這一次對插件制作進一步理解深刻,同時通過不斷的調試摸透了URL重寫的規則。
本章目錄
- 插件目錄結構
- 新建一個插件項目
- plugin.config的設置
一、插件目錄結構
首先,插件是放在web根目錄下的plugin目錄下,plugin目錄下每一個目錄代表一個插件,每個插件下至少包含admin目錄,bin目錄,templet目錄,以及一個plugin.config文件。
建好的項目就如下所示:
二、新建一個插件項目
1.新建項目
首先是在vs中新建一個類庫項目,DTcms.Web.Plugin.DataBaseManager,位置在dtcms的web目錄的plugins目錄里。
然后添加引用,首先是項目內部的引用,如bll、common、db、model、ui這幾個,還有一個是.Net的 system.web
2.修改項目文件夾名字
為了能夠讓dtcms識別這個插件,我們需要把文件夾名字改一下,那么先暫時卸載這個插件項目,我們需要到文件夾中去改一下文件夾名字。
重命名這個文件夾,叫DataBaseManager
然后再把這個項目給添加回來,
3.設置項目生成屬性
右鍵項目—屬性—生成,輸出路徑,主要是為了方便調試,不用每次都把生成的dll放到web\bin\目錄中。
4.按照規則建立目錄
首先我們需要admin目錄、templet目錄,新建目錄比較簡單,比較麻煩的是新建一個web頁面,因為我們是類庫項目,無法新建aspx的頁面,而后台需要用aspx頁面,所以我們從別的地方復制一個aspx頁面過來。
然后需要修改一下類名稱
Aspx頁面:
Aspx.cs文件:
Aspx.designer.cs文件
然后刪掉所有報錯的代碼,因為我們都要自己重寫的。
至此我們都 項目就建立好了。
三、plugin.config的設置
為了能夠讓dtcms后台能識別插件,需要設置plugin.config。首先來了解一下plugin.config的格式
這里是我寫好的config
這里主要介紹3個地方:
- 第一行目錄,一定要和你的目錄名字保持一致,就是web/plugins/DataBaseManager中的最后一級目錄保持一致,接下來幾個配置項影響不大。Isload一開始要寫0,不然就無法安裝了;
- 安裝sql那個部分,可以把create table的sql放進去,卸載sql部分可以吧drop table的sql放進去,我這里就不做演示了;
-
最后nav那里是配置后台的,name隨便寫,title是后台顯示的名字,url就寫admin/index.aspx,然后后台配置的列表頁就是admin/index.aspx了,action有幾個取值,具體如下圖
這樣就建立好了一個完整的插件,接下來就可以到后台看效果了,我們就可以安裝新建的插件了