织梦DedeCMS帮助手册

　　Dedecms5.7中对模块插件的管理进行了升级，仍然沿用通用的xml文件来安装，以下内容详细讲解织梦模块的管理方法。

1.进入管理界面：

如（图１）所示，在主菜单中点击“模块”，然后点击“模块管理”即可进入模块管理界面，如（图２）所示。

图1-进入管理列表

图2-管理列表

进入管理界面后就可以继续下一步了

2.模块的下载及上传：

织梦模块的安装文件是xml格式的，在dedecms5.7中可以通过下载获得官方插件，如（图２）所示，在需要的插件中点击下载即可。

当然必须介绍模块的上传方法，因为在织梦中可以开发扩展的模块和插件，如果是第三方提供下载，请先验证其可靠性，因为有些第三方模块插件中有可能包含病毒。

上传方法：

以留言簿模块为例，首先从官方下载留言簿模块(http://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”的文件，找到后复制出来即可共享或者下次再安装。其使用方法就和上文所讲过的一样。