discuz插件开发新手入门1.doc

DISCUZ插件开发新手入门 作者：联想锋行 QQ445663314 前言： 本文所谓插件开发是指按照DISCUZ官方用户手册所说明的插件开发流程所进行的开发。 在阅读本文之前，假设读者是已经了解DISCUZ程序中的include/common.inc.php这个公共处理程序。如果您不了解此程序功能，请阅读手用户册中的插件开发说明，并阅读程序。 本文基于DISCUZ 6.1.0 GBK版。 水平有限，仅供新手参考。如有错误，请指正。 第一步：后台增加插件 添加新插件（点击添加新插件） 编辑插件信息（点击详情） 设置插件信息 注意插件目录是相对于./plugins/的，因为插件文件是要放在./plugins/这个文件夹下的。为了方便和统一管理，一般都是按照自己的插件项目命名一个文件夹，然后此插件的程序放在此目录下。一般此目录名与您的唯一标识符是相同的，以便于识别。当然，不是必需，但是，为了良好习惯和标准，最好还是同名。一般会在前面加plugins_以区分这是插件数据表。 另外注意数据库表不要有前缀。当然，写在那里只是备份数据的时候要用到。如果你觉得你的数据表不用备份到里，也可以不必填写。当然，大部分时候还是推荐您填写。 增加模块 程序模块名填写英语，名称填写中文的链接显示名称。模块类型选择“前台调用（前台下拉菜单）”，此时直接URL可以不填写。如果此模块是给会员用的，使用等级设为普通用户。 把插件设为可用 回到论坛插件管理，把刚才新增的插件设为可用。 如下图： 把前面的勾打上。 OK，现在论坛首页去看看，测试一下插件有没有显示出来。 OK，出来了。成功一半了。 点击插件的链接，会出现以下提示： 这是正常的，因为我们还没有正式开始写程序嘛！ 第二步：编写程序和模板 在plugins目录下增加插件目录， 此目录名example 要与插件设置的“插件目录”里的一致！ 在plugins目录下增加模块程序 注意，文件名要按“模块名.inc.php”来，如本文中的kaifa.inc.php。 好了，OK，我们来写行程序测试下。 OK，见到效果了。 开始写插件程序 首先，保护本程序不被独访。按DZ官方的来。 接下来，引进模板。 以上 template(‘kaifa’)中的kaifa是模板的命名，对应于模板风格目录下的kaifa.htm，当然，模板名字可以随便取。一般会以plugins_kaifa这样子以区分这是插件的模板。 开始写插件模板 一般的，都要引进DZ的页头页脚的。 OK,让我们看下效果。 更多关于DZ模板和程序的知识，作为程序员，你应该了解，在此不讲。 第三步：设置插件变量 增加变量 论坛插件管理-详情-变量。 比如增加一个列表分页显示数，变量名为pagenum，数字 提交，然后编辑变量详情。 以上主要是给变量给点说明，用于给管理员在后台配置插件的时候的提示信息。 配置插件变量 论坛插件-设置-详情-变量。 找到插件，点击插件参数设置 把刚才新增的变量赋上值。（如果不做这一步，变量就没值用，插件就可能会出错！） 引进插件缓存数据 该文件位于forumdata/cache/plugin_插件名称.php 一般来说，插件中都要用到此插件配置信息。 所以，请把此文件包含进来。 至于如何取得插件里的数据以及变量的值，一看插件缓存文件便知。不再多讲。 如 $pagenum= $_DPLUGIN[example][‘vars’][‘pagenum’]; 第四步：设置插件钩子 了解钩子 所谓钩子。我的理解，不过就是把某个地方要运用的代码，先不写在那里，而是放在其它地方。其实就是 eval()的功能。如果你还不了解，相信你很快会了解。 提醒下，钩子不是一开始写插件程序就要用的，往往是插件的后期阶段，测试无误了，把代码抽出来，换成钩子。因为这些代码所在的地方往往不是插件的程序而是论坛本身的程序，所以，换成钩子比较容易实现管理，比如插件禁用和删除时方便。 如要在index.php里的某程序段落里实现输出“你好”，你可以 如果换成钩子的话： 从而将echo ‘您好’;这个可能是一大段代码用一个简洁的代码表示，用户安装时方便，技术人员修改时也方便，同时即使插件出错也可以不影响，禁用和删除时可以不必删除此钩子。很是方便。 新增钩子 编辑钩子详情 再把钩子设为可用。 获得钩子调用代码，替换程序原来的代码段。 第五步：发布插件 在桌面上新建一目录，用于存放一会要发布的插件。比如 “开发示例插件”。 在里面新增一个目录“upload”，用于存放要上传的文件以及文件夹。 新增一个说明文档。用于插件介绍，安装方法，要修改的地方，版权信息等。 在后台导出插件信息。 导出，保存在文件夹中。 在upload里建立templates/default/ ，并复