模塊管理_織夢CMS幫助中心

　　Dedecms5.7中對模塊插件的管理進行了升級，仍然沿用通用的xml文件來安裝，以下內容詳細講解織夢模塊的管理方法。

 

1.進入管理界麵：

如（圖１）所示，在主菜單中點擊“模塊”，然後點擊“模塊管理”即可進入模塊管理界麵，如（圖２）所示。

 

圖1-進入管理列表

 

圖2-管理列表

 

進入管理界麵後就可以繼續下一步了

 

2.模塊的下載及上傳：

織夢模塊的安裝文件是xml格式的，在dedecms5.7中可以通過下載獲得官方插件，如（圖２）所示，在需要的插件中點擊下載即可。

當然必須介紹模塊的上傳方法，因為在織夢中可以開發擴展的模塊和插件，如果是第三方提供下載，請先驗證其可靠性，因為有些第三方模塊插件中有可能包含病毒。

上傳方法：

以留言簿模塊為例，首先從官方下載留言簿模塊(https://www.dedecms.com/addons/)。對下載的文件進行解壓，選擇適合自己網站的編碼，這裏以選擇utf-8編碼的留言簿為例。

在主菜單中點擊“上傳新模塊”，如圖3所示。

圖3-進入上傳界麵

 

這時就進入上傳界麵如（圖4）所示。安裝新模塊時，要注意以下幾點：

第一，上傳時，剛才已經將文件解壓，所以選擇“正常的模塊包”(如果你把xml文件壓縮到zip包中，選擇“經過zip壓縮的模塊包”）。

第二個選項“已有模塊：強製刪除同名模塊(這可能導致已經安裝的模塊無法卸載) ”，在這裏，如果模塊已經安裝，建議先刪除原有模塊（刪除方法在此文後有介紹），再安裝新模塊（要勾選此項），以免版本衝突，出現多餘的數據和文件。如果沒有安裝過的模塊已經存在，建議勾選，否則會出現“上傳的模塊已經存在”的提示。

第三，選擇文件，將文件路徑指向剛才解壓所獲得的文件即可。

以上步驟見（圖4）

圖4-模塊上傳

 

點擊“確定”按鈕上傳模塊，模塊即可上傳，提示上傳成功。

進行到這裏，有些朋友也許會出現一個常問題，類似以下這樣：

“文件 D:/xxxxx/data/module/guestbook.xml 不存在或不可讀!”

處理方法非常簡單，不要離開此頁麵，將xml文件通過ftp上傳至網站目錄的/data/module中，確保可以訪問到文件後，刷新框架頁（不是按F5，按f5會導致整個後台刷新）。

　　

到這裏，模塊已經成功上傳了，如（圖5）所示：

 

圖5-上傳成功

 

現在就可以進入安裝階段了。

 

3.模塊安裝

如（圖5）所示，上傳成功後，點擊“是否已安裝”一項之後的“安裝”，即可進入安裝界麵（圖6）

圖6-模塊安裝界麵

 

安裝時如（圖6）中提示，應該確保相關文件夾的寫權，如果“目錄權限檢測”中有“×”號，則表示目錄沒有寫權，需要先設置權限然後安裝。

已存在的文件處理方法建議選擇“覆蓋”，如果有保留的需要，可以選擇後兩項，如遇到模塊已經二次開發過的情況。

點擊確定直接安裝即可，這一步沒有常見錯誤，如果第三方插件出現安裝失敗等錯誤提示，很有可能是模塊本身的sql語句錯誤等原因造成的。

 

4.模塊卸載

織夢模塊是可以自由卸載的，操作非常簡單，以剛才上傳安裝的留言簿模塊為例，在管理列表中點擊卸載，如（圖7）所示。

圖7-卸載

進入卸載界麵，如(圖8)所示。如果有必要保留的話，可以選擇手工刪除文件這樣隻執行數據庫卸載，文件全部保留；選擇“刪除模塊的所有文件”會將數據庫中的數據連同文件一起刪除。

圖8-卸載模塊

點擊確定按鈕，模塊即可成功卸載。

 

5.刪除模塊

卸載後，安裝用的xml文件仍然存在，如果還需要使用，重新安裝即可，如果不再使用，點擊模塊管理列表中的管理列中的“刪除”即可。此步驟非常簡單，如果剛才沒有卸載就直接刪除模塊，會提示引導進入卸載向導，點擊“確定”完成刪除。

 

下麵介紹的是模塊的更多用法。

 

6.模塊分類

如（圖9）所示，點擊模塊分類，可以輕鬆的列出對應類型的模塊。

圖9-模塊分類

 

7.查看使用說明

點擊管理中的使用說明（見圖2），即可獲得模塊的使用方法介紹，好的模塊應該包括完整的使用文檔供用戶閱讀，但某些第三方模塊中可能不包含說明。

8.查看模塊詳細信息

點擊管理中的詳細（見圖2），即可查看模塊詳細信息，包括文件大小，編碼，開發團隊的信息等，還有安裝的文件，可以通過此路徑找到被安裝的文件。

 

以下是模塊的生成方法，將生成和修改一並在這裏介紹

 

9.模塊的生成和修改

生成與修改操作十分類似，在這裏合並為模塊的生成來介紹。

先以生成一個模板插件為例，首先填寫表單，如（圖10）所示。

圖10-生成一個模板類型的插件

名稱填寫為插件的名稱，將會在模塊管理列表中顯示，編碼不需要選擇（見說明），封裝類型，這裏選擇的類型將會在模塊的分類中顯示，如果涉及了會員係統，需要在“是否涉及會員係統的”選項中選擇“涉及”，其它信息按需填寫，模板類型的模塊安裝不需要sql語句，安裝時可以不必填寫安裝程序和刪除程序。

在文件列表中，比如的模板文件在/templets/test中，就填寫相對應於後台目錄的路徑，比如“../templets/test”即可。

當然模板是提前做好的，此生成向導不能製作模板，隻是將文件打包為一個標準的dede插件安裝文件。

填寫好後，點擊“提交”按鈕。

成功生成的插件將在插件管理列表中顯示，如（圖11）所示。

 

圖11-生成好的模塊

　　生成好的模塊可以通過以上的方法進行管理。

　　

到這裏，需要回過頭來介紹 模塊/小插件/補丁 類模塊的生成方法

 

10.模塊/小插件/補丁 類模塊的生成

 

在類型中選擇“小插件”，如果插件名字修改，可以更新一下模塊識別碼（圖12）。

圖12-小插件類型的模塊

　　

這種模塊有一部分是需要填寫後台管理菜單、安裝程序、刪除程序的。

首先介紹後台管理菜單的添加方法。打開後台目錄中的inc/inc_menu_module.php文件，複製約15-19行處得菜單代碼：

<m:top name='問答模塊管理' c='6,' display='block' rank=''>

<m:item name='問答欄目管理' link='ask_type.php' rank='' target='main' />

<m:item name='問答問題管理' link='ask_admin.php' rank='' target='main' />

<m:item name='問答答案管理' link='ask_answer.php' rank='' target='main' />

</m:top>

 

修改楷體字部分修改為你所需要的菜單名稱，改動後的代碼如：

 

<m:top name='小插件例子' c='6,' display='block' rank='10'>

<m:item name='小插件列表' link='z_testplus.php' rank='10' target='main' />

……

</m:top>

 

菜單填寫好後，需要寫好說明文檔，這一步需要自行填寫，不做詳細介紹，說明當然是越完整越好。

下麵來填寫安裝程序，安裝程序主要是sql語句，以創建一個z_testplus表為例

填寫：

CREATE TABLE `dede_z_testplus` (

  `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,

  `test` VARCHAR(45) NOT NULL,

  PRIMARY KEY (`id`)

)

ENGINE = MyISAM

CHARACTER SET utf8 COLLATE utf8_general_ci;

INSERT INTO `dede_z_testplus` (test) VALUES ('v1');

INSERT INTO `dede_z_testplus` (test) VALUES ('v2');

 

Sql語句換行用“;”，然後填寫刪除程序的sql語句

 

DELETE FROM `dede_plus` where plusname like '小插件例子';

 

DROP TABLE IF EXISTS `dede_z_testplus`;

 

這樣就可以了，文件的填寫如上麵介紹，然後點擊提交生成（圖13)

圖13-填寫安裝和刪除語句

 

生成之後，和（圖11）所示一樣，出現了一個新的插件，按照介紹過的安裝方法進行安裝，刷新主菜單，可以看到出現了剛才安裝的插件菜單（圖14）

圖14-小插件的菜單

查看數據庫，數據表已經成功的創建了。

至此，模塊/小插件/補丁類型的模塊菜單和sql安裝也介紹完了。

 

11.提取插件安裝文件

插件的安裝文件在/data/module中，想要獲得xml文件，需要先看一下模塊的識別碼，點擊修改可以查看到識別碼，比如剛才例子中的小插件識別碼為“bc161c9006aef4c96726a660cdac1f9c”，就在插件文件夾中尋找名為“bc161c9006aef4c96726a660cdac1f9c.xml”的文件，找到後複製出來即可共享或者下次再安裝。其使用方法就和上文所講過的一樣。